NAME

      rcsinfo - Provide information about RCS library.


SYNOPSIS

      rcsinfo [options] [files]


DESCRIPTION

      The command rcsinfo displays different information about files placed
      in the RCS directory.
      In general, the following format of the printout is defined, one line
      per file version:

      filename version State: status Author: author Name: names Locked by:
      Locker

      "Name: names" is a whitespace-separated list of symbolic version
      names. It appears only if there are any symbolic names for the file
      version.

      "Locked by: Locker" appears only if the file version is locked.

      Several options may be used to get different output format. See
      options -c, -T, -D and -C.

    PARAMETERS
      files
           Specifies which files should be looked for. You may specify
           working file names, or versioned file names, i.e. "file" or
           "RCS/file,v".
           If no parameter is specified then the RCS directory in the
           current directory is processed.
           If you specify a directory (only one parameter) then the RCS
           directory placed under that directory will be processed.

    OPTIONS
      The following options are applied as search keys on each file, version
      and limit the resulting output; only data for matching file,version
      pairs are displayed:

      -r[versions]
           Prints information about file versions given in the comma-
           separated list versions of versions and ranges. A range rev1:rev2
           means versions rev1 to rev2 on the same branch, :rev means
           versions from the beginning of the branch up to and including
           rev, and rev: means versions starting with rev to the end of the
           branch containing rev. An argument that is a branch means all
           versions on that branch. A range of branches means all versions
           on the branches in that range. A branch followed by a . means the
           latest versions in that branch. A bare -r with no versions means
           the latest version on the default branch, normally the trunk.

      -nr[versions]
           Prints information about file versions that are not given in the
           comma-separated list versions of versions and ranges. See -r for
           a description of the list.  -nr can be combined with -r to for
           example look at the latest version of files which do not have the
           versions (e.g. symbolic name) specified with -nr.

      -l[lockers]
           Print information about locked file versions.  In addition, if
           the comma-separated list lockers of login names is given, ignore
           all locks other than those held by the lockers.

      -sstates
           Print information about file versions whose state is equal to one
           of the states given in the comma-separated list states. It cannot
           be combined with the -ns option.

      -nsstates
           Print information about file versions whose state is not equal to
           one of the states given in the comma-separated list states. It
           cannot be combined with the -s option.

      -w[logins]
           Print information about file versions checked in by users with
           login names appearing in the comma-separated list logins. If
           logins is omitted, the user's login is assumed.

      -ddates
           Print information about file versions 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 versions that were
           deposited between d1 and d2 exclusive. A range of the form <d or
           d> selects all versions earlier than d. A range of the form d <
           or >d selects all versions dated later than d. If < or > is
           followed by = then the ranges are inclusive, not exclusive. A
           range of the form d selects the single, latest version 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.

      -b   Print information about versions of the default branch.

      rcsinfo prints the intersection of the file versions selected with the
      options -r, -nr, -l, -s, -ns, -w, -d, and -b, with the exception that
      -r, -nr and -b will first form a union that will then be intersected
      with the other selections.

      The following options change the way in which the files are selected:

      -x suffixes
           Select files in the same way as in checkout or in co command.

      The following options define the output format:

      -T[VSADLNC]
           Defines the column output format. The following option keywords
           are defined:
           V List Version Number
           S List State
           A List Author
           D List Version Date
           L List Locker's Name (L:userid)
           N List Symbolic Name (if defined)
           C List Title Description
           Any combination of these keys may be used. If the -T option is
           specified with no key, then only file names are listed (once for
           each version).
           Note that the C keyword should be used only when one version of
           files are displayed (for example when the option -r is defined)
           and when descriptions are one line long. Otherwise unpredictable
           displays may occur.  When printing several versions of a file,
           use -C option instead.

      -c   This option is the same as the combination -TSVAN.

      -C   Writes the file description title after the list of versions. The
           description is displayed in a separate line.

      -D   Instead of the ordinary output, print the description of each
           file.
           -D cannot be combined with -r, or -nr.

      -R   Lists versioned filenames placed in the RCS directory.

      -P   Option used for internal purposes. Writes full pathname of the
           files. The path specification corresponds to input path
           specification (i.e if no path is specified in the RCS command,
           only filenames will be presented. If the full path is specified
           for the RCS directory, then the full pathname is listed).

      -zzone
           Specifies the date output format, and specifies the default time
           zone for date in the -ddates option.  The zone should be empty, a
           numeric  offset, or the special string LT for local time. The
           default is an empty zone, which uses the traditional  format of
           without any time zone indication and with slashes separating the
           parts of the date; otherwise, times are output in  8601 format
           with time zone indication.  For example, if local time is January
           11, 1990, 8pm Pacific Standard Time, eight hours west of , 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


EXAMPLES

      $ rcsinfo -rR1_1_0

      prints all the files that have symbolic names R1_1_0.

      $ rcsinfo -nsStable,Unchanged,Rel,Obsolete -r

      prints all the files which latest version do not have the state
      Stable, Unchanged, Rel, or Obsolete.


SEE ALSO

      s_rcsinfo(1), rlog(1)


AUTHOR

      Ivica Crnkovic, Stefan Frennemo