Annotation of src/usr.bin/rcs/rlog.1, Revision 1.9
1.9 ! xsa 1: .\" $OpenBSD: rlog.1,v 1.8 2005/11/29 09:16:07 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
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.1 xsa 33: .Ar file ...
34: .Ek
35: .Sh DESCRIPTION
36: The
37: .Nm
38: program displays information about RCS files.
39: .Pp
40: The following options are supported:
41: .Bl -tag -width Ds
1.8 xsa 42: .It Fl b
43: Print information about revisions of the default branch only.
1.7 xsa 44: .It Fl d Ns Ar dates
45: Specify revisions with dates matching the specification.
46: The specification might be as follows:
47: .Bl -tag -width Ds
48: .It D1>D2 or D2>D1
49: Select all revisions between
50: .Ar \&D1
51: and
52: .Ar D2 .
53: .It <D or D>
54: Select all revisions before
55: .Ar D .
56: .It >D or D<
57: Select all revisions after
58: .Ar D .
59: .It D
60: Select the latest revision before or equal to
61: .Ar D .
62: .El
63: .Pp
64: The
65: .Sq \*(Gt
66: and
67: .Sq \*(Lt
68: characters can be followed by the
69: .Sq =
70: character to imply an inclusive specification.
71: Several specifications can be used by separating them with the
72: .Sq \&;
73: character.
1.1 xsa 74: .It Fl h
75: Print header.
1.4 xsa 76: .It Fl L
77: Ignore RCS files with no locks set.
1.7 xsa 78: .It Fl l Ns Op Ar lockers
79: Print information about locked revisions only.
80: If a comma-separated list of login names is specified,
81: ignore all locks other than those held in the list.
1.1 xsa 82: .It Fl N
83: Do not print symbolic names.
84: .It Fl q
85: Be quiet about reporting.
86: .It Fl R
87: Print name of RCS file only.
1.7 xsa 88: .It Fl s Ns Ar states
89: Print information about revisions whose state matches one of the
90: specified
91: .Ar states .
92: Multiple states may be specified as a comma-separated list.
1.3 xsa 93: .It Fl T
94: No effect.
95: For compatibility.
1.1 xsa 96: .It Fl t
97: Print header and description only.
98: .It Fl V
99: Print RCS's version number.
1.7 xsa 100: .It Fl w Ns Op Ar logins
101: Print information about revisions checked in by users specified
102: in a comma-separated list.
103: If
104: .Ar logins
105: is omitted, the user's login is assumed.
1.6 xsa 106: .It Fl x Ns Ar suffixes
107: Specifies the suffixes for RCS files.
108: Suffixes should be separated by the
109: .Sq /
110: character.
1.9 ! xsa 111: .It Fl z Ns Ar tz
! 112: Specify the date output format, and the default timezone for
! 113: .Ar dates
! 114: used in the
! 115: .Fl d
! 116: option.
1.1 xsa 117: .El
118: .Sh ENVIRONMENT
119: .Bl -tag -width RCSINIT
120: .It Ev RCSINIT
121: If set, this variable should contain a list of space-delimited options that
122: are prepended to the argument list.
123: .El
1.5 xsa 124: .Sh EXAMPLES
125: Print complete information about files:
126: .Pp
127: .Dl $ rlog RCS/*
128: .Pp
129: Print the names of RCS files with locks set:
130: .Pp
131: .Dl $ rlog -L -R RCS/*
1.1 xsa 132: .Sh SEE ALSO
133: .Xr ci 1 ,
134: .Xr co 1 ,
135: .Xr ident 1 ,
136: .Xr rcs 1 ,
137: .Xr rcsclean 1 ,
1.2 xsa 138: .Xr rcsdiff 1 ,
139: .Xr rcsmerge 1