Annotation of src/usr.bin/rcs/rlog.1, Revision 1.15
1.15 ! jmc 1: .\" $OpenBSD: rlog.1,v 1.14 2006/03/27 08:20:55 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.
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.13 jmc 26: .Op Fl bhLNqRtV
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.14 jmc 75: .Pp
76: See also the
77: .Fl z
78: option, below.
1.1 xsa 79: .It Fl h
80: Print header.
1.4 xsa 81: .It Fl L
82: Ignore RCS files with no locks set.
1.7 xsa 83: .It Fl l Ns Op Ar lockers
84: Print information about locked revisions only.
85: If a comma-separated list of login names is specified,
86: ignore all locks other than those held in the list.
1.1 xsa 87: .It Fl N
88: Do not print symbolic names.
89: .It Fl q
90: Be quiet about reporting.
91: .It Fl R
92: Print name of RCS file only.
1.11 xsa 93: .It Fl r Ns Op Ar revs
94: Specify revision(s) to list:
95: .Bl -tag -width Ds
96: .It REV1,REV2,...,
97: A list of revisions is specified by separating names or numbers
98: of revisions by the
99: .Sq \&,
100: character.
101: .It REV1:REV2
102: List all revisions between
103: .Ar REV1
104: and
105: .Ar REV2
106: (they must be on the same branch).
107: .It :REV
108: List all revisions since the beginning of the branch until
109: .Ar REV
110: included.
111: .It REV:
112: List all revisions of the branch beginning with
113: .Ar REV .
114: .It BRANCH
115: List all revisions of a branch.
116: .It BRANCH.
117: List the latest revision of the branch
118: .Ar BRANCH .
119: .It BRANCH1:BRANCH2
120: List all revisions of branches between
121: .Ar BRANCH1
122: and
123: .Ar BRANCH2 .
124: .El
125: .Pp
126: Without argument, the
127: .Fl r
128: option means the latest revision of the default branch.
1.7 xsa 129: .It Fl s Ns Ar states
130: Print information about revisions whose state matches one of the
131: specified
132: .Ar states .
133: Multiple states may be specified as a comma-separated list.
1.1 xsa 134: .It Fl t
135: Print header and description only.
136: .It Fl V
137: Print RCS's version number.
1.7 xsa 138: .It Fl w Ns Op Ar logins
139: Print information about revisions checked in by users specified
140: in a comma-separated list.
141: If
142: .Ar logins
143: is omitted, the user's login is assumed.
1.6 xsa 144: .It Fl x Ns Ar suffixes
145: Specifies the suffixes for RCS files.
146: Suffixes should be separated by the
147: .Sq /
148: character.
1.9 xsa 149: .It Fl z Ns Ar tz
1.14 jmc 150: Specify the date output format.
151: The
152: .Ar tz
153: argument should be a numeric UTC offset
1.15 ! jmc 154: (e.g. +02:45 would specify an offset of 2 hours 45 minutes).
1.14 jmc 155: .Sq LT
156: may instead be used to specify local time.
157: If no argument is given, a default format is used.
158: This option is also used to set the default time zone for
159: dates used in the
1.9 xsa 160: .Fl d
161: option.
1.1 xsa 162: .El
163: .Sh ENVIRONMENT
164: .Bl -tag -width RCSINIT
165: .It Ev RCSINIT
166: If set, this variable should contain a list of space-delimited options that
167: are prepended to the argument list.
168: .El
1.5 xsa 169: .Sh EXAMPLES
170: Print complete information about files:
171: .Pp
172: .Dl $ rlog RCS/*
173: .Pp
174: Print the names of RCS files with locks set:
175: .Pp
176: .Dl $ rlog -L -R RCS/*
1.1 xsa 177: .Sh SEE ALSO
178: .Xr ci 1 ,
179: .Xr co 1 ,
180: .Xr ident 1 ,
181: .Xr rcs 1 ,
182: .Xr rcsclean 1 ,
1.2 xsa 183: .Xr rcsdiff 1 ,
184: .Xr rcsmerge 1
1.13 jmc 185: .Sh STANDARDS
186: The flag
187: .Op Fl T
188: has no effect and is provided
189: for compatibility only.