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