Annotation of src/usr.bin/rcs/ci.1, Revision 1.6
1.6 ! xsa 1: .\" $OpenBSD: ci.1,v 1.5 2005/10/10 15:06:19 niallo Exp $
1.1 niallo 2: .\"
3: .\" Copyright (c) 2005 Niall O'Higgins <niallo@openbsd.org>
4: .\" All rights reserved.
5: .\"
6: .\" Permission to use, copy, modify, and distribute this software for any
7: .\" purpose with or without fee is hereby granted, provided that the above
8: .\" copyright notice and this permission notice appear in all copies.
9: .\"
10: .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
11: .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
12: .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
13: .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
14: .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
15: .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
16: .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
17: .Dd October 08, 2005
18: .Dt CI 1
19: .Os
20: .Sh NAME
21: .Nm ci
22: .Nd check in RCS revisions
23: .Sh SYNOPSIS
24: .Nm
25: .Bk -words
1.5 niallo 26: .Op Fl jMNqV
1.1 niallo 27: .Op Fl d Ar date
28: .Op Fl k Ar mode
1.5 niallo 29: .Op Fl l Op Ar rev
1.1 niallo 30: .Op Fl m Ar msg
1.4 niallo 31: .Op Fl r Op Ar rev
1.5 niallo 32: .Op Fl u Op Ar rev
1.1 niallo 33: .Ar file ...
34: .Ek
35: .Sh DESCRIPTION
36: The
37: .Nm
38: program is used to check new revisions into RCS files.
39: .Pp
40: The following options are supported:
41: .Bl -tag -width Ds
42: .It Fl d Ar date
43: Uses
44: .Ar date
45: for check-in date and time.
46: .It Fl f
47: Force check in.
48: .It Fl I
49: Interactive mode.
50: .It Fl k Ar mode
51: Specify the keyword substitution mode.
1.5 niallo 52: .It Fl l Op Ar rev
1.1 niallo 53: The same as
54: .Fl r ,
1.3 jmc 55: but also immediately checks out the deposited revision and locks it.
56: This is useful if you wish to continue to edit the working file after check-in.
1.1 niallo 57: .It Fl M
58: Set the modification time of the file to the date of the
59: retrieved revision.
60: .It Fl m Ar msg
61: Specify a log message.
62: A line beginning with a hash character
63: .Pq Sq #
64: is considered a comment and ignored.
65: .It Fl q
66: Be quiet about reporting.
1.4 niallo 67: .It Fl r Op Ar rev
1.1 niallo 68: Check in revision
69: .Ar rev .
1.4 niallo 70: However, if
71: .Ar rev
72: is not specified the meaning is completely different \- override any
73: .Fl l
74: or
1.5 niallo 75: .Fl u Op Ar rev
1.4 niallo 76: options, ensuring the default behaviour of releasing a lock and removing the
77: working file.
1.1 niallo 78: .It Fl s Ar state
79: Sets the state of the deposited revision to the identifier
80: .Ar state .
81: .It Fl u
82: The same as
83: .Fl r ,
1.3 jmc 84: but also immediately checks out the deposited revision read-only.
85: Useful if you wish to read the working file after check-in.
1.1 niallo 86: .It Fl V
87: Print RCS's version number.
88: .It Fl w Ar user
89: Uses
90: .Ar user
91: as the author field of the deposited revision.
92: If the
93: .Ar user
94: argument is omitted, the login of the user issuing the command
95: is assumed.
96: .El
97: .Sh ENVIRONMENT
98: .Bl -tag -width RCSINIT
99: .It Ev RCSINIT
100: If set, this variable should contain a list of space-delimited options that
101: are prepended to the argument list.
102: .El
103: .Sh SEE ALSO
104: .Xr co 1 ,
1.2 niallo 105: .Xr ident 1 ,
1.1 niallo 106: .Xr rcs 1 ,
107: .Xr rcsclean 1 ,
108: .Xr rcsdiff 1 ,
1.6 ! xsa 109: .Xr rlog 1