Annotation of src/usr.bin/rcs/rlog.1, Revision 1.12
1.12 ! deraadt 1: .\" $OpenBSD: rlog.1,v 1.11 2005/12/02 11:13:32 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.
17: .Dd October 12, 2005
18: .Dt RLOG 1
19: .Os
20: .Sh NAME
21: .Nm rlog
22: .Nd display information about RCS files
23: .Sh SYNOPSIS
24: .Nm
25: .Bk -words
1.8 xsa 26: .Op Fl bhLNqRTtV
1.7 xsa 27: .Op Fl d Ns Ar dates
28: .Op Fl l Ns Op Ar lockers
1.11 xsa 29: .Op Fl r Ns Op Ar revs
1.7 xsa 30: .Op Fl s Ns Ar states
31: .Op Fl w Ns Op Ar logins
1.6 xsa 32: .Op Fl x Ns Ar suffixes
1.9 xsa 33: .Op Fl z Ns Ar tz
1.1 xsa 34: .Ar file ...
35: .Ek
36: .Sh DESCRIPTION
37: The
38: .Nm
39: program displays information about RCS files.
40: .Pp
41: The following options are supported:
42: .Bl -tag -width Ds
1.8 xsa 43: .It Fl b
44: Print information about revisions of the default branch only.
1.7 xsa 45: .It Fl d Ns Ar dates
46: Specify revisions with dates matching the specification.
47: The specification might be as follows:
48: .Bl -tag -width Ds
49: .It D1>D2 or D2>D1
50: Select all revisions between
51: .Ar \&D1
52: and
53: .Ar D2 .
54: .It <D or D>
55: Select all revisions before
56: .Ar D .
57: .It >D or D<
58: Select all revisions after
59: .Ar D .
60: .It D
61: Select the latest revision before or equal to
62: .Ar D .
63: .El
64: .Pp
65: The
66: .Sq \*(Gt
67: and
68: .Sq \*(Lt
69: characters can be followed by the
70: .Sq =
71: character to imply an inclusive specification.
72: Several specifications can be used by separating them with the
73: .Sq \&;
74: character.
1.1 xsa 75: .It Fl h
76: Print header.
1.4 xsa 77: .It Fl L
78: Ignore RCS files with no locks set.
1.7 xsa 79: .It Fl l Ns Op Ar lockers
80: Print information about locked revisions only.
81: If a comma-separated list of login names is specified,
82: ignore all locks other than those held in the list.
1.1 xsa 83: .It Fl N
84: Do not print symbolic names.
85: .It Fl q
86: Be quiet about reporting.
87: .It Fl R
88: Print name of RCS file only.
1.11 xsa 89: .It Fl r Ns Op Ar revs
90: Specify revision(s) to list:
91: .Bl -tag -width Ds
92: .It REV1,REV2,...,
93: A list of revisions is specified by separating names or numbers
94: of revisions by the
95: .Sq \&,
96: character.
97: .It REV1:REV2
98: List all revisions between
99: .Ar REV1
100: and
101: .Ar REV2
102: (they must be on the same branch).
103: .It :REV
104: List all revisions since the beginning of the branch until
105: .Ar REV
106: included.
107: .It REV:
108: List all revisions of the branch beginning with
109: .Ar REV .
110: .It BRANCH
111: List all revisions of a branch.
112: .It BRANCH.
113: List the latest revision of the branch
114: .Ar BRANCH .
115: .It BRANCH1:BRANCH2
116: List all revisions of branches between
117: .Ar BRANCH1
118: and
119: .Ar BRANCH2 .
120: .El
121: .Pp
122: Without argument, the
123: .Fl r
124: option means the latest revision of the default branch.
1.7 xsa 125: .It Fl s Ns Ar states
126: Print information about revisions whose state matches one of the
127: specified
128: .Ar states .
129: Multiple states may be specified as a comma-separated list.
1.3 xsa 130: .It Fl T
131: No effect.
132: For compatibility.
1.1 xsa 133: .It Fl t
134: Print header and description only.
135: .It Fl V
136: Print RCS's version number.
1.7 xsa 137: .It Fl w Ns Op Ar logins
138: Print information about revisions checked in by users specified
139: in a comma-separated list.
140: If
141: .Ar logins
142: is omitted, the user's login is assumed.
1.6 xsa 143: .It Fl x Ns Ar suffixes
144: Specifies the suffixes for RCS files.
145: Suffixes should be separated by the
146: .Sq /
147: character.
1.9 xsa 148: .It Fl z Ns Ar tz
1.10 xsa 149: Specify the date output format, and the default time zone for
1.9 xsa 150: .Ar dates
151: used in the
152: .Fl d
153: option.
1.1 xsa 154: .El
155: .Sh ENVIRONMENT
156: .Bl -tag -width RCSINIT
157: .It Ev RCSINIT
158: If set, this variable should contain a list of space-delimited options that
159: are prepended to the argument list.
160: .El
1.5 xsa 161: .Sh EXAMPLES
162: Print complete information about files:
163: .Pp
164: .Dl $ rlog RCS/*
165: .Pp
166: Print the names of RCS files with locks set:
167: .Pp
168: .Dl $ rlog -L -R RCS/*
1.1 xsa 169: .Sh SEE ALSO
170: .Xr ci 1 ,
171: .Xr co 1 ,
172: .Xr ident 1 ,
173: .Xr rcs 1 ,
174: .Xr rcsclean 1 ,
1.2 xsa 175: .Xr rcsdiff 1 ,
176: .Xr rcsmerge 1