HP-UX Reference (11i v3 07/02) - 1 User Commands N-Z (vol 2)

r
rcs(1) rcs(1)
-l[ rev ] Locks the revision with number rev. If a branch is given, the latest revision on that
branch is locked. If rev is omitted, the latest revision on the trunk is locked. Locking
prevents overlapping changes. A lock is removed with
ci or rcs -u (see below).
-L Sets locking to strict. Strict locking means that the owner of an RCS file is not
exempt from locking for check in. This option should be used for files that are shared.
-nname[:[ rev ]]
Associates the symbolic name name with the branch or revision rev.
rcs prints an
error message if name is already associated with another number. If rev is omitted,
the symbolic name is associated with the latest revision on the trunk. If
:rev is omit-
ted, the symbolic name is deleted.
-Nname[:[ rev ]]
Same as -n, except that it overrides a previous assignment of name.
-orange Deletes ("obsoletes") the revisions given by range. A range consisting of a single revi-
sion number means that revision. A range consisting of a branch number means the
latest revision on that branch. A range of the form rev1−rev2 means revisions rev1 to
rev2 on the same branch,
-rev means from the beginning of the branch containing rev
up to and including rev, and rev
- means from revision rev to the head of the branch
containing rev. None of the outdated revisions can have branches or locks.
-q Quiet mode; diagnostics are not printed.
-sstate[:rev ] Sets the state attribute of the revision rev to state.Ifrev is omitted, the latest revi-
sion on the trunk is assumed. If rev is a branch number, the latest revision on that
branch is assumed. Any identifier is acceptable for state. A useful set of states is
Exp (for experimental), Stab
(for stable), and Rel (for released). By default, ci
sets the state of a revision to Exp.
-t [ txtfile ] Writes descriptive text into the RCS file (deletes the existing text). If txtfile is omit-
ted,
rcs prompts the user for text supplied from the standard input, terminated
with a line containing a single . or Ctrl-D. Otherwise, the descriptive text is copied
from the file txtfile. If the -i option is present, descriptive text is requested even if
-t is not given. The prompt is suppressed if the standard input is not a terminal.
-u[rev] Unlocks the revision with number rev. If a branch is given, the latest revision on that
branch is unlocked. If rev is omitted, the latest lock held by the user is removed.
Normally, only the locker of a revision may unlock it. Somebody else unlocking a revi-
sion breaks the lock. This causes a mail message to be sent to the original locker.
The message contains a commentary solicited from the breaker. The commentary is
terminated with a line containing a single . or Control-D.
-U Sets locking to non-strict. Non-strict locking means that the owner of a file need not
lock a revision for check in. This option should not be used for files that are shared.
The default (-L or -U) is determined by the system administrator.
Access Control Lists (ACLs)
Do not add optional ACL entries to an RCS file, because they are deleted when the file is updated. The
resulting access modes for the new file might not be as desired.
DIAGNOSTICS
The RCS filename and the revisions outdated are written to the diagnostic output. The exit status always
refers to the last RCS file operated upon, and is 0 if the operation was successful; 1 if unsuccessful.
EXAMPLES
Add the names jane, mary, dave, and jeff to the access list of RCS file vision,v:
rcs -ajane,mary,dave,jeff vision
Set the comment leader to tab* for file vision:
rcs -c’tab*’ vision
Associate the symbolic name sso/6_0 with revision 38.1 of file vision:
rcs -Nsso/6_0:38.1 vision
HP-UX 11i Version 3: February 2007 − 2 − Hewlett-Packard Company 173