rcs.1 (2010 09)

r
rcs(1) rcs(1)
NAME
rcs - change RCS file attributes
SYNOPSIS
rcs [options ] file...
DESCRIPTION
rcs creates new RCS files or changes attributes of existing ones. An RCS file contains multiple revisions
of text, an access list, a change log, descriptive text, and some control attributes. For
rcs to work, the
user’s login name must be on the access list, except if the access list is empty, if the user is the owner of
the file or the superuser, or if the
-i option is present.
The user of the command must have read/write permission for the directory containing the RCS file and
read permission for the RCS file itself.
rcs creates a semaphore file in the same directory as the RCS
file to prevent simultaneous update. For changes,
rcs always creates a new file. On successful comple-
tion,
rcs deletes the old one and renames the new one. This strategy makes links to RCS files useless.
Files ending in
,v are RCS files; all others are working files. If a working file is given,
rcs tries to find
the corresponding RCS file first in directory
./RCS, then in the current directory, as explained in rcsin-
tro(5).
Options
rcs recognizes the following options:
-alogins Appends the login names appearing in the comma-separated list logins to the access
list of the RCS file.
-Aoldfile Appends the access list of oldfile to the access list of the RCS file.
-c "string" Sets the comment leader to string . The comment leader is printed before every log
message line generated by the keyword $Log$ during check out (see co (1)). This
is useful for programming languages without multi-line comments. During rcs
-i or initial ci, the comment leader is guessed from the suffix of the working file.
Note, a comment leader is inserted at the beginning of each line of log information.
The comment leader is determined by the suffix used with the file name, as in foo.c,
or foo.sh, or foo.p. Note you can specify a different comment leader through the
"rcs" command. The following table shows the comment leader associated with each
file name suffix:
SUFFIX FILES Comment Character
c c ’*’
C C Header ’*’
sh shell ’#’
s Assembly ’#’
p pascal ’*’
r ratfor ’#’
e efl ’#’
l lex ’*’
y yacc ’*’
yr yacc-rarfor ’*’
ye yacc-efl ’*’
ml mocklisp ’;’
mac macro ’;’
f fortran ’c’
ms ms-macros ’\’
me me-macros ’\’
"" empty suffix ’#’
nil unknown suffix ’""’
-e[ logins ] Erases the login names appearing in the comma-separated list logins from the
access list of the RCS file. If logins is omitted, the entire access list is erased.
-i Creates and initializes a new RCS file, but does not deposit any revision. If the RCS
file has no path prefix, rcs tries to place it first into the subdirectory ./RCS, then
into the current directory. If the RCS file already exists, an error message is
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1