rlog(1)                                                   rlog(1)



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

SYNOPSIS
     rlog [-ddates] [-h] [-l[lockers]] [-L] [-rrevisions] [-R]
     [-sstates] [-t] [-w[logins]] file...

ARGUMENTS
     -ddates
          Prints information about revisions with a checkin date
          and 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 and time
          strings d, d1, and d2 are in the free format explained
          in co(1).  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
          comma-separated list lockers of login names is given,
          only the revisions locked by the given login names are
          displayed.  If the list is omitted, all locked
          revisions are displayed.

     -L   Ignores RCS files that have no locks set; convenient in
          combination with -R, -h, or -l.

     -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.

     -R   Prints only the name of the RCS file; convenient for
          translating a working filename into an RCS filename.

     -sstates]
          Prints information about revisions whose state



January 1992                                                    1

rlog(1)                                                   rlog(1)



          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 login names appearing in the comma-separated list
          logins.  If logins is omitted, the user's login is
          assumed.

     file...
          Specifies the RCS files for which you want the log
          messages and other information.

DESCRIPTION
     rlog displays 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(1).

     The rlog program displays the following information for each
     RCS file: RCS filename, working filename, head (that is, the
     number of the latest revision on the trunk), access list,
     locks, symbolic names, suffix, total number of revisions,
     number of revisions selected for display, and descriptive
     text.  This is followed by entries for the selected
     revisions in reverse chronological order for each branch.
     For each revision, rlog displays revision number, author,
     date and time, state, number of lines added or deleted (with
     respect to the previous revision), locker of the revision
     (if any), and log message.  Without options, rlog displays
     complete information; the options restrict this output.

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

EXAMPLES
     The following are some examples of using rlog.

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

     The first command displays the names of all RCS files in the
     subdirectory RCS which have locks.  The second command
     displays the headers of those files, and the third displays
     the headers plus the log messages of the locked revisions.



2                                                    January 1992

rlog(1)                                                   rlog(1)



     The last command displays complete information.

STATUS MESSAGES AND VALUES
     The exit status always refers to the last RCS file operated
     upon, and is 0 if the operation was successful, 1 if
     otherwise.

NOTES
     This reference manual entry describes a utility that Apple
     understands to have been released into the public domain by
     its author or authors.  Apple has included this public
     domain utility for your convenience.  Use it at your own
     discretion.  Often the source code can be obtained if
     additional requirements are met, such as the purchase of a
     site license from an author or institution.

     Author: Walter F. Tichy, Purdue University, West Lafayette,
     IN 47907.
               c
     Copyright   1982 by Walter F. Tichy.

SEE ALSO
     ci(1), co(1), ident(1), rcs(1), rcsdiff(1), rcsintro(1),
     rcsmerge(1)

     sccstorcs(1M) in A/UX System Administrator's Reference

     rcsfile(4) in A/UX Programmer's Reference

     Walter F. Tichy, ``Design, Implementation, and Evaluation of
     a Revision Control System,'' in Proceedings of the 6th
     International Conference on Software Engineering, IEEE,
     Tokyo, Sept. 1982























January 1992                                                    3