home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 317a.lha / RCS / doc / rcs.1l.doc < prev    next >
Text File  |  1989-12-05  |  9KB  |  265 lines
  1.  
  2.  
  3.  
  4. RCS(1L)           UNKNOWN SECTION OF THE MANUAL           RCS(1L)
  5.  
  6.  
  7.  
  8. NAME
  9.      rcs - change RCS file attributes
  10.  
  11. SYNOPSIS
  12.      rcs [ options ] file ...
  13.  
  14. DESCRIPTION
  15.      _R_c_s creates new RCS files or changes attributes of  existing
  16.      ones.   An  RCS file contains multiple revisions of text, an
  17.      access list, a change log, descriptive text, and  some  con-
  18.      trol  attributes.   For _r_c_s to work, the caller's login name
  19.      must be on the access list, except if  the  access  list  is
  20.      empty, the caller is the owner of the file or the superuser,
  21.      or the -i option is present.
  22.  
  23.      Files ending in `,v' are RCS files, all others  are  working
  24.      files.  If  a  working  file is given, _r_c_s tries to find the
  25.      corresponding RCS file first in directory ./RCS and then  in
  26.      the current directory, as explained in _c_o(1L).
  27.  
  28.      -i         creates and initializes a new RCS file, but  does
  29.                 not deposit any revision.  If the RCS file has no
  30.                 path prefix, _r_c_s tries to place it first into the
  31.                 subdirectory  ./RCS,  and  then  into the current
  32.                 directory.  If the RCS file  already  exists,  an
  33.                 error message is printed.
  34.  
  35.      -a_l_o_g_i_n_s   appends the login names appearing in  the  comma-
  36.                 separated  list  _l_o_g_i_n_s to the access list of the
  37.                 RCS file.
  38.  
  39.      -A_o_l_d_f_i_l_e  appends the access list of _o_l_d_f_i_l_e to the  access
  40.                 list of the RCS file.
  41.  
  42.      -e[_l_o_g_i_n_s] erases the login names appearing  in  the  comma-
  43.                 separated list _l_o_g_i_n_s from the access list of the
  44.                 RCS file.   If  _l_o_g_i_n_s  is  omitted,  the  entire
  45.                 access list is erased.
  46.  
  47.      -b[_r_e_v]    sets the default branch to _r_e_v. If _r_e_v  is  omit-
  48.                 ted,  the default branch is reset to the (dynami-
  49.                 cally) highest branch on the trunk.
  50.  
  51.      -c_s_t_r_i_n_g   sets the comment leader to  _s_t_r_i_n_g.  The  comment
  52.                 leader  is  printed before every log message line
  53.                 generated by the keyword $Log$   during  checkout
  54.                 (see  _c_o(1L)).   This  is  useful for programming
  55.                 languages without multi-line comments. During rcs
  56.                 -i  or  initial ci, the comment leader is guessed
  57.                 from the suffix of the working file.
  58.  
  59.      -l[_r_e_v]    locks the revision with number _r_e_v.  If a  branch
  60.  
  61.  
  62.  
  63. Purdue University         Last change:                          1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. RCS(1L)           UNKNOWN SECTION OF THE MANUAL           RCS(1L)
  71.  
  72.  
  73.  
  74.                 is  given,  the latest revision on that branch is
  75.                 locked.  If _r_e_v is omitted, the  latest  revision
  76.                 on   the   default  branch  is  locked.   Locking
  77.                 prevents overlapping changes.  A lock is  removed
  78.                 with ci or rcs -u (see below).
  79.  
  80.      -u[_r_e_v]    unlocks the  revision  with  number  _r_e_v.   If  a
  81.                 branch  is  given,  the  latest  revision on that
  82.                 branch is  unlocked.   If  _r_e_v  is  omitted,  the
  83.                 latest  lock held by the caller is removed.  Nor-
  84.                 mally, only the locker of a revision  may  unlock
  85.                 it.   Somebody  else  unlocking a revision breaks
  86.                 the lock. This causes a mail message to  be  sent
  87.                 to  the  original locker.  The message contains a
  88.                 commentary solicited from the breaker.  The  com-
  89.                 mentary  is  terminated  with a line containing a
  90.                 single `.' or control-D.
  91.  
  92.      -L         sets locking to _s_t_r_i_c_t. Strict locking means that
  93.                 the owner of an RCS file is not exempt from lock-
  94.                 ing for checkin.  This option should be used  for
  95.                 files that are shared.
  96.  
  97.      -U         sets locking to  non-strict.  Non-strict  locking
  98.                 means  that  the  owner of a file need not lock a
  99.                 revision for checkin. This option should  NOT  be
  100.                 used  for files that are shared.  The default (-L
  101.                 or -U) is determined by your  system  administra-
  102.                 tor.
  103.  
  104.      -n_n_a_m_e[:_r_e_v]
  105.                 associates the symbolic name _n_a_m_e with the branch
  106.                 or  revision  _r_e_v. _R_c_s prints an error message if
  107.                 _n_a_m_e is already associated with  another  number.
  108.                 If _r_e_v is omitted, the symbolic name is deleted.
  109.  
  110.      -N_n_a_m_e[:_r_e_v]
  111.                 same as -n, except that it overrides  a  previous
  112.                 assignment of _n_a_m_e.
  113.  
  114.      -o_r_a_n_g_e    deletes  ("outdates")  the  revisions  given   by
  115.                 _r_a_n_g_e.   A  range consisting of a single revision
  116.                 number means that revision.  A  range  consisting
  117.                 of  a  branch number means the latest revision on
  118.                 that branch.  A range of the form _r_e_v_1-_r_e_v_2 means
  119.                 revisions  _r_e_v_1  to _r_e_v_2 on the same branch, -_r_e_v
  120.                 means from the beginning of the branch containing
  121.                 _r_e_v  up to and including _r_e_v, and _r_e_v- means from
  122.                 revision _r_e_v to the end of the branch  containing
  123.                 _r_e_v.   None  of  the  outdated revisions may have
  124.                 branches or locks.
  125.  
  126.  
  127.  
  128.  
  129. Purdue University         Last change:                          2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. RCS(1L)           UNKNOWN SECTION OF THE MANUAL           RCS(1L)
  137.  
  138.  
  139.  
  140.      -q         quiet mode; diagnostics are not printed.
  141.  
  142.      -s_s_t_a_t_e[:_r_e_v]
  143.                 sets the state attribute of the revision  _r_e_v  to
  144.                 _s_t_a_t_e.  If  _r_e_v  is  a  branch number, the latest
  145.                 revision on that branch is assumed.   If  _r_e_v  is
  146.                 omitted,  the  latest  revision  on  the  default
  147.                 branch is assumed.  Any identifier is  acceptable
  148.                 for  _s_t_a_t_e.   A  useful set of states is _E_x_p (for
  149.                 experimental), _S_t_a_b (for stable),  and  _R_e_l  (for
  150.                 released).   By default, _c_i(1L) sets the state of
  151.                 a revision to _E_x_p.
  152.  
  153.      -t[_t_x_t_f_i_l_e]
  154.                 writes  descriptive  text  into  the   RCS   file
  155.                 (deletes the existing text).  If _t_x_t_f_i_l_e is omit-
  156.                 ted, _r_c_s prompts the user for text supplied  from
  157.                 the  standard  input, terminated with a line con-
  158.                 taining a single `.'  or  control-D.   Otherwise,
  159.                 the  descriptive  text  is  copied  from the file
  160.                 _t_x_t_f_i_l_e.  If the -i option is  present,  descrip-
  161.                 tive  text  is requested even if -t is not given.
  162.                 The prompt is suppressed if the standard input is
  163.                 not a terminal.
  164.  
  165. DIAGNOSTICS
  166.      The RCS file name and the revisions outdated are written  to
  167.      the diagnostic output.  The exit status always refers to the
  168.      last RCS file operated upon, and is 0 if the  operation  was
  169.      successful, 1 otherwise.
  170.  
  171. FILES
  172.      The caller of the command must  have  read/write  permission
  173.      for  the  directory containing the RCS file and read permis-
  174.      sion for the RCS file itself.  _R_c_s creates a semaphore  file
  175.      in  the same directory as the RCS file to prevent simultane-
  176.      ous update.  For changes, _r_c_s always creates a new file.  On
  177.      successful  completion,  _r_c_s deletes the old one and renames
  178.      the new one.  This strategy makes links to  RCS  files  use-
  179.      less.
  180.  
  181. IDENTIFICATION
  182.      Author: Walter F. Tichy, Purdue University, West  Lafayette,
  183.      IN, 47907.
  184.      Revision Number: 1.3 ; Release Date: 89/05/02 .
  185.      Copyright c 1982, 1988, 1989 by Walter F. Tichy.
  186.  
  187. SEE ALSO
  188.      co(1L),  ci(1L),   ident(1L),   rcsdiff(1L),   rcsintro(1L),
  189.      rcsmerge(1L), rlog(1L), rcsfile(5L)
  190.      Walter F. Tichy, "Design, Implementation, and Evaluation  of
  191.      a  Revision  Control  System,"  in  _P_r_o_c_e_e_d_i_n_g_s  _o_f  _t_h_e _6_t_h
  192.  
  193.  
  194.  
  195. Purdue University         Last change:                          3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. RCS(1L)           UNKNOWN SECTION OF THE MANUAL           RCS(1L)
  203.  
  204.  
  205.  
  206.      _I_n_t_e_r_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,
  207.      Tokyo, Sept. 1982.
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261. Purdue University         Last change:                          4
  262.  
  263.  
  264.  
  265.