Intel XENIX 286 Programmers Guide (86) - Tenox.tc

XENIX Programming SCCS: Source Code Control System
Adding Comments
You can add comments to an s-file by using the -y option of the delta and admin
commands. This option causes the given text to be copied to the s-file as the comment
for the new version. The comment may be any combination of letters, digits, and
punctuation symbols. No embedded newline characters are allowed. If spaces are used,
the comment must be enclosed in double quotes. The complete command must fit on
one line. For example, the command
delta -y"George Wheeler" s.demo.c
saves the comment "George Wheeler" in the s-file s.demo.c.
The -y option is typically used in shell procedures as part of an automated approach to
maintaining files. When the -y option is used, the delta command does not print the
corresponding comment prompt, so no interaction is required. If more than one s-file is
given in the command line, the given comment applies to them all.
Changing Comments
You can change the comments in an s-file by using the cdc command. The command has
the form
cdc -rSID s. filename
where -rSID gives the SID of the version with the comment to be changed, and
s.filename is the name of the s-file containing the version. The command asks for a new
comment by displaying the prompt
comments?
You may type any sequence of characters up to 512 characters long. The sequence may
contain embedded newline characters if each such newline character is preceded by a
backslash {\}. The sequence must be terminated with a newline character. For example,
the command
cdc -r3.4 s.demo.c
prompts for a new comment for version 3.4.
Although the command does not delete the old comment, it is no longer directly
accessible by the user. The new comment contains the login name of the user who
invoked the cdc command and the time the comment was changed.
5-17