home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / PROG / UTILITY / DOSRCSMP.ZIP / RCS.MAN < prev    next >
Encoding:
Text File  |  1990-08-22  |  7.8 KB  |  265 lines
  1.  
  2.  
  3.  
  4.                                                           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 con-
  18.      trol attributes.  For rcs 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, 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 omit-
  48.                 ted, the default branch is reset to the (dynami-
  49.                 cally) 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.                                                                 1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. 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.  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 strict. 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.      -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. 2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                                           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 omit-
  156.                 ted, rcs 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.                 txtfile.  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.  Rcs creates a semaphore file
  175.      in the same directory as the RCS file to prevent simultane-
  176.      ous update.  For changes, rcs always creates a new file. On
  177.      successful completion, rcs 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 Proceedings of the 6th
  192.  
  193.  
  194.  
  195.                                                                 3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. 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. 4
  262.  
  263.  
  264.  
  265.