`rlog`

Print log messages and other info about RCS files (UNIX)

Syntax:

rlog [options] file...

The rlog utility does not follow the standard utility syntax conventions. Options and their arguments may not be separated by white space, and options may not be combined in single command line arguments (i.e. multiple options must be separated by spaces in the command line).

-b

Print information about the revisions on the default branch, normally the highest branch on the trunk.

-ddates

Print information about revisions with a checkin date/time in the ranges given by the semicolon-separated list dates.

A range of the form:	Selects:
d1`<`d2 or d2`>`d1	the revisions that were deposited between d1 and d2, excluding d1 and d2.
d1`<=`d2 or d2`>=`d1	the revisions that were deposited between d1 and d2, inclusive of d1 and d2.
`<`d or d`>`	all revisions earlier than d
`<=`d or d`>=`	all revisions dated d or earlier
d`<` or `>`d	all revisions dated later than d
d`<=` or `>=`d	all revisions dated d or later
d	the single, latest revision dated d or earlier

The date/time strings d, d1, and d2 are in the free format explained in co. Quoting is normally necessary, especially for < and >.

-h

Print only the RCS filename, working filename, head, default branch, locks, access list, symbolic names, keyword substitutions and total revisions.

-l[lockers]

("el") Print information about locked revisions only. If lockers, a comma-separated list of login names, is given, ignore all locks other than those held by the named lockers. For example, this command:

    rlog -L -R -lwft RCS/*,v

prints the name of RCS files locked by the user wft.

-L

Ignore RCS files that have no locks set. This is useful in combination with options -R, -h, and -l.

-N

Do not print symbolic names.

-t

Act as if -h were specified, but also print the descriptive text.

-rrevisions

Print information about revisions given in the comma-separated list revisions of revisions and ranges. For more information, see the Description, below.

-R

Print only the name of the RCS file. This is useful for translating a working filename into an RCS filename.

-sstates

Print information about revisions whose state attributes match one of the states given in the comma-separated list states.

-T

This option has no effect; it is present for compatibility with other RCS commands.

-w[logins]

Print information about revisions checked in by users with login names appearing in the comma-separated list logins. If logins is omitted, the user's login is assumed.

-V[n]

Report RCS version; or, if a number is supplied immediately after -V (no spaces), emulate RCS version n when generating logs, where n may be 3, 4, or 5. This option can be useful when you're interchanging RCS files with other users who are running older versions of RCS (see also "Determining RCS version" in co).

-xsuffixes

Use suffixes to characterize RCS files. See ci for details.

-zzone

specifies the date output format, and specifies the default time zone for dates in the -ddates option. The zone should be empty, a numeric UTC offset, or the special string LT for local time. The default is an empty zone, which uses the traditional RCS format of UTC without any time zone indication and with slashes separating the parts of the date; otherwise, times are output in ISO 8601 format with time zone indication.

Description:

The rlog utility prints information about RCS files. Filenames ending in ,v denote RCS files; all others are assumed to be working files. If a working file is given, rlog tries to find the corresponding RCS file first in an RCS subdirectory and then in the working file's directory, as explained in co.

The rlog utility prints the following information for each RCS file:

RCS filename
working filename
head (i.e., the number of the latest revision on the trunk)
default branch
locks
access list
symbolic names
suffix
total number of revisions
number of revisions selected for printing
descriptive text

This information is followed by entries for the selected revisions in reverse chronological order for each branch. For each revision, rlog prints:

revision number
date/time
author
state
number of lines added/deleted with respect to the previous revision
locker of the revision (if any)
log message

All times are displayed in UTC. Without options, rlog prints complete information. Options restrict this output.

The rlog utility prints the intersection of the revisions selected with the options -d, -l, -s, and -w, intersected with the union of the revisions selected by -b and -r.

When using the -rrevisions option, note that the following rules apply to the revisions argument:

If you specify:	Then `rlog` prints info about:
a range rev1`:`rev2	revisions rev1 to rev2 on the same branch
`:`rev	revisions from the beginning of the branch up to and including rev
rev`:`	revisions starting with rev to the end of the branch containing rev
a branch	all revisions on that branch
a range of branches	all revisions on the branches in that range

Examples:

The first of the following commands prints the names of all RCS files in the subdirectory RCS that have locks. The second command prints the headers of those files, while the third prints the headers plus the log messages of the locked revisions. The last command prints complete information.

    rlog -L -R RCS/*,v
    rlog -L -h RCS/*,v
    rlog -L -l RCS/*,v
    rlog RCS/*,v

Exit status:

0: Successful completion.
>0: An error occurred.

The exit status is zero only if all operations were successful.

Contributing author:

GNU