Annotation of src/usr.bin/rcs/co.1, Revision 1.4
1.4 ! jmc 1: .\" $OpenBSD: co.1,v 1.3 2005/10/08 19:05:15 joris 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
26: .Op Fl fIlMpqruV
27: .Op Ar rev
28: .Op Fl d Ar date
29: .Op Fl k Ar mode
30: .Op Fl m Ar msg
31: .Op Fl s Ar state
32: .Op Fl w Ar user
33: .Op Fl x Ar suffixes
34: .Op Fl z Ar tz
35: .Ar file ...
36: .Ek
37: .Sh DESCRIPTION
38: .Nm
39: always performs keyword substitution.
40: .Pp
41: The following options are supported:
42: .Bl -tag -width Ds
43: .It Fl d Ar date
44: Retrieve revision as of the latest revision no later than
45: .Ar date .
46: .It Fl f
47: Force the overwriting of the working file.
48: .It Fl I
49: Interactive mode.
50: .It Fl k Ar mode
51: Specify the keyword substitution mode.
52: .It Fl l
53: The same as
54: .Fl r ,
1.2 jmc 55: but also locks the revision.
1.1 xsa 56: .It Fl M
1.2 jmc 57: Set the modification time of the file to the date of the
1.1 xsa 58: retrieved revision.
59: .It Fl m Ar msg
60: Specify a log message.
61: A line beginning with a hash character
62: .Pq Sq #
63: is considered a comment and ignored.
64: .It Fl p
65: Print the retrieved revision to standard output.
66: .It Fl q
67: Be quiet about reporting.
68: .It Fl r
69: Retrieve the latest revision no later than
70: .Ar rev .
71: .It Fl s Ar state
72: Retrieve revision of the specified
73: .Ar state
74: only.
75: .It Fl u
76: The same as
77: .Fl r ,
1.2 jmc 78: but also unlocks the retrieved revision if it was locked.
1.1 xsa 79: .It Fl V
80: Print RCS's version number.
81: .It Fl w Ar user
82: Retrieve the latest revision which was checked in by the specified
83: .Ar user .
84: If the
85: .Ar user
1.2 jmc 86: argument is omitted, the login of the user issuing the command
1.1 xsa 87: is assumed.
88: .It Fl x Ar suffixes
89: Specifies the suffixes for RCS files.
90: Suffixes should be separated by the
91: .Sq /
92: character.
93: .It Fl z Ar tz
94: Specify the date output format in keyword substitution, and the
95: default timezone for
96: .Ar date
97: used in the
98: .Fl d
99: option.
100: .El
101: .Sh ENVIRONMENT
102: .Bl -tag -width RCSINIT
103: .It Ev RCSINIT
104: If set, this variable should contain a list of space-delimited options that
105: are prepended to the argument list.
106: .El
107: .Sh SEE ALSO
108: .Xr ci 1 ,
1.4 ! jmc 109: .Xr ident 1 ,
1.1 xsa 110: .Xr rcs 1 ,
111: .Xr rcsclean 1 ,
112: .Xr rcsdiff 1 ,
113: .Xr rcsfile 5