BSD 4_3_Net_2 development

[unix-history] / usr / src / contrib / rcs / man / rlog.1

.TH RLOG 1L "" "Purdue University"
.SH NAME
rlog \- print log messages and other information about RCS files
.SH SYNOPSIS
.B rlog
[ options ]
file ...
.SH DESCRIPTION
.I Rlog
prints information about RCS files.
Files ending in `,v' are RCS files, all others are working files. If
a working file is given, \fIrlog\fR tries to find the corresponding
RCS file first in directory ./RCS and then in the current directory,
as explained in
.IR co (1L).
.PP
\fIRlog\fR prints the following information for each
RCS file: RCS file name, working file name, head (i.e., the number
of the latest revision on the trunk), default branch, access list, locks,
symbolic names, suffix, total number of revisions, 
number of revisions selected for printing, and 
descriptive text. This is followed by entries for the selected revisions in
reverse chronological order for each branch. For each revision,
\fIrlog\fR prints revision number, author, date/time, state, number of
lines added/deleted (with respect to the previous revision),
locker of the revision (if any), and log message.
Without options, \fIrlog\fR prints complete information.
The options below restrict this output.
.TP 10
.B \-L
ignores RCS files that have no locks set; convenient in combination with
\fB\-R\fR, \fB\-h\fR, or \fB\-l\fR.
.TP 10
.B \-R
only prints the name of the RCS file; convenient for translating a
working file name into an RCS file name.
.TP 10
.B \-h
prints only RCS file name, working file name, head, 
default branch, access list, locks,
symbolic names, and suffix.
.TP 10
.B \-t
prints the same as \fB\-h\fR, plus the descriptive text.
.TP 10
.B \-b
prints information about the revisions on the default branch (normally
the highest branch on the trunk).
.TP 10
.BI \-d "dates"
prints information about revisions with a checkin date/time in the ranges given by
the semicolon-separated list of \fIdates\fR.
A range of the form \fId1<d2\fR or \fId2>d1\fR
selects the revisions that were deposited between
\fId1\fR and \fId2\fR, (inclusive).
A range of the form \fI<d\fR or \fId>\fR selects
all revisions dated
\fId\fR or earlier.
A range of the form \fId<\fR or \fI>d\fR selects
all revisions dated \fId\fR or later.
A range of the form \fId\fR selects the single, latest revision dated \fId\fR or
earlier.
The date/time strings \fId, d1, \fRand \fId2\fR
are in the free format explained in
.IR co (1L). 
Quoting is normally necessary, especially for \fI<\fR and \fI>\fR. Note that the separator is
a semicolon.
.TP 10
.B \-l\fR[\fIlockers\fR]
prints information about locked revisions.
If the comma-separated list \fIlockers\fR of login names is given,
only the revisions locked by the given login names are printed.
If the list is omitted, all locked revisions are printed.
.TP 10
.BI \-r "revisions"
prints information about revisions given in the comma-separated list
\fIrevisions\fR of revisions and ranges. A range \fIrev1-rev2\fR means revisions
\fIrev1\fR to \fIrev2\fR on the same branch, \fI-rev\fR means revisions
from the beginning of the branch up to and including \fIrev\fR,
and \fIrev-\fR means revisions starting with \fIrev\fR to the end of the
branch containing \fIrev\fR. An argument that is a branch means all
revisions on that branch. A range of branches means all revisions
on the branches in that range.
.TP 10
.BI \-s "states"
prints information about revisions whose state attributes match one of the
states given in the comma-separated list \fIstates\fR.
.TP 10
.B \-w\fR[\fIlogins\fR]
prints information about revisions checked in by users with 
login names appearing in the comma-separated list \fIlogins\fR.
If \fIlogins\fR is omitted, the user's login is assumed.
.PP
\fIRlog\fR prints the intersection of the revisions selected with
the options \fB\-d\fR, \fB\-l\fR, \fB\-s\fR, \fB\-w\fR, intersected
with the union of the revisions selected by \fB\-b\fR and \fB\-r\fR.
.SH EXAMPLES
.nf
.sp
        rlog  \-L  \-R  RCS/*,v
        rlog  \-L  \-h  RCS/*,v
        rlog  \-L  \-l  RCS/*,v
        rlog  RCS/*,v
.sp
.fi
The first command prints the names of all RCS files in the subdirectory `RCS'
which have locks. The second command prints the headers of those files,
and the third prints the headers plus the log messages of the locked revisions.
The last command prints complete information.
.SH DIAGNOSTICS
The exit status always refers to the last RCS file operated upon,
and is 0 if the operation was successful, 1 otherwise.
.SH IDENTIFICATION
.de VL
\\$2
..
Author: Walter F. Tichy,
Purdue University, West Lafayette, IN, 47907.
.sp 0
Revision Number:
.VL $Revision: 1.3 $
; Release Date:
.VL $Date: 89/05/02 11:19:20 $
\&.
.sp 0
Copyright \(co 1982, 1988, 1989 by Walter F. Tichy.
.SH SEE ALSO
ci(1L), co(1L), ident(1L), rcs(1L), rcsdiff(1L), rcsintro(1L), rcsmerge(1L),
rcsfile(5L)
.br
Walter F. Tichy, "Design, Implementation, and Evaluation of a Revision Control
System," in \fIProceedings of the 6th International Conference on Software
Engineering\fR, IEEE, Tokyo, Sept. 1982.