Annotation of src/usr.bin/rcs/rlog.1, Revision 1.19
1.19 ! sobrado 1: .\" $OpenBSD: rlog.1,v 1.18 2006/05/08 12:09:34 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
1.13 jmc 25: .Op Fl bhLNqRtV
1.7 xsa 26: .Op Fl d Ns Ar dates
27: .Op Fl l Ns Op Ar lockers
1.11 xsa 28: .Op Fl r Ns Op Ar revs
1.7 xsa 29: .Op Fl s Ns Ar states
30: .Op Fl w Ns Op Ar logins
1.6 xsa 31: .Op Fl x Ns Ar suffixes
1.9 xsa 32: .Op Fl z Ns Ar tz
1.16 jmc 33: .Ar
1.1 xsa 34: .Sh DESCRIPTION
35: The
36: .Nm
37: program displays information about RCS files.
1.16 jmc 38: .Pp
39: A file's complete RCS history can be displayed
40: (the default if no options are specified)
41: or a subset of its history log can be requested,
42: depending on which options are specified.
43: RCS keywords are displayed using the
44: .Xr ident 1
45: utility.
1.1 xsa 46: .Pp
47: The following options are supported:
48: .Bl -tag -width Ds
1.8 xsa 49: .It Fl b
50: Print information about revisions of the default branch only.
1.7 xsa 51: .It Fl d Ns Ar dates
52: Specify revisions with dates matching the specification.
53: The specification might be as follows:
54: .Bl -tag -width Ds
1.19 ! sobrado 55: .It date1<date2 or date2>date1
1.7 xsa 56: Select all revisions between
1.19 ! sobrado 57: .Ar date1
1.7 xsa 58: and
1.19 ! sobrado 59: .Ar date2 .
! 60: .It <date or date>
1.7 xsa 61: Select all revisions before
1.19 ! sobrado 62: .Ar date .
! 63: .It >date or date<
1.7 xsa 64: Select all revisions after
1.19 ! sobrado 65: .Ar date .
! 66: .It date
1.7 xsa 67: Select the latest revision before or equal to
1.19 ! sobrado 68: .Ar date .
1.7 xsa 69: .El
70: .Pp
71: The
72: .Sq \*(Gt
73: and
74: .Sq \*(Lt
75: characters can be followed by the
76: .Sq =
77: character to imply an inclusive specification.
78: Several specifications can be used by separating them with the
79: .Sq \&;
80: character.
1.14 jmc 81: .Pp
82: See also the
83: .Fl z
84: option, below.
1.1 xsa 85: .It Fl h
1.17 jmc 86: Print the RCS header,
87: describing a file's branch, lock details, symbolic names, etc.
1.4 xsa 88: .It Fl L
89: Ignore RCS files with no locks set.
1.7 xsa 90: .It Fl l Ns Op Ar lockers
91: Print information about locked revisions only.
92: If a comma-separated list of login names is specified,
93: ignore all locks other than those held in the list.
1.1 xsa 94: .It Fl N
95: Do not print symbolic names.
96: .It Fl q
97: Be quiet about reporting.
98: .It Fl R
99: Print name of RCS file only.
1.11 xsa 100: .It Fl r Ns Op Ar revs
101: Specify revision(s) to list:
102: .Bl -tag -width Ds
103: .It REV1,REV2,...,
104: A list of revisions is specified by separating names or numbers
105: of revisions by the
106: .Sq \&,
107: character.
108: .It REV1:REV2
109: List all revisions between
110: .Ar REV1
111: and
112: .Ar REV2
113: (they must be on the same branch).
114: .It :REV
115: List all revisions since the beginning of the branch until
116: .Ar REV
117: included.
118: .It REV:
119: List all revisions of the branch beginning with
120: .Ar REV .
121: .It BRANCH
122: List all revisions of a branch.
123: .It BRANCH.
124: List the latest revision of the branch
125: .Ar BRANCH .
126: .It BRANCH1:BRANCH2
127: List all revisions of branches between
128: .Ar BRANCH1
129: and
130: .Ar BRANCH2 .
131: .El
132: .Pp
133: Without argument, the
134: .Fl r
135: option means the latest revision of the default branch.
1.7 xsa 136: .It Fl s Ns Ar states
137: Print information about revisions whose state matches one of the
138: specified
139: .Ar states .
140: Multiple states may be specified as a comma-separated list.
1.1 xsa 141: .It Fl t
142: Print header and description only.
143: .It Fl V
144: Print RCS's version number.
1.7 xsa 145: .It Fl w Ns Op Ar logins
146: Print information about revisions checked in by users specified
147: in a comma-separated list.
148: If
149: .Ar logins
150: is omitted, the user's login is assumed.
1.6 xsa 151: .It Fl x Ns Ar suffixes
152: Specifies the suffixes for RCS files.
153: Suffixes should be separated by the
154: .Sq /
155: character.
1.9 xsa 156: .It Fl z Ns Ar tz
1.14 jmc 157: Specify the date output format.
158: The
159: .Ar tz
160: argument should be a numeric UTC offset
1.15 jmc 161: (e.g. +02:45 would specify an offset of 2 hours 45 minutes).
1.14 jmc 162: .Sq LT
163: may instead be used to specify local time.
164: If no argument is given, a default format is used.
165: This option is also used to set the default time zone for
166: dates used in the
1.9 xsa 167: .Fl d
168: option.
1.1 xsa 169: .El
1.18 xsa 170: .Pp
171: .Ex -std rlog
1.1 xsa 172: .Sh ENVIRONMENT
173: .Bl -tag -width RCSINIT
174: .It Ev RCSINIT
175: If set, this variable should contain a list of space-delimited options that
176: are prepended to the argument list.
177: .El
1.5 xsa 178: .Sh EXAMPLES
179: Print complete information about files:
180: .Pp
181: .Dl $ rlog RCS/*
182: .Pp
183: Print the names of RCS files with locks set:
184: .Pp
185: .Dl $ rlog -L -R RCS/*
1.1 xsa 186: .Sh SEE ALSO
187: .Xr ci 1 ,
188: .Xr co 1 ,
189: .Xr ident 1 ,
190: .Xr rcs 1 ,
191: .Xr rcsclean 1 ,
1.2 xsa 192: .Xr rcsdiff 1 ,
193: .Xr rcsmerge 1
1.13 jmc 194: .Sh STANDARDS
195: The flag
196: .Op Fl T
197: has no effect and is provided
198: for compatibility only.