Annotation of src/usr.bin/rcs/ci.1, Revision 1.11
1.11 ! niallo 1: .\" $OpenBSD: ci.1,v 1.10 2005/10/16 22:54:24 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.9 niallo 27: .Op Fl d Ns Op Ar date
28: .Op Fl f Ns Op Ar rev
29: .Op Fl k Ns Ar mode
30: .Op Fl l Ns Op Ar rev
31: .Op Fl m Ns Ar msg
1.11 ! niallo 32: .Op Fl N Ns Ar symbol
1.10 niallo 33: .Op Fl n Ns Ar symbol
1.9 niallo 34: .Op Fl r Ns Op Ar rev
35: .Op Fl u Ns Op Ar rev
36: .Op Fl w Ns Ar username
1.1 niallo 37: .Ar file ...
38: .Ek
39: .Sh DESCRIPTION
40: The
41: .Nm
42: program is used to check new revisions into RCS files.
43: .Pp
44: The following options are supported:
45: .Bl -tag -width Ds
1.9 niallo 46: .It Fl d Ns Op Ar date
1.1 niallo 47: Uses
48: .Ar date
49: for check-in date and time.
1.7 niallo 50: If
51: .Ar date
52: is not specified, use the working file's last modification time.
1.9 niallo 53: .It Fl f Ns Op Ar rev
1.8 niallo 54: Force check in - optionally to
55: .Ar rev
56: - even if no changes have been made to the working file.
1.1 niallo 57: .It Fl I
58: Interactive mode.
1.9 niallo 59: .It Fl k Ns Ar mode
1.1 niallo 60: Specify the keyword substitution mode.
1.9 niallo 61: .It Fl l Ns Op Ar rev
1.1 niallo 62: The same as
63: .Fl r ,
1.3 jmc 64: but also immediately checks out the deposited revision and locks it.
65: This is useful if you wish to continue to edit the working file after check-in.
1.1 niallo 66: .It Fl M
67: Set the modification time of the file to the date of the
68: retrieved revision.
1.9 niallo 69: .It Fl m Ns Ar msg
1.1 niallo 70: Specify a log message.
71: A line beginning with a hash character
72: .Pq Sq #
73: is considered a comment and ignored.
1.10 niallo 74: .It Fl n Ns Ar symbol
75: Assign the symbolic name
76: .Ar symbol
77: to the checked in revision.
1.11 ! niallo 78: .It Fl N Ns Ar symbol
! 79: Same as
! 80: .Ar -n
! 81: except it overwrites any previous assignment of
! 82: .Ar symbol .
1.1 niallo 83: .It Fl q
84: Be quiet about reporting.
1.9 niallo 85: .It Fl r Ns Op Ar rev
1.1 niallo 86: Check in revision
87: .Ar rev .
1.4 niallo 88: However, if
89: .Ar rev
90: is not specified the meaning is completely different \- override any
91: .Fl l
92: or
1.5 niallo 93: .Fl u Op Ar rev
1.4 niallo 94: options, ensuring the default behaviour of releasing a lock and removing the
95: working file.
1.9 niallo 96: .It Fl s Ns Ar state
1.1 niallo 97: Sets the state of the deposited revision to the identifier
98: .Ar state .
99: .It Fl u
100: The same as
101: .Fl r ,
1.3 jmc 102: but also immediately checks out the deposited revision read-only.
103: Useful if you wish to read the working file after check-in.
1.1 niallo 104: .It Fl V
105: Print RCS's version number.
1.9 niallo 106: .It Fl w Ns Ar user
1.1 niallo 107: Uses
108: .Ar user
109: as the author field of the deposited revision.
110: .El
111: .Sh ENVIRONMENT
112: .Bl -tag -width RCSINIT
113: .It Ev RCSINIT
114: If set, this variable should contain a list of space-delimited options that
115: are prepended to the argument list.
116: .El
117: .Sh SEE ALSO
118: .Xr co 1 ,
1.2 niallo 119: .Xr ident 1 ,
1.1 niallo 120: .Xr rcs 1 ,
121: .Xr rcsclean 1 ,
122: .Xr rcsdiff 1 ,
1.6 xsa 123: .Xr rlog 1