home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / proglang / rcstxt.arj / RCS.MAN < prev    next >
Encoding:
Text File  |  1990-08-18  |  7.1 KB  |  265 lines
  1.  
  2.  
  3.  
  4.      RCS(1L)             Purdue University               RCS(1L)
  5.  
  6.  
  7.  
  8.      NAME
  9.       rcs -    change RCS file    attributes
  10.  
  11.      SYNOPSIS
  12.       rcs [    options    ] file ...
  13.  
  14.      DESCRIPTION
  15.       Rcs 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
  18.       control attributes.  For rcs to work,    the caller's login
  19.       name must be on the access list, except if the access    list
  20.       is empty, the    caller is the owner of the file    or the
  21.       superuser, 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, rcs tries to find the
  25.       corresponding    RCS file first in directory ./RCS and then in
  26.       the current directory, as explained in co(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, rcs 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.       -alogins   appends the login names appearing in the comma-
  36.              separated list logins to the access list of the
  37.              RCS file.
  38.  
  39.       -Aoldfile  appends the access    list of    oldfile    to the access
  40.              list of the RCS file.
  41.  
  42.       -e[logins] erases the    login names appearing in the comma-
  43.              separated list logins from    the access list    of the
  44.              RCS file.    If logins is omitted, the entire
  45.              access list is erased.
  46.  
  47.       -b[rev]    sets the default branch to    rev. If    rev is
  48.              omitted, the default branch is reset to the
  49.              (dynamically) highest branch on the trunk.
  50.  
  51.       -cstring   sets the comment leader to    string.    The comment
  52.              leader is printed before every log    message    line
  53.              generated by the keyword $Log$  during checkout
  54.              (see co(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[rev]    locks the revision    with number rev.  If a branch
  60.  
  61.  
  62.  
  63.      Page 1                         (printed 8/18/90)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      RCS(1L)             Purdue University               RCS(1L)
  71.  
  72.  
  73.  
  74.              is    given, the latest revision on that branch is
  75.              locked.  If rev 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[rev]    unlocks the revision with number rev.  If a
  81.              branch is given, the latest revision on that
  82.              branch is unlocked.  If rev is omitted, the
  83.              latest lock held by the caller is removed.
  84.              Normally, only the    locker of a revision may
  85.              unlock it.     Somebody else unlocking a revision
  86.              breaks the    lock. This causes a mail message to be
  87.              sent to the original locker.  The message
  88.              contains a    commentary solicited from the breaker.
  89.              The commentary is terminated with a line
  90.              containing    a single `.' or    control-D.
  91.  
  92.       -L         sets locking to strict. Strict locking means that
  93.              the owner of an RCS file is not exempt from
  94.              locking for checkin.  This    option should be used
  95.              for 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
  102.              administrator.
  103.  
  104.       -nname[:rev]
  105.              associates    the symbolic name name with the    branch
  106.              or    revision rev. Rcs prints an error message if
  107.              name is already associated    with another number.
  108.              If    rev is omitted,    the symbolic name is deleted.
  109.  
  110.       -Nname[:rev]
  111.              same as -n, except    that it    overrides a previous
  112.              assignment    of name.
  113.  
  114.       -orange    deletes ("outdates") the revisions    given by
  115.              range.  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 rev1-rev2 means
  119.              revisions rev1 to rev2 on the same    branch,    -rev
  120.              means from    the beginning of the branch containing
  121.              rev up to and including rev, and rev- means from
  122.              revision rev to the end of    the branch containing
  123.              rev.  None    of the outdated    revisions may have
  124.              branches or locks.
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                         (printed 8/18/90)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      RCS(1L)             Purdue University               RCS(1L)
  137.  
  138.  
  139.  
  140.       -q         quiet mode; diagnostics are not printed.
  141.  
  142.       -sstate[:rev]
  143.              sets the state attribute of the revision rev to
  144.              state. If rev is a    branch number, the latest
  145.              revision on that branch is    assumed.  If rev is
  146.              omitted, the latest revision on the default
  147.              branch is assumed.     Any identifier    is acceptable
  148.              for state.     A useful set of states    is Exp (for
  149.              experimental), Stab (for stable), and Rel (for
  150.              released).     By default, ci(1L) sets the state of
  151.              a revision    to Exp.
  152.  
  153.       -t[txtfile]
  154.              writes descriptive    text into the RCS file
  155.              (deletes the existing text).  If txtfile is
  156.              omitted, rcs prompts the user for text supplied
  157.              from the standard input, terminated with a    line
  158.              containing    a single `.' or    control-D.  Otherwise,
  159.              the descriptive text is copied from the file
  160.              txtfile.  If the -i option    is present,
  161.              descriptive text is requested even    if -t is not
  162.              given.  The prompt    is suppressed if the standard
  163.              input is 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
  174.       permission for the RCS file itself.  Rcs creates a semaphore
  175.       file in the same directory as    the RCS    file to    prevent
  176.       simultaneous update.    For changes, rcs always    creates    a new
  177.       file.    On successful completion, rcs deletes the old one and
  178.       renames the new one.    This strategy makes links to RCS files
  179.       useless.
  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 Proceedings of    the 6th
  192.  
  193.  
  194.  
  195.      Page 3                         (printed 8/18/90)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      RCS(1L)             Purdue University               RCS(1L)
  203.  
  204.  
  205.  
  206.       International    Conference on Software Engineering, 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.      Page 4                         (printed 8/18/90)
  262.  
  263.  
  264.  
  265.