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 10/17/86                                                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




Printed 10/17/86                                                2

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



     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
     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), rcsfile(5rcs).























Printed 10/17/86                                                3

%%index%%
na:72,104;
sy:176,422;
de:598,1153;
op:1751,1314;3209,2165;
ex:5374,269;5787,281;
rv:6068,244;
ca:6312,632;
se:6944,335;
%%index%%000000000154