RLOG(1)                   USER COMMANDS                   RLOG(1)

     rlog  -  print  log messages and other information about RCS

     rlog [ options ] file ...

     rlog prints information about RCS files.

     Pathnames matching an RCS suffix denote RCS files; all  oth­
     ers  denote working files.  Names are paired as explained in

     rlog prints the following information for each RCS file: RCS
     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 revi­
     sions 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.  All times are displayed in Coor­
     dinated  Universal  Time (UTC) by default; this can be over­
     ridden with  -z.   Without  options,  rlog  prints  complete
     information.  The options below restrict this output.

     -L  Ignore RCS files that have no locks set.  This is conve­
         nient in combination with -h, -l, and -R.

     -R  Print only the name of the RCS file.  This is convenient
         for translating a working pathname into an RCS pathname.

     -h  Print only the RCS  pathname,  working  pathname,  head,
         default  branch, access list, locks, symbolic names, and

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

     -N  Do not print the symbolic names.

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

         Print   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  exclusive.  A range of the form <d or d> selects all
         revisions earlier than d.  A range of the form d< or  >d
         selects  all revisions dated later than d.  If < or > is
         followed by = then the ranges are inclusive, not  exclu­
         sive.   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(1).
         Quoting is normally necessary, especially for <  and  >.
         Note that the separator is a semicolon.

         Print information about locked revisions only.  In addi­
         tion, if the comma-separated list lockers of login names
         is  given, ignore all locks other than those held by the
         lockers.  For example, rlog -L -R -lwft RCS/* prints the
         name of RCS files locked by the user wft.

         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.  A branch followed by a .
         means the latest revision in that  branch.   A  bare  -r
         with  no  revisions  means  the  latest  revision on the
         default branch, normally the trunk.

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

         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

     -T  This option has no effect; it is present for compatibil­
         ity with other RCS commands.

     -V  Print RCS's version number.

     -Vn Emulate RCS version n when generating logs.   See  co(1)
         for more.

         Use  suffixes  to characterize RCS files.  See ci(1) for

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

          specifies the date output  format,  and  specifies  the
          default  time zone for date in the -ddates option.  The
          zone should be empty, a numeric UTC offset, or the spe­
          cial 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 sepa­
          rating the parts of the date; otherwise, times are out­
          put  in ISO 8601 format with time zone indication.  For
          example, if local time is January 11, 1990, 8pm Pacific
          Standard  Time,  eight hours west of UTC, then the time
          is output as follows:

               option    time output
               -z        1990/01/12 04:00:00        (default)
               -zLT      1990-01-11 20:00:00-08
               -z+05:30  1990-01-12 09:30:00+05:30

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

     The first command prints the names of all RCS files  in  the
     subdirectory 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.

          options prepended to the argument  list,  separated  by
          spaces.  See ci(1) for details.

     The  exit  status is zero if and only if all operations were

     Author: Walter F. Tichy.
     Manual Page Revision: 5.9; Release Date: 1995/06/16.
     Copyright © 1982, 1988, 1989 Walter F. Tichy.
     Copyright © 1990, 1991, 1992, 1993, 1994, 1995 Paul  Eggert.

     ci(1),  co(1),  ident(1),  rcs(1),  rcsdiff(1), rcsintro(1),
     rcsmerge(1), rcsfile(5)
     Walter  F.  Tichy,  RCS--A  System  for   Version   Control,
     Software--Practice  & Experience 15, 7 (July 1985), 637-654.

     The separator for revision ranges in the -r option  used  to
     be - instead of :, but this leads to confusion when symbolic
     names contain -.  For backwards compatibility rlog -r  still
     supports  the old - separator, but it warns about this obso­
     lete use.

GNU                  Last change: 1995/06/16                    1