home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 8 / CDASC08.ISO / VRAC / RCSDOC.ZIP / RLOG.TXT < prev   
Text File  |  1991-11-10  |  8KB  |  196 lines
  1.  
  2.  
  3. RLOG(1)                    Unix Programmer's Manual                    RLOG(1)
  4.  
  5.  
  6. NNNAAAMMMEEE
  7.      rlog - print log messages and other information about RCS files
  8.  
  9. SSSYYYNNNOOOPPPSSSIIISSS
  10.      rrrllloooggg [ _o_p_t_i_o_n_s ] _f_i_l_e ...
  11.  
  12. DDDEEESSSCCCRRRIIIPPPTTTIIIOOONNN
  13.      rrrllloooggg prints information about RCS files.  File names ending in ,,,vvv  denote
  14.      RCS  files; all others denote working files.  If a working file is given,
  15.      rrrllloooggg  tries  to  find  the  corresponding  RCS  file  first  in  an   RCS
  16.      subdirectory  and  then  in the working file's directory, as explained in
  17.      cccooo(1).
  18.  
  19.      rrrllloooggg prints the following information for each RCS file: RCS  file  name,
  20.      working  file  name, head (i.e., the number of the latest revision on the
  21.      trunk), default branch, access list, locks, symbolic names, suffix, total
  22.      number  of  revisions,  number  of  revisions  selected for printing, and
  23.      descriptive text.  This is followed by entries for the selected revisions
  24.      in  reverse chronological order for each branch.  For each revision, rrrllloooggg
  25.      prints  revision  number,  author,  date/time,  state,  number  of  lines
  26.      added/deleted  (with  respect  to  the  previous revision), locker of the
  27.      revision (if any), and log message.  All  times  are  displayed  in  GMT.
  28.      Without  options,  rrrllloooggg  prints  complete information.  The options below
  29.      restrict this output.
  30.  
  31.      ---LLL               Ignore RCS files  that  have  no  locks  set.   This  is
  32.                       convenient in combination with ---hhh, ---lll, and ---RRR.
  33.  
  34.      ---RRR               Print only the name of the RCS file.  This is convenient
  35.                       for  translating  a  working  file name into an RCS file
  36.                       name.
  37.  
  38.      ---hhh               Print only the RCS file name, working file  name,  head,
  39.                       default  branch, access list, locks, symbolic names, and
  40.                       suffix.
  41.  
  42.      ---ttt               Print the same as ---hhh, plus the descriptive text.
  43.  
  44.      ---bbb               Print information about the  revisions  on  the  default
  45.                       branch, normally the highest branch on the trunk.
  46.  
  47.      ---ddd_d_a_t_e_s          Print  information  about  revisions  with   a   checkin
  48.                       date/time in the ranges given by the semicolon-separated
  49.                       list of _d_a_t_e_s.  A range  of  the  form  _d_1<<<_d_2  or  _d_2>>>_d_1
  50.                       selects the revisions that were deposited between _d_1 and
  51.                       _d_2 inclusive.  A range of the form <<<_d or _d>>> selects  all
  52.                       revisions dated _d or earlier.  A range of the form _d<<< or
  53.                       >>>_d selects all revisions dated _d or later.  A  range  of
  54.                       the  form  _d selects the single, latest revision dated _d
  55.                       or earlier.  The date/time strings _d, _d_1, and _d_2 are  in
  56.                       the free format explained in cccooo(1).  Quoting is normally
  57.                       necessary, especially  for  <<<  and  >>>.   Note  that  the
  58.                       separator is a semicolon.
  59.  
  60.  
  61.  
  62.  
  63.  
  64.                                     \*(Dt                                    1
  65.  
  66.  
  67.  
  68. RLOG(1)                    Unix Programmer's Manual                    RLOG(1)
  69.  
  70.  
  71.      ---lll[lockers]]]      Print  information  about  locked  revisions  only.   In
  72.                       addition,  if  the comma-separated list _l_o_c_k_e_r_s of login
  73.                       names is given, ignore all locks other than  those  held
  74.                       by  the  _l_o_c_k_e_r_s.   For  example,  rrrllloooggg\\\  ---LLL\\\ ---RRR\\\ ---lllwwwfffttt\\\
  75.                       RRRCCCSSS///***,,,vvv prints the name of RCS files locked by the  user
  76.                       wwwfffttt.
  77.  
  78.      ---rrr_r_e_v_i_s_i_o_n_s      prints information about revisions given in  the  comma-
  79.                       separated  list  _r_e_v_i_s_i_o_n_s  of  revisions and ranges.  A
  80.                       range _r_e_v_1---_r_e_v_2 means revisions _r_e_v_1 to _r_e_v_2 on the same
  81.                       branch,  ---_r_e_v  means revisions from the beginning of the
  82.                       branch up to and including _r_e_v, and _r_e_v--- means revisions
  83.                       starting  with  _r_e_v  to the end of the branch containing
  84.                       _r_e_v.  An argument that is a branch means  all  revisions
  85.                       on that branch.  A range of branches means all revisions
  86.                       on the branches in that range.
  87.  
  88.      ---sss_s_t_a_t_e_s         prints   information   about   revisions   whose   state
  89.                       attributes  match  one of the states given in the comma-
  90.                       separated list _s_t_a_t_e_s.
  91.  
  92.      ---www[logins]]]       prints information about revisions checked in  by  users
  93.                       with  login  names appearing in the comma-separated list
  94.                       _l_o_g_i_n_s.  If _l_o_g_i_n_s  is  omitted,  the  user's  login  is
  95.                       assumed.
  96.  
  97.      ---VVV_n              Emulate RCS version _n when generating logs.   See  cccooo(1)
  98.                       for more.
  99.  
  100.      rrrllloooggg prints the intersection of the revisions selected with  the  options
  101.      ---ddd,  ---lll, ---sss, and ---www, intersected with the union of the revisions selected
  102.      by ---bbb and ---rrr.
  103.  
  104. EEEXXXAAAMMMPPPLLLEEESSS
  105.  
  106.          rrrllloooggg  ---LLL  ---RRR  RRRCCCSSS///***,,,vvv
  107.          rrrllloooggg  ---LLL  ---hhh  RRRCCCSSS///***,,,vvv
  108.          rrrllloooggg  ---LLL  ---lll  RRRCCCSSS///***,,,vvv
  109.          rrrllloooggg  RRRCCCSSS///***,,,vvv
  110.  
  111.      The first command prints the names of all RCS files in  the  subdirectory
  112.      RRRCCCSSS  that  have  locks.   The  second command prints the headers of those
  113.      files, and the third prints the headers plus  the  log  messages  of  the
  114.      locked revisions.  The last command prints complete information.
  115.  
  116. DDDIIIAAAGGGNNNOOOSSSTTTIIICCCSSS
  117.      The exit status is zero if and only if all operations were successful.
  118.  
  119. IIIDDDEEENNNTTTIIIFFFIIICCCAAATTTIIIOOONNN
  120.      Author: Walter F. Tichy.
  121.      Revision Number: 5.0; Release Date: 1990/08/22.
  122.      Copyright (c) 1982, 1988, 1989 by Walter F. Tichy.
  123.      Copyright (c) 1990 by Paul Eggert.
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                     \*(Dt                                    2
  130.  
  131.  
  132.  
  133. RLOG(1)                    Unix Programmer's Manual                    RLOG(1)
  134.  
  135.  
  136. SSSEEEEEE AAALLLSSSOOO
  137.      ci(1), co(1), ident(1),  rcs(1),  rcsdiff(1),  rcsintro(1),  rcsmerge(1),
  138.      rcsfile(5)
  139.      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  &
  140.      _E_x_p_e_r_i_e_n_c_e 111555, 7 (July 1985), 637-654.
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.                                     \*(Dt                                    3
  195.  
  196.