cdc(1) cdc(1)
NAME
cdc - change the delta comment of an SCCS delta
SYNOPSIS
cdc -r SID [-m [MR-list]] [-y[comment]] file...
DESCRIPTION
cdc (change delta comment) changes the delta comment, for the SID
(SCCS identification string) specified by the -r keyletter, of each
named SCCS file.
The delta comment consists of the Modification Request (MR) and com-
ment information normally specified in a delta command (-m and -y
keyletters).
If file is a directory, cdc behaves as though each file in the direc-
tory were specified as a named file, except that non-SCCS files [see
admin(1)] and unreadable files are ignored without comment. If a name
of - is given, the standard input is read and each line of the stan-
dard 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 keyletter
arguments and filenames.
All the described keyletter arguments apply independently to each
named file:
-rSID
Used to specify the SCCS identification (SID) string of a delta
for which the delta comment is to be changed.
-mMR-list
If the SCCS file has the v flag set [see admin(1)] then a list of
MR numbers to be added and/or deleted in the delta comment of the
SID specified by the -r keyletter may be supplied. A null MR-list
has no effect.
MR numbers are added to the list of MRs in the same manner as
that of delta. In order to delete an MR, the MR number must be
preceded by the character ! (see the EXAMPLES section). 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 comment and preceded by a
comment line stating that they were deleted.
If -m is not used and the standard input is the keyboard, the
prompt MRs? is issued on the standard output before the standard
input is read; if the standard input is not the keyboard, no
prompt is issued. The MRs? prompt always precedes the comments?
prompt (see -y).
Entries in the MR-list are separated by blanks and/or tab
Page 1 Reliant UNIX 5.44 Printed 11/98
cdc(1) cdc(1)
characters. An unescaped newline character terminates the MR-
list.
If the flag v has a value [see admin(1)], 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 validation program, cdc terminates and the
delta comment remains unchanged.
-y[comment]
Arbitrary text which replaces the comments which previously
existed for the delta specified by the -r keyletter.
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 the keyboard,
the prompt comments? is issued on the standard output before the
standard input is read; if the standard input is not the key-
board, no prompt is issued. An unescaped newline character ter-
minates the comment text.
If you made the delta and have the appropriate file permissions, you
can change its delta comment.
EXAMPLES
The input
cdc -r1.6 -m"bl88-12345 !bl87-54321 bl89-00001" -ytrouble s.file
adds bl88-12345 and bl89-00001 to the MR list, removes bl87-54321 from
the MR list, and adds the comment trouble to delta 1.6 of s.file.
The following input produces the same result:
cdc -r1.6 s.file
MRs? !bl87-54321 bl88-12345 bl89-00001
comments? trouble
NOTES
If SCCS filenames are supplied to the cdc command via the standard
input (- on the command line), then the -m and -y keyletters must also
be used.
FILES
x-file [see delta(1)]
z-file [see delta(1)]
SEE ALSO
admin(1), delta(1), get(1), help(1), prs(1), sccsfile(4).
Page 2 Reliant UNIX 5.44 Printed 11/98