Annotation of src/usr.bin/rcs/rlog.1, Revision 1.11
1.11 ! xsa 1: .\" $OpenBSD: rlog.1,v 1.10 2005/11/30 10:54:05 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