Annotation of src/usr.bin/rcs/co.1, Revision 1.17
1.17 ! xsa 1: .\" $OpenBSD: co.1,v 1.16 2005/11/27 10:55:38 jmc Exp $
1.1 xsa 2: .\"
3: .\" Copyright (c) 2005 Xavier Santolaria <xsa@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.
1.2 jmc 17: .Dd October 03, 2005
1.1 xsa 18: .Dt CO 1
19: .Os
20: .Sh NAME
21: .Nm co
22: .Nd check out RCS revisions
23: .Sh SYNOPSIS
24: .Nm
25: .Bk -words
1.15 xsa 26: .Op Fl TV
1.7 niallo 27: .Op Fl d Ns Ar date
1.13 xsa 28: .Op Fl f Ns Op Ar rev
29: .Op Fl I Ns Op Ar rev
1.7 niallo 30: .Op Fl k Ns Ar mode
31: .Op Fl l Ns Op Ar rev
1.10 niallo 32: .Op Fl M Ns Op Ar rev
1.7 niallo 33: .Op Fl m Ns Ar msg
1.9 niallo 34: .Op Fl p Ns Op Ar rev
1.13 xsa 35: .Op Fl q Ns Op Ar rev
1.7 niallo 36: .Op Fl r Ns Op Ar rev
37: .Op Fl s Ns Ar state
38: .Op Fl u Ns Op Ar rev
1.17 ! xsa 39: .Op Fl w Ns Op Ar user
1.7 niallo 40: .Op Fl x Ns Ar suffixes
41: .Op Fl z Ns Ar tz
1.1 xsa 42: .Ar file ...
43: .Ek
44: .Sh DESCRIPTION
45: .Nm
46: always performs keyword substitution.
47: .Pp
48: The following options are supported:
49: .Bl -tag -width Ds
1.7 niallo 50: .It Fl d Ns Ar date
1.1 xsa 51: Retrieve revision as of the latest revision no later than
52: .Ar date .
1.13 xsa 53: .It Fl f Ns Op Ar rev
1.1 xsa 54: Force the overwriting of the working file.
1.13 xsa 55: .It Fl I Ns Op Ar rev
1.1 xsa 56: Interactive mode.
1.7 niallo 57: .It Fl k Ns Ar mode
1.1 xsa 58: Specify the keyword substitution mode.
1.7 niallo 59: .It Fl l Ns Op Ar rev
1.1 xsa 60: The same as
61: .Fl r ,
1.2 jmc 62: but also locks the revision.
1.10 niallo 63: .It Fl M Ns Op Ar rev
1.2 jmc 64: Set the modification time of the file to the date of the
1.1 xsa 65: retrieved revision.
1.7 niallo 66: .It Fl m Ns Ar msg
1.1 xsa 67: Specify a log message.
68: A line beginning with a hash character
69: .Pq Sq #
70: is considered a comment and ignored.
1.9 niallo 71: .It Fl p Ns Op Ar rev
72: Print the latest revision no later than
73: .Ar rev
74: to standard output.
75: If
76: .Ar rev
77: is not specified, print HEAD.
1.14 jmc 78: .It Fl q Ns Op Ar rev
1.1 xsa 79: Be quiet about reporting.
1.7 niallo 80: .It Fl r Ns Op Ar rev
1.1 xsa 81: Retrieve the latest revision no later than
82: .Ar rev .
1.5 niallo 83: If
84: .Ar rev
85: is not specified, retrieve HEAD.
1.7 niallo 86: .It Fl s Ns Ar state
1.1 xsa 87: Retrieve revision of the specified
88: .Ar state
89: only.
1.7 niallo 90: .It Fl u Ns Op Ar rev
1.1 xsa 91: The same as
92: .Fl r ,
1.2 jmc 93: but also unlocks the retrieved revision if it was locked.
1.15 xsa 94: .It Fl T
1.16 jmc 95: Preserve the modification time of RCS files.
1.1 xsa 96: .It Fl V
97: Print RCS's version number.
1.17 ! xsa 98: .It Fl w Ns Op Ar user
1.1 xsa 99: Retrieve the latest revision which was checked in by the specified
100: .Ar user .
101: If the
102: .Ar user
1.2 jmc 103: argument is omitted, the login of the user issuing the command
1.1 xsa 104: is assumed.
1.7 niallo 105: .It Fl x Ns Ar suffixes
1.1 xsa 106: Specifies the suffixes for RCS files.
107: Suffixes should be separated by the
108: .Sq /
109: character.
1.7 niallo 110: .It Fl z Ns Ar tz
1.1 xsa 111: Specify the date output format in keyword substitution, and the
112: default timezone for
113: .Ar date
114: used in the
115: .Fl d
116: option.
117: .El
118: .Sh ENVIRONMENT
119: .Bl -tag -width RCSINIT
120: .It Ev RCSINIT
121: If set, this variable should contain a list of space-delimited options that
122: are prepended to the argument list.
123: .El
1.11 xsa 124: .Sh EXAMPLES
125: Retrieve the latest revision of file
126: .Pa foo.c
127: and lock it for further editing:
128: .Pp
129: .Dl $ co -l foo.c
130: .Pp
131: Retrieve revision 1.5 of file
132: .Pa foo.c :
133: .Pp
134: .Dl $ co -r1.5 foo.c
1.1 xsa 135: .Sh SEE ALSO
136: .Xr ci 1 ,
1.4 jmc 137: .Xr ident 1 ,
1.1 xsa 138: .Xr rcs 1 ,
139: .Xr rcsclean 1 ,
140: .Xr rcsdiff 1 ,
1.8 xsa 141: .Xr rcsmerge 1 ,
1.6 xsa 142: .Xr rlog 1