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