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