home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 3 / goldfish_volume_3.bin / files / dev / misc / hwgrcs / man / rlog.man < prev   
Encoding:
Text File  |  1993-01-19  |  6.5 KB  |  199 lines
  1.  
  2.  
  3.  
  4. RLOG(1)                  USER COMMANDS                    RLOG(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      rlog - print log messages and other  information  about  RCS
  10.      files
  11.  
  12. SYNOPSIS
  13.      rlog [ _o_p_t_i_o_n_s ] _f_i_l_e ...
  14.  
  15. DESCRIPTION
  16.      rlog prints information about RCS files.
  17.  
  18.      Pathnames matching an RCS suffix denote RCS files; all  oth-
  19.      ers  denote working files.  Names are paired as explained in
  20.      ci(1).
  21.  
  22.      rlog prints the following information for each RCS file: RCS
  23.      pathname,  working  pathname,  head (i.e., the number of the
  24.      latest revision on the trunk), default branch, access  list,
  25.      locks,  symbolic  names,  suffix, total number of revisions,
  26.      number of revisions selected for printing,  and  descriptive
  27.      text.   This  is  followed by entries for the selected revi-
  28.      sions in reverse chronological order for each  branch.   For
  29.      each   revision,   rlog   prints  revision  number,  author,
  30.      date/time,  state,  number  of  lines  added/deleted   (with
  31.      respect  to  the  previous revision), locker of the revision
  32.      (if any), and log message.  All times are displayed in Coor-
  33.      dinated  Universal Time (UTC).  Without options, rlog prints
  34.      complete information.  The options below restrict this  out-
  35.      put.
  36.  
  37.      -L  Ignore RCS files that have no locks set.  This  is  con-
  38.          venient in combination with -h, -l, and -R.
  39.  
  40.      -R  Print only the name of the RCS file.  This is convenient
  41.          for translating a working pathname into an RCS pathname.
  42.  
  43.      -h  Print only the RCS  pathname,  working  pathname,  head,
  44.          default  branch, access list, locks, symbolic names, and
  45.          suffix.
  46.  
  47.      -t  Print the same as -h, plus the descriptive text.
  48.  
  49.      -b  Print information about the  revisions  on  the  default
  50.          branch, normally the highest branch on the trunk.
  51.  
  52.      -d_d_a_t_e_s
  53.          Print  information  about  revisions  with   a   checkin
  54.          date/time in the ranges given by the semicolon-separated
  55.          list of _d_a_t_e_s.  A range  of  the  form  _d_1<_d_2  or  _d_2>_d_1
  56.          selects the revisions that were deposited between _d_1 and
  57.          _d_2 inclusive.  A range of the form <_d or _d> selects  all
  58.          revisions dated _d or earlier.  A range of the form _d< or
  59.          >_d selects all revisions dated _d or later.  A  range  of
  60.  
  61.  
  62.  
  63. GNU                  Last change: 1991/08/22                    1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. RLOG(1)                  USER COMMANDS                    RLOG(1)
  71.  
  72.  
  73.  
  74.          the  form  _d selects the single, latest revision dated _d
  75.          or earlier.  The date/time strings _d, _d_1, and _d_2 are  in
  76.          the free format explained in co(1).  Quoting is normally
  77.          necessary, especially  for  <  and  >.   Note  that  the
  78.          separator is a semicolon.
  79.  
  80.      -l[_l_o_c_k_e_r_s]
  81.          Print information about locked revisions only.  In addi-
  82.          tion, if the comma-separated list _l_o_c_k_e_r_s of login names
  83.          is given, ignore all locks other than those held by  the
  84.          _l_o_c_k_e_r_s.  For example, rlog -L -R -lwft RCS/* prints the
  85.          name of RCS files locked by the user wft.
  86.  
  87.      -r[_r_e_v_i_s_i_o_n_s]
  88.          prints information about revisions given in  the  comma-
  89.          separated  list  _r_e_v_i_s_i_o_n_s  of  revisions and ranges.  A
  90.          range _r_e_v_1:_r_e_v_2 means revisions _r_e_v_1 to _r_e_v_2 on the same
  91.          branch,  :_r_e_v  means revisions from the beginning of the
  92.          branch up to and including _r_e_v, and _r_e_v: means revisions
  93.          starting  with  _r_e_v  to the end of the branch containing
  94.          _r_e_v.  An argument that is a branch means  all  revisions
  95.          on that branch.  A range of branches means all revisions
  96.          on the branches in that range.  A branch followed by a .
  97.          means  the  latest  revision  in that branch.  A bare -r
  98.          with no _r_e_v_i_s_i_o_n_s  means  the  latest  revision  on  the
  99.          default branch, normally the trunk.
  100.  
  101.      -s_s_t_a_t_e_s
  102.          prints information about revisions  whose  state  attri-
  103.          butes  match  one  of  the  states  given  in the comma-
  104.          separated list _s_t_a_t_e_s.
  105.  
  106.      -w[_l_o_g_i_n_s]
  107.          prints information about revisions checked in  by  users
  108.          with  login  names appearing in the comma-separated list
  109.          _l_o_g_i_n_s.  If _l_o_g_i_n_s  is  omitted,  the  user's  login  is
  110.          assumed.
  111.  
  112.      -V_n Emulate RCS version _n when generating logs.   See  co(1)
  113.          for more.
  114.  
  115.      -x_s_u_f_f_i_x_e_s
  116.          Use _s_u_f_f_i_x_e_s to characterize RCS files.  See  ci(1)  for
  117.          details.
  118.  
  119.      rlog prints the intersection of the revisions selected  with
  120.      the  options  -d, -l, -s, and -w, intersected with the union
  121.      of the revisions selected by -b and -r.
  122.  
  123. EXAMPLES
  124.          rlog  -L  -R  RCS/*
  125.          rlog  -L  -h  RCS/*
  126.  
  127.  
  128.  
  129. GNU                  Last change: 1991/08/22                    2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. RLOG(1)                  USER COMMANDS                    RLOG(1)
  137.  
  138.  
  139.  
  140.          rlog  -L  -l  RCS/*
  141.          rlog  RCS/*
  142.  
  143.      The first command prints the names of all RCS files  in  the
  144.      subdirectory RCS that have locks.  The second command prints
  145.      the headers of those files, and the third prints the headers
  146.      plus  the  log  messages  of the locked revisions.  The last
  147.      command prints complete information.
  148.  
  149. ENVIRONMENT
  150.      RCSINIT
  151.           options prepended to the argument  list,  separated  by
  152.           spaces.  See ci(1) for details.
  153.  
  154. DIAGNOSTICS
  155.      The exit status is zero if and only if all  operations  were
  156.      successful.
  157.  
  158. IDENTIFICATION
  159.      Author: Walter F. Tichy.
  160.      Revision Number: 5.3; Release Date: 1991/08/22.
  161.      Copyright c 1982, 1988, 1989 by Walter F. Tichy.
  162.      Copyright c 1990, 1991 by Paul Eggert.
  163.  
  164. SEE ALSO
  165.      ci(1), co(1),  ident(1),  rcs(1),  rcsdiff(1),  rcsintro(1),
  166.      rcsmerge(1), rcsfile(5)
  167.      Walter  F.  Tichy,  RCS--A  System  for   Version   Control,
  168.      _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.
  169.  
  170. BUGS
  171.      The separator for revision ranges in the -r option  used  to
  172.      be - instead of :, but this leads to confusion when symbolic
  173.      names contain -.  For backwards compatibility rlog -r  still
  174.      supports  the  old  -  separator,  but  it  warns about this
  175.      obsolete use.
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195. GNU                  Last change: 1991/08/22                    3
  196.  
  197.  
  198.  
  199.