CDC(1) DOMAIN/IX SYS5 CDC(1)
NAME
cdc - change the delta commentary of an SCCS delta
USAGE
cdc -rSID [ -m [ mrlist ]] [ -y [ comment ]] files
DESCRIPTION
Cdc changes the delta commentary for a specific SID of each
named file. Delta commentary is defined to be the Modifica-
tion Request (MR) and comment information normally specified
via the -m and -y arguments to the delta(1) command.
If a directory is named, cdc behaves as though each file in
the directory is specified as a named file, except that it
silently ignores non-SCCS and unreadable files. If a name
of - is given, cdc reads the standard input. It takes each
line of the standard input to be the name of an SCCS file to
be processed.
Arguments to cdc, which may appear in any order, consist of
options and filenames. All options described below apply
independently to each named file.
OPTIONS
-rSID Specify the SCCS IDentification string (SID)
of a delta for which the delta commentary is
to be changed.
-m [mrlist] Supply a list of MR numbers to be added
and/or deleted in the delta commentary of the
SID specified by the -r option. The SCCS
file must have the v flag set. A null MR
list has no effect.
MR entries are added to the list of MRs in
the same manner as that of delta(1). To
delete an MR, precede the MR number with an
exclamation point (!). If the MR to be
deleted exists in the current 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.
This list is preceded by a comment line stat-
ing that the MRs were deleted.
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 termi-
nal, no prompt is issued. The MRs? prompt
Printed 12/4/86 CDC-1
CDC(1) DOMAIN/IX SYS5 CDC(1)
always precedes the comments? prompt (see the
-y option).
MRs in a list are separated by blanks and/or
tab characters. An unescaped newline charac-
ter terminates the MR list.
Note that, if the v flag has a value, it is
taken to be the name of a program (or Shell
procedure) that validates the correctness of
the MR numbers. If a non-zero exit status is
returned from the MR number validation pro-
gram, cdc terminates and the delta commentary
remains unchanged.
-y [comment] Supersede the existing comment(s) for the
delta specified by the -r option. The previ-
ous comments are kept, but preceded by a com-
ment line stating that they were changed. A
null comment has no effect. If -y is not
specified, and the standard input is a termi-
nal, the prompt comments? is issued on the
standard output before the standard input is
read. If the standard input is not a termi-
nal, no prompt is issued. An unescaped new-
line character terminates the comment text.
EXAMPLE
To add bl78-12345 and bl79-00001 to the MR list, remove
bl77-54321, and add the comment ``trouble'' to delta 1.6 of
s.file:
# cdc -r1.6 -m``bl78-12345 !bl77-54321 bl79-00001''
-ytrouble s.file
CAUTIONS
If you supply SCCS filenames to cdc via the standard input
(- on the command line), then you must also use the -m and
-y options.
To modify the delta commentary, you must be either the crea-
tor of the delta, or the owner of the SCCS file and direc-
tory.
FILES
x-file see delta(1).
z-file see delta(1).
CDC-2 Printed 12/4/86
CDC(1) DOMAIN/IX SYS5 CDC(1)
DIAGNOSTICS
Use help(1) for explanations.
RELATED INFORMATION
admin(1), delta(1), get(1), help(1), prs(1), sccsfile(4).
Printed 12/4/86 CDC-3