RLOG(1RCS)              COMMAND REFERENCE              RLOG(1RCS)



NAME
     rlog - print log messages and other information about RCS
     files

SYNOPSIS
     rlog [ -thc ] [ -L[lockers] ] [ -R ] [ -ddates ] [
     -l[lockers] ] [ -rrevisions ]
     [ -sstates ] [ -w[logins] ] filename...

DESCRIPTION
     Rlog prints information about RCS files.  Files ending in ,v
     are RCS files; all others are working files. If a working
     file is given, rlog tries to find the corresponding RCS file
     first in directory ./RCS and then in the current directory,
     as explained in co(1rcs).

     Rlog with no options prints the following information for
     each RCS file: full pathname of the RCS file, working
     filename, head (for example, the number of the latest
     revision on the trunk), 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 revisions in reverse chronological
     order for each branch. For each revision, 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.

OPTIONS
     -c Prints only the head (current revision number) of the
        named files.  This option is overridden by the -h and -t
        options.

     -ddates
        Prints information about revisions with a checkin
        date/time in the ranges given by the semicolon-separated
        list of dates.  A range of the form d1<d2 or d2>d1
        selects the revisions that were deposited between d1 and
        d2, (inclusive).  A range of the form <d or d> selects
        all revisions dated d or earlier.  A range of the form d<
        or >d selects all revisions dated d or later.  A range of
        the form d selects the single, latest revision dated d or
        earlier.  The date/time strings d, d1, and d2 are in the
        free format explained in co(1rcs).  Quoting is normally
        necessary, especially for < and >. Note that the
        separator is a semicolon.

     -h Prints only RCS filename, working filename, head, access
        list, locks, symbolic names, and suffix.

     -l[lockers]
        Prints information about locked revisions.  If the



Printed 4/6/89                                                  1

RLOG(1RCS)              COMMAND REFERENCE              RLOG(1RCS)



        comma-separated list lockers of loginnames is given, only
        the revisions locked by the given loginnames are printed.
        If the list is omitted, all locked revisions are printed.

     -rrevisions
        Prints information about revisions given in the comma-
        separated list revisions of revisions and ranges. A range
        rev1-rev2 means revisions rev1 to rev2 on the same
        branch, -rev means revisions from the beginning of the
        branch up to and including rev, and rev- means revisions
        starting with rev to the end of the branch containing
        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.

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

     -t Prints the same as -h, plus the descriptive text.

     -w[logins]
        Prints information about revisions checked in by users
        with loginnames appearing in the comma-separated list
        logins.  If logins is omitted, the user's login is
        assumed.

     -L[lockers]
        Print information only for files without strict locking
        and no locked revisions.  If the comma-separated list
        lockers of loginnames is given, the file is only chosen
        if it has revisions locked by one or more of the given
        names.

     -R Print only the pathname of the RCS file.

     Combinations of the options -d, -l, -r, -s, and -w print the
     intersection of the revisions selected by each option.  For
     these options, rlog also prints the information provided by
     -t.

EXAMPLES
     The following input prints information about all revisions
     of the file example.c between revisions 1.3 and 1.8 which
     are currently locked:

          rlog -r1.3-1.8 -l example.c

     This next example shows a use for the -c flag. This command
     forces the current revision of the file example.c to be
     unlocked. This is useful if someone else has the revision



Printed 4/6/89                                                  2

RLOG(1RCS)              COMMAND REFERENCE              RLOG(1RCS)



     locked.

          rcs -u`rlog -c example.c` example.c


RETURN VALUE
     [NO_ERRS]      Command completed without error.

     [NP_ERR]       An error occurred that was not a system
                    error.  Execution terminated.

CAVEATS
     The maximum number of revisions that can be stored in a
     single RCS file is 719. When there are more than 700
     revisions in a file, a warning message is printed on the
     terminal (if possible) every time an RCS command works on
     the file. See the manual page for rcsfile(5rcs) for
     information on what action to take in this case.

     On older versions of RCS, the maximum number of revisions
     that can be stored in a single RCS file is 239.  No warning
     message is displayed on the terminal if this number is
     exceeded.

SEE ALSO
     ci(1rcs), co(1rcs), ident(1rcs), rcs(1rcs), rcsdiff(1rcs),
     rcsintro(1rcs), rcsmerge(1rcs), and rcsfile(5rcs).




























Printed 4/6/89                                                  3

%%index%%
na:312,120;
sy:432,542;
de:974,1261;
op:2235,1372;3991,2252;
ex:6243,524;7151,62;
rv:7213,288;
ca:7501,660;
se:8161,372;
%%index%%000000000154