home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 317a.lha / RCS / doc / rlog.1l.doc < prev    next >
Text File  |  1989-12-05  |  6KB  |  199 lines
  1.  
  2.  
  3.  
  4. RLOG(1L)          UNKNOWN SECTION OF THE MANUAL          RLOG(1L)
  5.  
  6.  
  7.  
  8. NAME
  9.      rlog - print log messages and other  information  about  RCS
  10.      files
  11.  
  12. SYNOPSIS
  13.      rlog [ options ] file ...
  14.  
  15. DESCRIPTION
  16.      _R_l_o_g prints information about RCS files.   Files  ending  in
  17.      `,v' are RCS files, all others are working files. If a work-
  18.      ing file is given, _r_l_o_g tries to find the corresponding  RCS
  19.      file first in directory ./RCS and then in the current direc-
  20.      tory, as explained in _c_o(1L).
  21.  
  22.      _R_l_o_g 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 revisions
  28.      in reverse chronological order for  each  branch.  For  each
  29.      revision,  _r_l_o_g  prints  revision number, author, date/time,
  30.      state, number of lines added/deleted (with  respect  to  the
  31.      previous revision), locker of the revision (if any), and log
  32.      message.  Without options, _r_l_o_g prints complete information.
  33.      The options below restrict this output.
  34.  
  35.      -L        ignores RCS files that have  no  locks  set;  con-
  36.                venient in combination with -R, -h, or -l.
  37.  
  38.      -R        only prints the name of the RCS  file;  convenient
  39.                for  translating  a  working file name into an RCS
  40.                file name.
  41.  
  42.      -h        prints only RCS  file  name,  working  file  name,
  43.                head, default branch, access list, locks, symbolic
  44.                names, and suffix.
  45.  
  46.      -t        prints the same as -h, plus the descriptive text.
  47.  
  48.      -b        prints information  about  the  revisions  on  the
  49.                default branch (normally the highest branch on the
  50.                trunk).
  51.  
  52.      -d_d_a_t_e_s   prints information about revisions with a  checkin
  53.                date/time  in  the  ranges given by the semicolon-
  54.                separated list of _d_a_t_e_s.   A  range  of  the  form
  55.                _d_1<_d_2  or  _d_2>_d_1  selects  the revisions that were
  56.                deposited between _d_1 and _d_2, (inclusive).  A range
  57.                of the form <_d or _d> selects all revisions dated _d
  58.                or earlier.  A range of the form _d< or >_d  selects
  59.                all  revisions  dated  _d or later.  A range of the
  60.  
  61.  
  62.  
  63. Purdue University         Last change:                          1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. RLOG(1L)          UNKNOWN SECTION OF THE MANUAL          RLOG(1L)
  71.  
  72.  
  73.  
  74.                form _d selects the single, latest revision dated _d
  75.                or  earlier.   The date/time strings _d, _d_1, and _d_2
  76.                are in the free format explained in _c_o(1L).  Quot-
  77.                ing is normally necessary, especially for < and >.
  78.                Note that the separator is a semicolon.
  79.  
  80.      -l[_l_o_c_k_e_r_s]
  81.                prints information about locked revisions.  If the
  82.                comma-separated  list  _l_o_c_k_e_r_s  of  login names is
  83.                given, only the  revisions  locked  by  the  given
  84.                login  names are printed.  If the list is omitted,
  85.                all locked revisions are printed.
  86.  
  87.      -r_r_e_v_i_s_i_o_n_s
  88.                prints information about revisions  given  in  the
  89.                comma-separated  list  _r_e_v_i_s_i_o_n_s  of revisions and
  90.                ranges. A range _r_e_v_1-_r_e_v_2 means revisions _r_e_v_1  to
  91.                _r_e_v_2 on the same branch, -_r_e_v means revisions from
  92.                the beginning of the branch up  to  and  including
  93.                _r_e_v, and _r_e_v- means revisions starting with _r_e_v to
  94.                the end of the branch containing _r_e_v. An  argument
  95.                that  is  a  branch  means  all  revisions on that
  96.                branch. A range of branches means all revisions on
  97.                the branches in that range.
  98.  
  99.      -s_s_t_a_t_e_s  prints information  about  revisions  whose  state
  100.                attributes  match  one  of the states given in the
  101.                comma-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
  105.                users  with  login  names  appearing in the comma-
  106.                separated list _l_o_g_i_n_s.  If _l_o_g_i_n_s is omitted,  the
  107.                user's login is assumed.
  108.  
  109.      _R_l_o_g prints the intersection of the revisions selected  with
  110.      the  options  -d,  -l, -s, -w, intersected with the union of
  111.      the revisions selected by -b and -r.
  112.  
  113. EXAMPLES
  114.              rlog  -L  -R  RCS/*,v
  115.              rlog  -L  -h  RCS/*,v
  116.              rlog  -L  -l  RCS/*,v
  117.              rlog  RCS/*,v
  118.  
  119.      The first command prints the names of all RCS files  in  the
  120.      subdirectory  `RCS'  which  have  locks.  The second command
  121.      prints the headers of those files, and the third prints  the
  122.      headers  plus the log messages of the locked revisions.  The
  123.      last command prints complete information.
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Purdue University         Last change:                          2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. RLOG(1L)          UNKNOWN SECTION OF THE MANUAL          RLOG(1L)
  137.  
  138.  
  139.  
  140. DIAGNOSTICS
  141.      The exit status always refers to the last RCS file  operated
  142.      upon, and is 0 if the operation was successful, 1 otherwise.
  143.  
  144. IDENTIFICATION
  145.      Author: Walter F. Tichy, Purdue University, West  Lafayette,
  146.      IN, 47907.
  147.      Revision Number: 1.3 ; Release Date: 89/05/02 .
  148.      Copyright c 1982, 1988, 1989 by Walter F. Tichy.
  149.  
  150. SEE ALSO
  151.      ci(1L),    co(1L),    ident(1L),    rcs(1L),    rcsdiff(1L),
  152.      rcsintro(1L), rcsmerge(1L), rcsfile(5L)
  153.      Walter F. Tichy, "Design, Implementation, and Evaluation  of
  154.      a Revision Control System," in _P_r_o_c_e_e_d_i_n_g_s _o_f _t_h_e _6_t_h _I_n_t_e_r_-
  155.      _n_a_t_i_o_n_a_l _C_o_n_f_e_r_e_n_c_e _o_n _S_o_f_t_w_a_r_e  _E_n_g_i_n_e_e_r_i_n_g,  IEEE,  Tokyo,
  156.      Sept. 1982.
  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. Purdue University         Last change:                          3
  196.  
  197.  
  198.  
  199.