*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->OpenBSD man pages -> rlog (1)              



NAME    [Toc]    [Back]

       rlog  - print log messages and other information about RCS

SYNOPSIS    [Toc]    [Back]

       rlog [ options ] file ...

DESCRIPTION    [Toc]    [Back]

       rlog prints information about RCS files.

       Pathnames matching an RCS suffix  denote  RCS  files;  all
       others   denote   working  files.   Names  are  paired  as
       explained in ci(1).

       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 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.  All  times  are  displayed
  in  Coordinated  Universal  Time (UTC) by default;
       this can be overridden 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 convenient
 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

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

       -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 exclusive.  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
           addition, 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 commaseparated
 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

           prints   information   about   revisions  whose  state
           attributes match one of the states given in the commaseparated
 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  compatibility
 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.

       -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 UTC offset, or
              the special 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 separating the parts of the date; otherwise,
 times are output 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

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

EXAMPLES    [Toc]    [Back]

           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.

ENVIRONMENT    [Toc]    [Back]

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

DIAGNOSTICS    [Toc]    [Back]

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

IDENTIFICATION    [Toc]    [Back]

       Author: Walter F. Tichy.
       Manual Page Revision: 1.1; Release Date: 1996/08/12.
       Copyright (C) 1982, 1988, 1989 Walter F. Tichy.
       Copyright (C) 1990, 1991,  1992,  1993,  1994,  1995  Paul

SEE ALSO    [Toc]    [Back]

       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),

BUGS    [Toc]    [Back]

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

GNU                         1996/08/12                          4
[ Back ]
 Similar pages
Name OS Title
rlog HP-UX print log messages and other information on RCS files
amsyslog IRIX parse system log files and print critical messages
pod2usage OpenBSD print usage messages from embedded pod docs in files
pod2usage Linux print usage messages from embedded pod docs in files
istat IRIX print the header information of a list of image files.
ERR_print_errors OpenBSD print error messages
ERR_print_errors NetBSD print error messages
ERR_print_errors Tru64 Print error messages
ERR_print_errors_fp Tru64 Print error messages
ERR_print_errors_fp OpenBSD print error messages
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service