


RLOG(1)                  USER COMMANDS                    RLOG(1)



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

SYNOPSIS
     rlog [ _o_p_t_i_o_n_s ] _f_i_l_e ...

DESCRIPTION
     rlog prints information about RCS files.  File names  ending
     in ,v denote RCS files; all others denote working files.  If
     a working file is given, rlog tries to find the  correspond-
     ing  RCS  file  first in an RCS subdirectory and then in the
     working file's directory, as explained in co(1).

     rlog prints the following information for each RCS file: RCS
     file  name, working file name, 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  GMT.
     Without  options,  rlog  prints  complete  information.  The
     options below restrict this output.

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

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

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

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

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

     -d_d_a_t_e_s
         Print  information  about  revisions  with   a   checkin
         date/time in the ranges given by the semicolon-separated
         list of _d_a_t_e_s.  A range  of  the  form  _d_1<_d_2  or  _d_2>_d_1
         selects the revisions that were deposited between _d_1 and
         _d_2 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



GNU                  Last change: 1990/08/22                    1






RLOG(1)                  USER COMMANDS                    RLOG(1)



         the  form  _d selects the single, latest revision dated _d
         or earlier.  The date/time strings _d, _d_1, and _d_2 are  in
         the free format explained in co(1).  Quoting is normally
         necessary, especially  for  <  and  >.   Note  that  the
         separator is a semicolon.

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

     -r_r_e_v_i_s_i_o_n_s
         prints information about revisions given in  the  comma-
         separated  list  _r_e_v_i_s_i_o_n_s  of  revisions and ranges.  A
         range _r_e_v_1-_r_e_v_2 means revisions _r_e_v_1 to _r_e_v_2 on the same
         branch,  -_r_e_v  means revisions from the beginning of the
         branch up to and including _r_e_v, and _r_e_v- means revisions
         starting  with  _r_e_v  to the end of the branch containing
         _r_e_v.  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.

     -s_s_t_a_t_e_s
         prints information about revisions  whose  state  attri-
         butes  match  one  of  the  states  given  in the comma-
         separated list _s_t_a_t_e_s.

     -w[_l_o_g_i_n_s]
         prints information about revisions checked in  by  users
         with  login  names appearing in the comma-separated list
         _l_o_g_i_n_s.  If _l_o_g_i_n_s  is  omitted,  the  user's  login  is
         assumed.

     -V_n Emulate RCS version _n when generating logs.   See  co(1)
         for more.

     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.

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

     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



GNU                  Last change: 1990/08/22                    2






RLOG(1)                  USER COMMANDS                    RLOG(1)



     command prints complete information.

DIAGNOSTICS
     The exit status is zero if and only if all  operations  were
     successful.

IDENTIFICATION
     Author: Walter F. Tichy.
     Revision Number: 5.0; Release Date: 1990/08/22.
     Copyright 8c9 1982, 1988, 1989 by Walter F. Tichy.
     Copyright 8c9 1990 by Paul Eggert.

SEE ALSO
     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,
     _S_o_f_t_w_a_r_e--_P_r_a_c_t_i_c_e & _E_x_p_e_r_i_e_n_c_e 15, 7 (July 1985), 637-654.






































GNU                  Last change: 1990/08/22                    3



