CDC(CP) XENIX System V CDC(CP)
Name
cdc - Changes the delta commentary of an SCCS delta.
Syntax
cdc -rSID [-m[mrlist]] [-y[comment]] files
Description
cdc changes the delta commentary for the SID specified by
the -r option, of each named SCCS file.
delta commentary is defined to be the Modification Request
(MR) and comment information normally specified via the
delta(CP) command (-m and -y options).
If a directory is named, cdc behaves as though each file in
the directory were specified as a named file, except that
nonSCCS files (last component of the pathname does not begin
with s.) and unreadable files are silently ignored. If a
name of - is given, the standard input is read (see
Warning); each line of the standard input is taken to be the
name of an SCCS file to be processed.
Arguments to cdc, which may appear in any order, consist of
options and file names.
All the described options apply independently to each named
file:
-rSID Used to specify the SCCS IDentification
(SID) string of a delta for which the
delta commentary is to be changed.
-m[mrlist] If the SCCS file has the v flag set (see
admin(CP)) then a list of MR numbers to
be added and/or deleted in the delta
commentary of the SID specified by the
-r option may be supplied. A null MR
list has no effect.
MR entries are added to the list of MRs
in the same manner as that of delta(CP).
In order to delete an MR, precede the MR
number with the character ! (see
Examples). If the MR to be deleted is
currently in the list of MRs, it is
removed and changed into a ``comment''
line. A list of all deleted MRs is
placed in the comment section of the
delta commentary and preceded by a
comment line stating that they were
deleted.
Page 1 (printed 8/7/87)
CDC(CP) XENIX System V CDC(CP)
If -m is not used and the standard input
is a terminal, the prompt MRs? is issued
on the standard output before the
standard input is read; if the standard
input is not a terminal, no prompt is
issued. The MRs? prompt always precedes
the comments? prompt (see -y option).
MRs in a list are separated by blanks
and/or tab characters. An unescaped
newline character terminates the MR
list.
Note that if the v flag has a value (see
admin(CP)), it is taken to be the name
of a program (or shell procedure) which
validates the correctness of the MR
numbers. If a nonzero exit status is
returned from the MR number validation
program, cdc terminates and the delta
commentary remains unchanged.
-y[comment] Arbitrary text used to replace the
comment(s) already existing for the
delta specified by the -r option. The
previous comments are kept and preceded
by a comment line stating that they were
changed. A null comment has no effect.
If -y is not specified and the standard
input is a terminal, the prompt
``comments?'' is issued on the standard
output before the standard input is
read; if the standard input is not a
terminal, no prompt is issued. An
unescaped newline character terminates
the comment text.
In general, if you made the delta, you can change its
delta commentary; or if you own the file and directory
you can modify the delta commentary.
Examples
The following:
cdc -r1.6 -m"bl78-12345 !bl77-54321 bl79-00001"
-ytrouble s.file
adds bl78-12345 and bl79-00001 to the MR list, removes
bl77-54321 from the MR list, and adds the comment trouble to
delta 1.6 of s.file.
Page 2 (printed 8/7/87)
CDC(CP) XENIX System V CDC(CP)
The following interactive sequence does the same thing.
cdc -r1.6 s.file
MRs? !bl77-54321 bl78-12345 bl79-00001
comments? trouble
Warning
If SCCS file names are supplied to the cdc command via the
standard input (- on the command line), then the -m and -y
options must also be used.
Files
x-file See delta(CP)
z-file See delta(CP)
See Also
admin(CP), delta(CP), get(CP), help(CP), prs(CP),
sccsfile(F)
Diagnostics
Use help(CP) for explanations.
Page 3 (printed 8/7/87)