RLOG(1)                    OpenBSD Reference Manual                    RLOG(1)

NAME
     rlog - display information about RCS files

SYNOPSIS
     rlog [-bhLNqRtV] [-ddates] [-l[lockers]] [-r[revs]] [-sstates]
          [-w[logins]] [-xsuffixes] [-ztz] file ...

DESCRIPTION
     The rlog program displays information about RCS files.

     A file's complete RCS history can be displayed (the default if no options
     are specified) or a subset of its history log can be requested, depending
     on which options are specified.  RCS keywords are displayed using the
     ident(1) utility.

     The following options are supported:

     -b      Print information about revisions of the default branch only.

     -ddates
             Specify revisions with dates matching the specification.  The
             specification might be as follows:

             D1>D2 or D2>D1
                     Select all revisions between D1 and D2.

             <D or D>
                     Select all revisions before D.

             >D or D<
                     Select all revisions after D.

             D       Select the latest revision before or equal to D.

             The `>' and `<' characters can be followed by the `=' character
             to imply an inclusive specification.  Several specifications can
             be used by separating them with the `;' character.

             See also the -z option, below.

     -h      Print the RCS header, describing a file's branch, lock details,
             symbolic names, etc.

     -L      Ignore RCS files with no locks set.

     -l[lockers]
             Print information about locked revisions only.  If a comma-sepa-
             rated list of login names is specified, ignore all locks other
             than those held in the list.

     -N      Do not print symbolic names.

     -q      Be quiet about reporting.

     -R      Print name of RCS file only.

     -r[revs]
             Specify revision(s) to list:

             REV1,REV2,...,
                     A list of revisions is specified by separating names or
                     numbers of revisions by the `,' character.

             REV1:REV2
                     List all revisions between REV1 and REV2 (they must be on
                     the same branch).

             :REV    List all revisions since the beginning of the branch un-
                     til REV included.

             REV:    List all revisions of the branch beginning with REV.

             BRANCH  List all revisions of a branch.

             BRANCH.
                     List the latest revision of the branch BRANCH.

             BRANCH1:BRANCH2
                     List all revisions of branches between BRANCH1 and
                     BRANCH2.

             Without argument, the -r option means the latest revision of the
             default branch.

     -sstates
             Print information about revisions whose state matches one of the
             specified states.  Multiple states may be specified as a comma-
             separated list.

     -t      Print header and description only.

     -V      Print RCS's version number.

     -w[logins]
             Print information about revisions checked in by users specified
             in a comma-separated list.  If logins is omitted, the user's lo-
             gin is assumed.

     -xsuffixes
             Specifies the suffixes for RCS files.  Suffixes should be sepa-
             rated by the `/' character.

     -ztz    Specify the date output format.  The tz argument should be a nu-
             meric UTC offset (e.g. +02:45 would specify an offset of 2 hours
             45 minutes).  `LT' may instead be used to specify local time.  If
             no argument is given, a default format is used.  This option is
             also used to set the default time zone for dates used in the -d
             option.

     The rlog utility exits 0 on success, and >0 if an error occurs.

ENVIRONMENT
     RCSINIT  If set, this variable should contain a list of space-delimited
              options that are prepended to the argument list.

EXAMPLES
     Print complete information about files:

           $ rlog RCS/*

     Print the names of RCS files with locks set:

           $ rlog -L -R RCS/*

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

STANDARDS
     The flag [-T] has no effect and is provided for compatibility only.

OpenBSD 4.0                    October 12, 2005                              2
