261 lines
5.6 KiB
Groff
261 lines
5.6 KiB
Groff
.de Id
|
|
.ds Rv \\$3
|
|
.ds Dt \\$4
|
|
..
|
|
.Id $Id: rlog.1,v 5.3 1991/08/22 06:50:48 eggert Exp $
|
|
.ds g \&\s-1UTC\s0
|
|
.ds r \&\s-1RCS\s0
|
|
.if n .ds - \%--
|
|
.if t .ds - \(em
|
|
.TH RLOG 1 \*(Dt GNU
|
|
.SH NAME
|
|
rlog \- print log messages and other information about RCS files
|
|
.SH SYNOPSIS
|
|
.B rlog
|
|
.RI [ " options " ] " file " .\|.\|.
|
|
.SH DESCRIPTION
|
|
.B rlog
|
|
prints information about \*r files.
|
|
.PP
|
|
Pathnames matching an \*r suffix denote \*r files;
|
|
all others denote working files.
|
|
Names are paired as explained in
|
|
.BR ci (1).
|
|
.PP
|
|
.B rlog
|
|
prints the following information for each
|
|
\*r file: \*r pathname, working pathname, 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,
|
|
.B rlog
|
|
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.
|
|
All times are displayed in Coordinated Universal Time (\*g).
|
|
Without options,
|
|
.B rlog
|
|
prints complete information.
|
|
The options below restrict this output.
|
|
.nr n \w'\f3\-V\fP\f2n\fP '+1n-1/1n
|
|
.TP \nn
|
|
.B \-L
|
|
Ignore \*r files that have no locks set.
|
|
This is convenient in combination with
|
|
.BR \-h ,
|
|
.BR \-l ,
|
|
and
|
|
.BR \-R .
|
|
.TP
|
|
.B \-R
|
|
Print only the name of the \*r file.
|
|
This is convenient for translating a
|
|
working pathname into an \*r pathname.
|
|
.TP
|
|
.B \-h
|
|
Print only the \*r pathname, working pathname, head,
|
|
default branch, access list, locks,
|
|
symbolic names, and suffix.
|
|
.TP
|
|
.B \-t
|
|
Print the same as
|
|
.BR \-h ,
|
|
plus the descriptive text.
|
|
.TP
|
|
.B \-b
|
|
Print information about the revisions on the default branch, normally
|
|
the highest branch on the trunk.
|
|
.TP
|
|
.BI \-d "dates"
|
|
Print information about revisions with a checkin date/time in the ranges given by
|
|
the semicolon-separated list of
|
|
.IR dates .
|
|
A range of the form
|
|
.IB d1 < d2
|
|
or
|
|
.IB d2 > d1
|
|
selects the revisions that were deposited between
|
|
.I d1
|
|
and
|
|
.I d2
|
|
inclusive.
|
|
A range of the form
|
|
.BI < d
|
|
or
|
|
.IB d >
|
|
selects
|
|
all revisions dated
|
|
.I d
|
|
or earlier.
|
|
A range of the form
|
|
.IB d <
|
|
or
|
|
.BI > d
|
|
selects
|
|
all revisions dated
|
|
.I d
|
|
or later.
|
|
A range of the form
|
|
.I d
|
|
selects the single, latest revision dated
|
|
.I d
|
|
or earlier.
|
|
The date/time strings
|
|
.IR d ,
|
|
.IR d1 ,
|
|
and
|
|
.I d2
|
|
are in the free format explained in
|
|
.BR co (1).
|
|
Quoting is normally necessary, especially for
|
|
.B <
|
|
and
|
|
.BR > .
|
|
Note that the separator is
|
|
a semicolon.
|
|
.TP
|
|
.BR \-l [\f2lockers\fP]
|
|
Print information about locked revisions only.
|
|
In addition, if the comma-separated list
|
|
.I lockers
|
|
of login names is given,
|
|
ignore all locks other than those held by the
|
|
.IR lockers .
|
|
For example,
|
|
.B "rlog\ \-L\ \-R\ \-lwft\ RCS/*"
|
|
prints the name of \*r files locked by the user
|
|
.BR wft .
|
|
.TP
|
|
.BR \-r [\f2revisions\fP]
|
|
prints information about revisions given in the comma-separated list
|
|
.I revisions
|
|
of revisions and ranges.
|
|
A range
|
|
.IB rev1 : rev2
|
|
means revisions
|
|
.I rev1
|
|
to
|
|
.I rev2
|
|
on the same branch,
|
|
.BI : rev
|
|
means revisions from the beginning of the branch up to and including
|
|
.IR rev ,
|
|
and
|
|
.IB rev :
|
|
means revisions starting with
|
|
.I rev
|
|
to the end of the branch containing
|
|
.IR rev .
|
|
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.
|
|
A branch followed by a
|
|
.B .\&
|
|
means the latest revision in that branch.
|
|
A bare
|
|
.B \-r
|
|
with no
|
|
.I revisions
|
|
means the latest revision on the default branch, normally the trunk.
|
|
.TP
|
|
.BI \-s states
|
|
prints information about revisions whose state attributes match one of the
|
|
states given in the comma-separated list
|
|
.IR states .
|
|
.TP
|
|
.BR \-w [\f2logins\fP]
|
|
prints information about revisions checked in by users with
|
|
login names appearing in the comma-separated list
|
|
.IR logins .
|
|
If
|
|
.I logins
|
|
is omitted, the user's login is assumed.
|
|
.TP
|
|
.BI \-V n
|
|
Emulate \*r version
|
|
.I n
|
|
when generating logs.
|
|
See
|
|
.BR co (1)
|
|
for more.
|
|
.TP
|
|
.BI \-x "suffixes"
|
|
Use
|
|
.I suffixes
|
|
to characterize \*r files.
|
|
See
|
|
.BR ci (1)
|
|
for details.
|
|
.PP
|
|
.B rlog
|
|
prints the intersection of the revisions selected with
|
|
the options
|
|
.BR \-d ,
|
|
.BR \-l ,
|
|
.BR \-s ,
|
|
and
|
|
.BR \-w ,
|
|
intersected
|
|
with the union of the revisions selected by
|
|
.B \-b
|
|
and
|
|
.BR \-r .
|
|
.SH EXAMPLES
|
|
.LP
|
|
.nf
|
|
.B " rlog \-L \-R RCS/*"
|
|
.B " rlog \-L \-h RCS/*"
|
|
.B " rlog \-L \-l RCS/*"
|
|
.B " rlog RCS/*"
|
|
.fi
|
|
.LP
|
|
The first command prints the names of all \*r files in the subdirectory
|
|
.B RCS
|
|
that 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 ENVIRONMENT
|
|
.TP
|
|
.B \s-1RCSINIT\s0
|
|
options prepended to the argument list, separated by spaces.
|
|
See
|
|
.BR ci (1)
|
|
for details.
|
|
.SH DIAGNOSTICS
|
|
The exit status is zero if and only if all operations were successful.
|
|
.SH IDENTIFICATION
|
|
Author: Walter F. Tichy.
|
|
.br
|
|
Revision Number: \*(Rv; Release Date: \*(Dt.
|
|
.br
|
|
Copyright \(co 1982, 1988, 1989 by Walter F. Tichy.
|
|
.br
|
|
Copyright \(co 1990, 1991 by Paul Eggert.
|
|
.SH "SEE ALSO"
|
|
ci(1), co(1), ident(1), rcs(1), rcsdiff(1), rcsintro(1), rcsmerge(1),
|
|
rcsfile(5)
|
|
.br
|
|
Walter F. Tichy,
|
|
\*r\*-A System for Version Control,
|
|
.I "Software\*-Practice & Experience"
|
|
.BR 15 ,
|
|
7 (July 1985), 637-654.
|
|
.SH BUGS
|
|
The separator for revision ranges in the
|
|
.B \-r
|
|
option used to be
|
|
.B \-
|
|
instead of
|
|
.BR : ,
|
|
but this leads to confusion when symbolic names contain
|
|
.BR \- .
|
|
For backwards compatibility
|
|
.B "rlog \-r"
|
|
still supports the old
|
|
.B \-
|
|
separator, but it warns about this obsolete use.
|
|
.br
|