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