![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to rlog.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDReno / contrib / rcs / man|
Return to rlog.1 CVS log | Up to [CSRG BSD Unix] / 43BSDReno / contrib / rcs / man |
1.1 root 1: .TH RLOG 1L "" "Purdue University"
2: .SH NAME
3: rlog \- print log messages and other information about RCS files
4: .SH SYNOPSIS
5: .B rlog
6: [ options ]
7: file ...
8: .SH DESCRIPTION
9: .I Rlog
10: prints information about RCS files.
11: Files ending in `,v' are RCS files, all others are working files. If
12: a working file is given, \fIrlog\fR tries to find the corresponding
13: RCS file first in directory ./RCS and then in the current directory,
14: as explained in
15: .IR co (1L).
16: .PP
17: \fIRlog\fR prints the following information for each
18: RCS file: RCS file name, working file name, head (i.e., the number
19: of the latest revision on the trunk), default branch, access list, locks,
20: symbolic names, suffix, total number of revisions,
21: number of revisions selected for printing, and
22: descriptive text. This is followed by entries for the selected revisions in
23: reverse chronological order for each branch. For each revision,
24: \fIrlog\fR prints revision number, author, date/time, state, number of
25: lines added/deleted (with respect to the previous revision),
26: locker of the revision (if any), and log message.
27: Without options, \fIrlog\fR prints complete information.
28: The options below restrict this output.
29: .TP 10
30: .B \-L
31: ignores RCS files that have no locks set; convenient in combination with
32: \fB\-R\fR, \fB\-h\fR, or \fB\-l\fR.
33: .TP 10
34: .B \-R
35: only prints the name of the RCS file; convenient for translating a
36: working file name into an RCS file name.
37: .TP 10
38: .B \-h
39: prints only RCS file name, working file name, head,
40: default branch, access list, locks,
41: symbolic names, and suffix.
42: .TP 10
43: .B \-t
44: prints the same as \fB\-h\fR, plus the descriptive text.
45: .TP 10
46: .B \-b
47: prints information about the revisions on the default branch (normally
48: the highest branch on the trunk).
49: .TP 10
50: .BI \-d "dates"
51: prints information about revisions with a checkin date/time in the ranges given by
52: the semicolon-separated list of \fIdates\fR.
53: A range of the form \fId1<d2\fR or \fId2>d1\fR
54: selects the revisions that were deposited between
55: \fId1\fR and \fId2\fR, (inclusive).
56: A range of the form \fI<d\fR or \fId>\fR selects
57: all revisions dated
58: \fId\fR or earlier.
59: A range of the form \fId<\fR or \fI>d\fR selects
60: all revisions dated \fId\fR or later.
61: A range of the form \fId\fR selects the single, latest revision dated \fId\fR or
62: earlier.
63: The date/time strings \fId, d1, \fRand \fId2\fR
64: are in the free format explained in
65: .IR co (1L).
66: Quoting is normally necessary, especially for \fI<\fR and \fI>\fR. Note that the separator is
67: a semicolon.
68: .TP 10
69: .B \-l\fR[\fIlockers\fR]
70: prints information about locked revisions.
71: If the comma-separated list \fIlockers\fR of login names is given,
72: only the revisions locked by the given login names are printed.
73: If the list is omitted, all locked revisions are printed.
74: .TP 10
75: .BI \-r "revisions"
76: prints information about revisions given in the comma-separated list
77: \fIrevisions\fR of revisions and ranges. A range \fIrev1-rev2\fR means revisions
78: \fIrev1\fR to \fIrev2\fR on the same branch, \fI-rev\fR means revisions
79: from the beginning of the branch up to and including \fIrev\fR,
80: and \fIrev-\fR means revisions starting with \fIrev\fR to the end of the
81: branch containing \fIrev\fR. An argument that is a branch means all
82: revisions on that branch. A range of branches means all revisions
83: on the branches in that range.
84: .TP 10
85: .BI \-s "states"
86: prints information about revisions whose state attributes match one of the
87: states given in the comma-separated list \fIstates\fR.
88: .TP 10
89: .B \-w\fR[\fIlogins\fR]
90: prints information about revisions checked in by users with
91: login names appearing in the comma-separated list \fIlogins\fR.
92: If \fIlogins\fR is omitted, the user's login is assumed.
93: .PP
94: \fIRlog\fR prints the intersection of the revisions selected with
95: the options \fB\-d\fR, \fB\-l\fR, \fB\-s\fR, \fB\-w\fR, intersected
96: with the union of the revisions selected by \fB\-b\fR and \fB\-r\fR.
97: .SH EXAMPLES
98: .nf
99: .sp
100: rlog \-L \-R RCS/*,v
101: rlog \-L \-h RCS/*,v
102: rlog \-L \-l RCS/*,v
103: rlog RCS/*,v
104: .sp
105: .fi
106: The first command prints the names of all RCS files in the subdirectory `RCS'
107: which have locks. The second command prints the headers of those files,
108: and the third prints the headers plus the log messages of the locked revisions.
109: The last command prints complete information.
110: .SH DIAGNOSTICS
111: The exit status always refers to the last RCS file operated upon,
112: and is 0 if the operation was successful, 1 otherwise.
113: .SH IDENTIFICATION
114: .de VL
115: \\$2
116: ..
117: Author: Walter F. Tichy,
118: Purdue University, West Lafayette, IN, 47907.
119: .sp 0
120: Revision Number:
121: .VL $Revision: 1.3 $
122: ; Release Date:
123: .VL $Date: 89/05/02 11:19:20 $
124: \&.
125: .sp 0
126: Copyright \(co 1982, 1988, 1989 by Walter F. Tichy.
127: .SH SEE ALSO
128: ci(1L), co(1L), ident(1L), rcs(1L), rcsdiff(1L), rcsintro(1L), rcsmerge(1L),
129: rcsfile(5L)
130: .br
131: Walter F. Tichy, "Design, Implementation, and Evaluation of a Revision Control
132: System," in \fIProceedings of the 6th International Conference on Software
133: Engineering\fR, IEEE, Tokyo, Sept. 1982.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.