home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 8 / CDASC08.ISO / VRAC / RCSDOC.ZIP / RCS.TXT < prev    next >
Text File  |  1991-11-10  |  10KB  |  196 lines
  1.  
  2.  
  3. RCS(1)                     Unix Programmer's Manual                     RCS(1)
  4.  
  5.  
  6. NNNAAAMMMEEE
  7.      rcs - change RCS file attributes
  8.  
  9. SSSYYYNNNOOOPPPSSSIIISSS
  10.      rrrcccsss [ _o_p_t_i_o_n_s ] _f_i_l_e ...
  11.  
  12. DDDEEESSSCCCRRRIIIPPPTTTIIIOOONNN
  13.      rrrcccsss creates new RCS files or changes attributes of existing ones.  An RCS
  14.      file  contains  multiple revisions of text, an access list, a change log,
  15.      descriptive text, and some control attributes.   For  rrrcccsss  to  work,  the
  16.      caller's login name must be on the access list, except if the access list
  17.      is empty, the caller is the owner of the file or the superuser, or the ---iii
  18.      option is present.
  19.  
  20.      File names ending in ,,,vvv denote  RCS  files;  all  others  denote  working
  21.      files.   If  a working file is given, rrrcccsss tries to find the corresponding
  22.      RCS file first in an RCS subdirectory and  then  in  the  working  file's
  23.      directory, as explained in cccooo(1).
  24.  
  25. OOOPPPTTTIIIOOONNNSSS
  26.  
  27.      ---iii   Create and initialize a  new  RCS  file,  but  do  not  deposit  any
  28.           revision.  If the RCS file has no path prefix, try to place it first
  29.           into the subdirectory ...///RRRCCCSSS, and then into  the  current  directory.
  30.           If the RCS file already exists, print an error message.
  31.  
  32.      ---aaa_l_o_g_i_n_s
  33.           Append the login names appearing in the comma-separated list  _l_o_g_i_n_s
  34.           to the access list of the RCS file.
  35.  
  36.      ---AAA_o_l_d_f_i_l_e
  37.           Append the access list of _o_l_d_f_i_l_e to the  access  list  of  the  RCS
  38.           file.
  39.  
  40.      ---eee[logins]]]
  41.           Erase the login names appearing in the comma-separated  list  _l_o_g_i_n_s
  42.           from  the  access list of the RCS file.  If _l_o_g_i_n_s is omitted, erase
  43.           the entire access list.
  44.  
  45.      ---bbb[rev]]]
  46.           Set the default branch to _r_e_v.   If  _r_e_v  is  omitted,  the  default
  47.           branch is reset to the (dynamically) highest branch on the trunk.
  48.  
  49.      ---ccc_s_t_r_i_n_g
  50.           sets the comment leader to _s_t_r_i_n_g.  The comment  leader  is  printed
  51.           before  every log message line generated by the keyword $$$LLLoooggg$$$ during
  52.           checkout (see cccooo(1)).  This  is  useful  for  programming  languages
  53.           without  multi-line comments.  An initial ccciii ,,, or an rrrcccsss\\\ ---iii without
  54.           ---ccc, guesses the comment leader from the suffix of the working file.
  55.  
  56.      ---kkk_s_u_b_s_t
  57.           Set the default  keyword  substitution  to  _s_u_b_s_t.   The  effect  of
  58.           keyword  substitution  is described in cccooo(1).  Giving an explicit ---kkk
  59.           option to cccooo, rrrcccsssdddiiiffffff, and rrrcccsssmmmeeerrrgggeee overrides this default.   Beware
  60.           rrrcccsss\\\ ---kkkvvv, because ---kkkvvv is incompatible with cccooo\\\ ---lll.  Use rrrcccsss\\\ ---kkkkkkvvv to
  61.           restore the normal default keyword substitution.
  62.  
  63.  
  64.                                     \*(Dt                                    1
  65.  
  66.  
  67.  
  68. RCS(1)                     Unix Programmer's Manual                     RCS(1)
  69.  
  70.  
  71.      ---lll[rev]]]
  72.           Lock the revision with number _r_e_v.  If a branch is given,  lock  the
  73.           latest  revision on that branch.  If _r_e_v is omitted, lock the latest
  74.           revision  on  the  default  branch.   Locking  prevents  overlapping
  75.           changes.  A lock is removed with ccciii or rrrcccsss\\\ ---uuu (see below).
  76.  
  77.      ---uuu[rev]]]
  78.           Unlock the revision with number _r_e_v.  If a branch is  given,  unlock
  79.           the  latest  revision on that branch.  If _r_e_v is omitted, remove the
  80.           latest lock held by the caller.  Normally,  only  the  locker  of  a
  81.           revision  may  unlock it.  Somebody else unlocking a revision breaks
  82.           the lock.  This causes a mail message to be  sent  to  the  original
  83.           locker.   The  message  contains  a  commentary  solicited  from the
  84.           breaker.  The commentary is terminated by end-of-file or by  a  line
  85.           containing ...\ by itself.
  86.  
  87.      ---LLL   Set locking to _s_t_r_i_c_t.  Strict locking means that the  owner  of  an
  88.           RCS file is not exempt from locking for checkin.  This option should
  89.           be used for files that are shared.
  90.  
  91.      ---UUU   Set locking to non-strict.  Non-strict locking means that the  owner
  92.           of  a file need not lock a revision for checkin.  This option should
  93.           _n_o_t be used for files that are shared.  Whether default  locking  is
  94.           strict  is  determined  by  your  system  administrator,  but  it is
  95.           normally strict.
  96.  
  97.      ---nnnnnnaaammmeee[:rev]
  98.           Associate the symbolic name _n_a_m_e with the branch  or  revision  _r_e_v.
  99.           Print  an  error  message if _n_a_m_e is already associated with another
  100.           number.  If _r_e_v is omitted, the symbolic name is deleted.
  101.  
  102.      ---NNNnnnaaammmeee[:rev]
  103.           Act like ---nnn, except override any previous assignment of _n_a_m_e.
  104.  
  105.      ---ooo_r_a_n_g_e
  106.           deletes (outdates) the revisions given by _r_a_n_g_e.  A range consisting
  107.           of a single revision number means that revision.  A range consisting
  108.           of a branch number means the latest  revision  on  that  branch.   A
  109.           range of the form _r_e_v_1---_r_e_v_2 means revisions _r_e_v_1 to _r_e_v_2 on the same
  110.           branch, ---_r_e_v means from the beginning of the branch  containing  _r_e_v
  111.           up to and including _r_e_v, and _r_e_v--- means from revision _r_e_v to the end
  112.           of the branch containing _r_e_v.  None of the  outdated  revisions  may
  113.           have branches or locks.
  114.  
  115.      ---qqq   Run quietly; do not print diagnostics.
  116.  
  117.      ---III   Run interactively, even if the standard input is not a terminal.
  118.  
  119.      ---sssssstttaaattteee[:rev]
  120.           Set the state attribute of the revision _r_e_v to _s_t_a_t_e . If _r_e_v  is  a
  121.           branch number, assume the latest revision on that branch.  If _r_e_v is
  122.           omitted, assume the latest revision  on  the  default  branch.   Any
  123.           identifier  is  acceptable for _s_t_a_t_e.  A useful set of states is EEExxxppp
  124.           (for experimental), SSStttaaabbb (for stable), and RRReeelll (for  released).   By
  125.           default, ccciii(1) sets the state of a revision to EEExxxppp.
  126.  
  127.  
  128.  
  129.                                     \*(Dt                                    2
  130.  
  131.  
  132.  
  133. RCS(1)                     Unix Programmer's Manual                     RCS(1)
  134.  
  135.  
  136.      ---ttt[file]]]
  137.           Write descriptive text from the contents of the named _f_i_l_e into  the
  138.           RCS  file,  deleting the existing text.  The _f_i_l_e name may not begin
  139.           with ---.  If _f_i_l_e is omitted, obtain the text  from  standard  input,
  140.           terminated  by  end-of-file  or  by  a line containing ...\ by itself.
  141.           Prompt for the text if interaction is possible; see  ---III.   With  ---iii,
  142.           descriptive text is obtained even if ---ttt is not given.
  143.  
  144.      ---ttt---_s_t_r_i_n_g
  145.           Write descriptive text from the _s_t_r_i_n_g into the RCS  file,  deleting
  146.           the existing text.
  147.  
  148.      ---VVV_n  Emulate RCS version _n.  See cccooo(1) for details.
  149.  
  150. CCCOOOMMMPPPAAATTTIIIBBBIIILLLIIITTTYYY
  151.      The ---bbb_r_e_v option generates an RCS file  that  cannot  be  parsed  by  RCS
  152.      version 3 or earlier.
  153.  
  154.      The ---kkk_s_u_b_s_t options (except ---kkkkkkvvv) generate an RCS  file  that  cannot  be
  155.      parsed by RCS version 4 or earlier.
  156.  
  157.      Use rrrcccsss ---VVV_n to make an RCS file acceptable to RCS version _n by discarding
  158.      information that would confuse version _n.
  159.  
  160. DDDIIIAAAGGGNNNOOOSSSTTTIIICCCSSS
  161.      The RCS  file  name  and  the  revisions  outdated  are  written  to  the
  162.      diagnostic output.  The exit status is zero if and only if all operations
  163.      were successful.
  164.  
  165. FFFIIILLLEEESSS
  166.      rrrcccsss accesses files much as ccciii(1) does, except that it does  not  need  to
  167.      access the working file or its directory.
  168.  
  169. IIIDDDEEENNNTTTIIIFFFIIICCCAAATTTIIIOOONNN
  170.      Author: Walter F. Tichy.
  171.      Revision Number: 5.3; Release Date: 1990/12/04.
  172.      Copyright (c) 1982, 1988, 1989 by Walter F. Tichy.
  173.      Copyright (c) 1990 by Paul Eggert.
  174.  
  175. SSSEEEEEE AAALLLSSSOOO
  176.      co(1), ci(1), ident(1), rcsdiff(1),  rcsintro(1),  rcsmerge(1),  rlog(1),
  177.      rcsfile(5)
  178.      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  &
  179.      _E_x_p_e_r_i_e_n_c_e 111555, 7 (July 1985), 637-654.
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.                                     \*(Dt                                    3
  195.  
  196.