

RLOG(1)                    Unix Programmer's Manual                    RLOG(1)


NNNAAAMMMEEE
     rlog - print log messages and other information about RCS files

SSSYYYNNNOOOPPPSSSIIISSS
     rrrllloooggg [ _o_p_t_i_o_n_s ] _f_i_l_e ...

DDDEEESSSCCCRRRIIIPPPTTTIIIOOONNN
     rrrllloooggg prints information about RCS files.  File names ending in ,,,vvv  denote
     RCS  files; all others denote working files.  If a working file is given,
     rrrllloooggg  tries  to  find  the  corresponding  RCS  file  first  in  an   RCS
     subdirectory  and  then  in the working file's directory, as explained in
     cccooo(1).

     rrrllloooggg 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 revisions
     in  reverse chronological order for each branch.  For each revision, rrrllloooggg
     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,  rrrllloooggg  prints  complete information.  The options below
     restrict this output.

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

     ---R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hh               Print only the RCS file name, working file  name,  head,
                      default  branch, access list, locks, symbolic names, and
                      suffix.

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

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

     ---dd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
                      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 cccooo(1).  Quoting is normally
                      necessary, especially  for  <<<  and  >>>.   Note  that  the
                      separator is a semicolon.





                                    \*(Dt                                    1



RLOG(1)                    Unix Programmer's Manual                    RLOG(1)


     ---lll[lockers]]]      Print  information  about  locked  revisions  only.   In
                      addition,  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,  rrrllloooggg\\\  ---LLL\\\ ---RRR\\\ ---lllwwwfffttt\\\
                      RRRCCCSSS///***,,,vvv prints the name of RCS files locked by the  user
                      wwwfffttt.

     ---rr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s_s_t_a_t_e_s         prints   information   about   revisions   whose   state
                      attributes  match  one of the states given in the comma-
                      separated list _s_t_a_t_e_s.

     ---www[logins]]]       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VV_n              Emulate RCS version _n when generating logs.   See  cccooo(1)
                      for more.

     rrrllloooggg prints the intersection of the revisions selected with  the  options
     ---ddd,  ---lll, ---sss, and ---www, intersected with the union of the revisions selected
     by ---bbb and ---rrr.

EEEXXXAAAMMMPPPLLLEEESSS

         rrrllloooggg  ---LLL  ---RRR  RRRCCCSSS///***,,,vvv
         rrrllloooggg  ---LLL  ---hhh  RRRCCCSSS///***,,,vvv
         rrrllloooggg  ---LLL  ---lll  RRRCCCSSS///***,,,vvv
         rrrllloooggg  RRRCCCSSS///***,,,vvv

     The first command prints the names of all RCS files in  the  subdirectory
     RRRCCCSSS  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.

DDDIIIAAAGGGNNNOOOSSSTTTIIICCCSSS
     The exit status is zero if and only if all operations were successful.

IIIDDDEEENNNTTTIIIFFFIIICCCAAATTTIIIOOONNN
     Author: Walter F. Tichy.
     Revision Number: 5.0; Release Date: 1990/08/22.
     Copyright (c) 1982, 1988, 1989 by Walter F. Tichy.
     Copyright (c) 1990 by Paul Eggert.





                                    \*(Dt                                    2



RLOG(1)                    Unix Programmer's Manual                    RLOG(1)


SSSEEEEEE AAALLLSSSOOO
     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 111555, 7 (July 1985), 637-654.





















































                                    \*(Dt                                    3

