home *** CD-ROM | disk | FTP | other *** search
/ Atari FTP / ATARI_FTP_0693.zip / ATARI_FTP_0693 / Programming / rcs5ap1b.lzh / RLOG.1LP < prev    next >
Encoding:
Text File  |  1991-01-30  |  5.9 KB  |  199 lines
  1.  
  2.  
  3.  
  4. RLOG(1)                Programmer's Manual                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.  File names ending
  17.      in ,v denote RCS files; all others denote working files.  If
  18.      a working file is given, rlog tries to find the correspond-
  19.      ing RCS file first in an RCS subdirectory and then in the
  20.      working file's directory, as explained in co(1).
  21.  
  22.      rlog prints the following information for each RCS file: RCS
  23.      file name, working file name, 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 GMT.
  33.      Without options, rlog prints complete information.  The
  34.      options below restrict this output.
  35.  
  36.      -L  Ignore RCS files that have no locks set.  This is con-
  37.          venient in combination with -h, -l, and -R.
  38.  
  39.      -R  Print only the name of the RCS file.  This is convenient
  40.          for translating a working file name into an RCS file
  41.          name.
  42.  
  43.      -h  Print only the RCS file name, working file name, 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. Printed 1/29/91            1990/08/22                           1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. RLOG(1)                Programmer's Manual                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/*,v prints
  85.          the 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.
  97.  
  98.      -s_s_t_a_t_e_s
  99.          prints information about revisions whose state attri-
  100.          butes match one of the states given in the comma-
  101.          separated list _s_t_a_t_e_s.
  102.  
  103.      -w[_l_o_g_i_n_s]
  104.          prints information about revisions checked in by users
  105.          with login names appearing in the comma-separated list
  106.          _l_o_g_i_n_s.  If _l_o_g_i_n_s is omitted, the user's login is
  107.          assumed.
  108.  
  109.      -V_n Emulate RCS version _n when generating logs.  See co(1)
  110.          for more.
  111.  
  112.      rlog prints the intersection of the revisions selected with
  113.      the options -d, -l, -s, and -w, intersected with the union
  114.      of the revisions selected by -b and -r.
  115.  
  116. EXAMPLES
  117.          rlog  -L  -R  RCS/*,v
  118.          rlog  -L  -h  RCS/*,v
  119.          rlog  -L  -l  RCS/*,v
  120.          rlog  RCS/*,v
  121.  
  122.      The first command prints the names of all RCS files in the
  123.      subdirectory RCS that have locks.  The second command prints
  124.      the headers of those files, and the third prints the headers
  125.      plus the log messages of the locked revisions.  The last
  126.  
  127.  
  128.  
  129. Printed 1/29/91            1990/08/22                           2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. RLOG(1)                Programmer's Manual                RLOG(1)
  137.  
  138.  
  139.  
  140.      command prints complete information.
  141.  
  142. DIAGNOSTICS
  143.      The exit status is zero if and only if all operations were
  144.      successful.
  145.  
  146. IDENTIFICATION
  147.      Author: Walter F. Tichy.
  148.      Revision Number: 5.0; Release Date: 1990/08/22.
  149.      Copyright c 1982, 1988, 1989 by Walter F. Tichy.
  150.      Copyright c 1990 by Paul Eggert.
  151.  
  152. SEE ALSO
  153.      ci(1), co(1), ident(1), rcs(1), rcsdiff(1), rcsintro(1),
  154.      rcsmerge(1), rcsfile(5)
  155.      Walter F. Tichy, RCS--A System for Version Control,
  156.      _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.
  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.  
  195. Printed 1/29/91            1990/08/22                           3
  196.  
  197.  
  198.  
  199.