313 lines
6.7 KiB
Groff
313 lines
6.7 KiB
Groff
.de Id
|
|
.ds Rv \\$3
|
|
.ds Dt \\$4
|
|
..
|
|
.Id $Id: rlog.1,v 1.3 1995/02/24 02:25:42 mycroft Exp $
|
|
.ds i \&\s-1ISO\s0
|
|
.ds r \&\s-1RCS\s0
|
|
.ds u \&\s-1UTC\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 (\*u) by default;
|
|
this can be overridden with
|
|
.BR \-z .
|
|
Without options,
|
|
.B rlog
|
|
prints complete information.
|
|
The options below restrict this output.
|
|
.nr n \w'\f3\-V\fP\f2n\fP'+2n-1/1n
|
|
.ds n \nn
|
|
.if \n(.g .if r an-tag-sep .ds n \w'\f3\-V\fP\f2n\fP'u+\n[an-tag-sep]u
|
|
.TP \*n
|
|
.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 \-N
|
|
Do not print the symbolic names.
|
|
.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
|
|
exclusive.
|
|
A range of the form
|
|
.BI < d
|
|
or
|
|
.IB d >
|
|
selects
|
|
all revisions earlier than
|
|
.IR d .
|
|
A range of the form
|
|
.IB d <
|
|
or
|
|
.BI > d
|
|
selects
|
|
all revisions dated later than
|
|
.IR d .
|
|
If
|
|
.B <
|
|
or
|
|
.B >
|
|
is followed by
|
|
.B =
|
|
then the ranges are inclusive, not exclusive.
|
|
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
|
|
.B \-T
|
|
This option has no effect;
|
|
it is present for compatibility with other \*r commands.
|
|
.TP
|
|
.BI \-V
|
|
Print \*r's version number.
|
|
.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 .
|
|
.TP
|
|
.BI \-z zone
|
|
specifies the date output format,
|
|
and specifies the default time zone for
|
|
.I date
|
|
in the
|
|
.BI \-d dates
|
|
option.
|
|
The
|
|
.I zone
|
|
should be empty, a numeric \*u offset, or the special string
|
|
.B LT
|
|
for local time.
|
|
The default is an empty
|
|
.IR zone ,
|
|
which uses the traditional \*r format of \*u without any time zone indication
|
|
and with slashes separating the parts of the date;
|
|
otherwise, times are output in \*i 8601 format with time zone indication.
|
|
For example, if local time is January 11, 1990, 8pm Pacific Standard Time,
|
|
eight hours west of \*u,
|
|
then the time is output as
|
|
.B "1990/01/11 04:00:00"
|
|
with
|
|
.BR \-z ,
|
|
as
|
|
.B "1990-01-11 20:00:00\-0800"
|
|
with
|
|
.BR \-zLT ,
|
|
and as
|
|
.B "1990-01-11 09:30:00+0530"
|
|
with
|
|
.BR \-z+0530 .
|
|
.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
|
|
Manual Page Revision: \*(Rv; Release Date: \*(Dt.
|
|
.br
|
|
Copyright \(co 1982, 1988, 1989 Walter F. Tichy.
|
|
.br
|
|
Copyright \(co 1990, 1991, 1992, 1993, 1994 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
|