Annotation of src/usr.bin/rcs/rlog.1, Revision 1.24
1.24 ! jmc 1: .\" $OpenBSD: rlog.1,v 1.23 2007/09/09 17:18:53 ray 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.23 ray 17: .Dd $Mdocdate: September 9 2007 $
1.1 xsa 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.22 ray 25: .Op Fl bhLNRtV
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 R
97: Print name of RCS file only.
1.11 xsa 98: .It Fl r Ns Op Ar revs
99: Specify revision(s) to list:
100: .Bl -tag -width Ds
1.20 sobrado 101: .It rev1,rev2,...
1.11 xsa 102: A list of revisions is specified by separating names or numbers
103: of revisions by the
104: .Sq \&,
105: character.
1.20 sobrado 106: .It rev1:rev2
1.11 xsa 107: List all revisions between
1.20 sobrado 108: .Ar rev1
1.11 xsa 109: and
1.20 sobrado 110: .Ar rev2
1.11 xsa 111: (they must be on the same branch).
1.20 sobrado 112: .It :rev
1.11 xsa 113: List all revisions since the beginning of the branch until
1.20 sobrado 114: .Ar rev
1.11 xsa 115: included.
1.20 sobrado 116: .It rev:
1.11 xsa 117: List all revisions of the branch beginning with
1.20 sobrado 118: .Ar rev .
119: .It branch
1.11 xsa 120: List all revisions of a branch.
1.20 sobrado 121: .It branch.
1.11 xsa 122: List the latest revision of the branch
1.20 sobrado 123: .Ar branch .
124: .It branch1:branch2
1.11 xsa 125: List all revisions of branches between
1.20 sobrado 126: .Ar branch1
1.11 xsa 127: and
1.20 sobrado 128: .Ar branch2 .
1.11 xsa 129: .El
130: .Pp
131: Without argument, the
132: .Fl r
133: option means the latest revision of the default branch.
1.7 xsa 134: .It Fl s Ns Ar states
135: Print information about revisions whose state matches one of the
136: specified
137: .Ar states .
138: Multiple states may be specified as a comma-separated list.
1.1 xsa 139: .It Fl t
140: Print header and description only.
141: .It Fl V
142: Print RCS's version number.
1.7 xsa 143: .It Fl w Ns Op Ar logins
144: Print information about revisions checked in by users specified
145: in a comma-separated list.
146: If
147: .Ar logins
148: is omitted, the user's login is assumed.
1.6 xsa 149: .It Fl x Ns Ar suffixes
150: Specifies the suffixes for RCS files.
151: Suffixes should be separated by the
152: .Sq /
153: character.
1.9 xsa 154: .It Fl z Ns Ar tz
1.14 jmc 155: Specify the date output format.
156: The
157: .Ar tz
158: argument should be a numeric UTC offset
1.15 jmc 159: (e.g. +02:45 would specify an offset of 2 hours 45 minutes).
1.14 jmc 160: .Sq LT
161: may instead be used to specify local time.
162: If no argument is given, a default format is used.
163: This option is also used to set the default time zone for
164: dates used in the
1.9 xsa 165: .Fl d
166: option.
1.1 xsa 167: .El
168: .Sh ENVIRONMENT
169: .Bl -tag -width RCSINIT
170: .It Ev RCSINIT
171: If set, this variable should contain a list of space-delimited options that
172: are prepended to the argument list.
173: .El
1.24 ! jmc 174: .Sh EXIT STATUS
! 175: .Ex -std rlog
1.5 xsa 176: .Sh EXAMPLES
177: Print complete information about files:
178: .Pp
179: .Dl $ rlog RCS/*
180: .Pp
181: Print the names of RCS files with locks set:
182: .Pp
183: .Dl $ rlog -L -R RCS/*
1.1 xsa 184: .Sh SEE ALSO
185: .Xr ci 1 ,
186: .Xr co 1 ,
187: .Xr ident 1 ,
188: .Xr rcs 1 ,
189: .Xr rcsclean 1 ,
1.2 xsa 190: .Xr rcsdiff 1 ,
191: .Xr rcsmerge 1
1.13 jmc 192: .Sh STANDARDS
1.23 ray 193: The flags
194: .Op Fl qT
195: have no effect and are provided
1.13 jmc 196: for compatibility only.