home *** CD-ROM | disk | FTP | other *** search
/ Borland Programmer's Resource / Borland_Programmers_Resource_CD_1995.iso / utils / gr564b / rcs.1 < prev    next >
Text File  |  1995-05-18  |  13KB  |  331 lines
  1.  
  2.  
  3.  
  4. RCS(1)                                                     RCS(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        rcs - change RCS file attributes
  9.  
  10. SSYYNNOOPPSSIISS
  11.        rrccss [ _o_p_t_i_o_n_s ] _f_i_l_e ...
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.        rrccss creates new RCS files or changes attributes of
  15.        existing ones.  An RCS file contains multiple revisions of
  16.        text, an access list, a change log, descriptive text, and
  17.        some control attributes.  For rrccss to work, the caller's
  18.        login name must be on the access list, except if the
  19.        access list is empty, the caller is the owner of the file
  20.        or the superuser, or the --ii option is present.
  21.  
  22.        Pathnames matching an RCS suffix denote RCS files; all
  23.        others denote working files.  Names are paired as
  24.        explained in ccii(1).  Revision numbers use the syntax
  25.        described in ccii(1).
  26.  
  27. OOPPTTIIOONNSS
  28.        --ii     Create and initialize a new RCS file, but do not
  29.               deposit any revision.  If the RCS file has no path
  30.               prefix, try to place it first into the subdirectory
  31.               ..//RRCCSS, and then into the current directory.  If the
  32.               RCS file already exists, print an error message.
  33.  
  34.        --aa_l_o_g_i_n_s
  35.               Append the login names appearing in the comma-
  36.               separated list _l_o_g_i_n_s to the access list of the RCS
  37.               file.
  38.  
  39.        --AA_o_l_d_f_i_l_e
  40.               Append the access list of _o_l_d_f_i_l_e to the access
  41.               list of the RCS file.
  42.  
  43.        --ee[_l_o_g_i_n_s]
  44.               Erase the login names appearing in the comma-
  45.               separated list _l_o_g_i_n_s from the access list of the
  46.               RCS file.  If _l_o_g_i_n_s is omitted, erase the entire
  47.               access list.
  48.  
  49.        --bb[_r_e_v]
  50.               Set the default branch to _r_e_v.  If _r_e_v is omitted,
  51.               the default branch is reset to the (dynamically)
  52.               highest branch on the trunk.
  53.  
  54.        --cc_s_t_r_i_n_g
  55.               sets the comment leader to _s_t_r_i_n_g.  The comment
  56.               leader is printed before every log message line
  57.               generated by the keyword $$LLoogg$$ during checkout (see
  58.               ccoo(1)).  This is useful for programming languages
  59.               without multi-line comments.  An initial ccii ,, or an
  60.               rrccss --ii without --cc, guesses the comment leader from
  61.  
  62.  
  63.  
  64. GNU                         1992/07/28                          1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. RCS(1)                                                     RCS(1)
  71.  
  72.  
  73.               the suffix of the working file.
  74.  
  75.        --kk_s_u_b_s_t
  76.               Set the default keyword substitution to _s_u_b_s_t.  The
  77.               effect of keyword substitution is described in
  78.               ccoo(1).  Giving an explicit --kk option to ccoo,
  79.               rrccssddiiffff, and rrccssmmeerrggee overrides this default.
  80.               Beware rrccss --kkvv, because --kkvv is incompatible with
  81.               ccoo --ll.  Use rrccss --kkkkvv to restore the normal default
  82.               keyword substitution.
  83.  
  84.        --ll[_r_e_v]
  85.               Lock the revision with number _r_e_v.  If a branch is
  86.               given, lock the latest revision on that branch.  If
  87.               _r_e_v is omitted, lock the latest revision on the
  88.               default branch.  Locking prevents overlapping
  89.               changes.  If someone else already holds the lock,
  90.               the lock is broken as with rrccss --uu (see below).
  91.  
  92.        --uu[_r_e_v]
  93.               Unlock the revision with number _r_e_v.  If a branch
  94.               is given, unlock the latest revision on that
  95.               branch.  If _r_e_v is omitted, remove the latest lock
  96.               held by the caller.  Normally, only the locker of a
  97.               revision may unlock it.  Somebody else unlocking a
  98.               revision breaks the lock.  This causes a mail
  99.               message to be sent to the original locker.  The
  100.               message contains a commentary solicited from the
  101.               breaker.  The commentary is terminated by end-of-
  102.               file or by a line containing .. by itself.
  103.  
  104.        --LL     Set locking to _s_t_r_i_c_t.  Strict locking means that
  105.               the owner of an RCS file is not exempt from locking
  106.               for checkin.  This option should be used for files
  107.               that are shared.
  108.  
  109.        --UU     Set locking to non-strict.  Non-strict locking
  110.               means that the owner of a file need not lock a
  111.               revision for checkin.  This option should _n_o_t be
  112.               used for files that are shared.  Whether default
  113.               locking is strict is determined by your system
  114.               administrator, but it is normally strict.
  115.  
  116.        --mm_r_e_v::_m_s_g
  117.               Replace revision _r_e_v's log message with _m_s_g.
  118.  
  119.        --MM     Do not send mail when breaking somebody else's
  120.               lock.  This option is not meant for casual use; it
  121.               is meant for programs that warn users by other
  122.               means, and invoke rrccss --uu only as a low-level lock-
  123.               breaking operation.
  124.  
  125.        --nn_n_a_m_e[::[_r_e_v]]
  126.               Associate the symbolic name _n_a_m_e with the branch or
  127.  
  128.  
  129.  
  130. GNU                         1992/07/28                          2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. RCS(1)                                                     RCS(1)
  137.  
  138.  
  139.               revision _r_e_v.  Delete the symbolic name if both ::
  140.               and _r_e_v are omitted; otherwise, print an error
  141.               message if _n_a_m_e is already associated with another
  142.               number.  If _r_e_v is symbolic, it is expanded before
  143.               association.  A _r_e_v consisting of a branch number
  144.               followed by a .. stands for the current latest
  145.               revision in the branch.  A :: with an empty _r_e_v
  146.               stands for the current latest revision on the
  147.               default branch, normally the trunk.  For example,
  148.               rrccss --nn_n_a_m_e:: RRCCSS//** associates _n_a_m_e with the current
  149.               latest revision of all the named RCS files; this
  150.               contrasts with rrccss --nn_n_a_m_e::$$ RRCCSS//** which associates
  151.               _n_a_m_e with the revision numbers extracted from
  152.               keyword strings in the corresponding working files.
  153.  
  154.        --NN_n_a_m_e[::[_r_e_v]]
  155.               Act like --nn, except override any previous
  156.               assignment of _n_a_m_e.
  157.  
  158.        --oo_r_a_n_g_e
  159.               deletes (``outdates'') the revisions given by
  160.               _r_a_n_g_e.  A range consisting of a single revision
  161.               number means that revision.  A range consisting of
  162.               a branch number means the latest revision on that
  163.               branch.  A range of the form _r_e_v_1::_r_e_v_2 means
  164.               revisions _r_e_v_1 to _r_e_v_2 on the same branch, ::_r_e_v
  165.               means from the beginning of the branch containing
  166.               _r_e_v up to and including _r_e_v, and _r_e_v:: means from
  167.               revision _r_e_v to the end of the branch containing
  168.               _r_e_v.  None of the outdated revisions may have
  169.               branches or locks.
  170.  
  171.        --qq     Run quietly; do not print diagnostics.
  172.  
  173.        --II     Run interactively, even if the standard input is
  174.               not a terminal.
  175.  
  176.        --ss_s_t_a_t_e[::_r_e_v]
  177.               Set the state attribute of the revision _r_e_v to
  178.               _s_t_a_t_e.  If _r_e_v is a branch number, assume the
  179.               latest revision on that branch.  If _r_e_v is omitted,
  180.               assume the latest revision on the default branch.
  181.               Any identifier is acceptable for _s_t_a_t_e.  A useful
  182.               set of states is EExxpp (for experimental), SSttaabb (for
  183.               stable), and RReell (for released).  By default, ccii(1)
  184.               sets the state of a revision to EExxpp.
  185.  
  186.        --tt[_f_i_l_e]
  187.               Write descriptive text from the contents of the
  188.               named _f_i_l_e into the RCS file, deleting the existing
  189.               text.  The _f_i_l_e pathname may not begin with --.  If
  190.               _f_i_l_e is omitted, obtain the text from standard
  191.               input, terminated by end-of-file or by a line
  192.               containing .. by itself.  Prompt for the text if
  193.  
  194.  
  195.  
  196. GNU                         1992/07/28                          3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. RCS(1)                                                     RCS(1)
  203.  
  204.  
  205.               interaction is possible; see --II.  With --ii,
  206.               descriptive text is obtained even if --tt is not
  207.               given.
  208.  
  209.        --tt--_s_t_r_i_n_g
  210.               Write descriptive text from the _s_t_r_i_n_g into the RCS
  211.               file, deleting the existing text.
  212.  
  213.        --TT     Preserve the modification time on the RCS file
  214.               unless a revision is removed.  This option can
  215.               suppress extensive recompilation caused by a
  216.               mmaakkee(1) dependency of some copy of the working file
  217.               on the RCS file.  Use this option with care; it can
  218.               suppress recompilation even when it is needed, i.e.
  219.               when a change to the RCS file would mean a change
  220.               to keyword strings in the working file.
  221.  
  222.        --VV     Print s version number.
  223.  
  224.        --VV_n    Emulate RCS version _n.  See ccoo(1) for details.
  225.  
  226.        --xx_s_u_f_f_i_x_e_s
  227.               Use _s_u_f_f_i_x_e_s to characterize RCS files.  See ccii(1)
  228.               for details.
  229.  
  230. CCOOMMPPAATTIIBBIILLIITTYY
  231.        The --bb_r_e_v option generates an RCS file that cannot be
  232.        parsed by RCS version 3 or earlier.
  233.  
  234.        The --kk_s_u_b_s_t options (except --kkkkvv) generate an RCS file
  235.        that cannot be parsed by RCS version 4 or earlier.
  236.  
  237.        Use rrccss --VV_n to make an RCS file acceptable to RCS version
  238.        _n by discarding information that would confuse version _n.
  239.  
  240.        RCS version 5.5 and earlier does not support the --xx
  241.        option, and requires a ,,vv suffix on an RCS pathname.
  242.  
  243. FFIILLEESS
  244.        rrccss accesses files much as ccii(1) does, except that it uses
  245.        the effective user for all accesses, it does not write the
  246.        working file or its directory, and it does not even read
  247.        the working file unless a revision number of $$ is
  248.        specified.
  249.  
  250. EENNVVIIRROONNMMEENNTT
  251.        RRCCSSIINNIITT
  252.               options prepended to the argument list, separated
  253.               by spaces.  See ccii(1) for details.
  254.  
  255. DDIIAAGGNNOOSSTTIICCSS
  256.        The RCS pathname and the revisions outdated are written to
  257.        the diagnostic output.  The exit status is zero if and
  258.        only if all operations were successful.
  259.  
  260.  
  261.  
  262. GNU                         1992/07/28                          4
  263.  
  264.  
  265.  
  266.  
  267.  
  268. RCS(1)                                                     RCS(1)
  269.  
  270.  
  271. IIDDEENNTTIIFFIICCAATTIIOONN
  272.        Author: Walter F. Tichy.
  273.        Revision Number: 5.9; Release Date: 1992/07/28.
  274.        Copyright 1982, 1988, 1989 by Walter F. Tichy.
  275.        Copyright 1990, 1991, 1992 by Paul Eggert.
  276.  
  277. SSEEEE AALLSSOO
  278.        co(1), ci(1), ident(1), rcsdiff(1), rcsintro(1),
  279.        rcsmerge(1), rlog(1), rcsfile(5)
  280.        Walter F. Tichy, RCS--A System for Version Control,
  281.        _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 1155, 7 (July 1985),
  282.        637-654.
  283.  
  284. BBUUGGSS
  285.        The separator for revision ranges in the --oo option used to
  286.        be -- instead of ::, but this leads to confusion when
  287.        symbolic names contain --.  For backwards compatibility rrccss
  288.        --oo still supports the old -- separator, but it warns about
  289.        this obsolete use.
  290.  
  291.        Symbolic names need not refer to existing revisions or
  292.        branches.  For example, the --oo option does not remove
  293.        symbolic names for the outdated revisions; you must use --nn
  294.        to remove the names.
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328. GNU                         1992/07/28                          5
  329.  
  330.  
  331.