CDC(1-SVR4) RISC/os Reference Manual CDC(1-SVR4)
NAME
cdc - change the delta comment of an SCCS delta
SYNOPSIS
cdc -r SID [-m[mrlist] ] [ -y[comment] ] file...
DESCRIPTION
cdc changes the delta comment, for the SID (SCCS identifica-
tion string) specified by the -r keyletter, of each named
SCCS file.
The delta comment is the Modification Request (MR) and com-
ment information normally specified via the -m and -y
keyletters of the delta command.
If file is a directory, cdc behaves as though each file in
the directory were specified as a named file, except that
non-SCCS files (last component of the path name does not
begin with s.) and unreadable files are silently ignored.
If a name of - is given, the standard input is read (see the
NOTES section) and 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
keyletter arguments and file names.
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.
-mmrlist 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.
mrlist entries are added to the list of MRs
in the same manner as that of delta. In
order to delete an MR, precede the MR number
with the character ! (see the EXAMPLES sec-
tion). 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 a
terminal, the prompt MRs? is issued on the
Printed 11/19/92 Page 1
CDC(1-SVR4) RISC/os Reference Manual CDC(1-SVR4)
standard output before the standard input is
read; if the standard input is not a termi-
nal, no prompt is issued. The MRs? prompt
always precedes the comments? prompt (see -y
keyletter).
mrlist entries in a list are separated by
blanks and/or tab characters. An unescaped
new-line character terminates the MR list.
Note that if the v flag 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 MR
number validation program, cdc terminates and
the delta comment remains unchanged.
-y[comment] Arbitrary text used to replace the comment(s)
already existing 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 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
new-line character terminates the comment
text.
If you made the delta and have the appropriate file permis-
sions, you can change its delta comment. If you own the
file and directory you can modify the delta comment.
Page 2 Printed 11/19/92
CDC(1-SVR4) RISC/os Reference Manual CDC(1-SVR4)
EXAMPLES
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.
Entering:
cdc -r1.6 s.file
MRs? !bl87-54321 bl88-12345 bl89-00001
comments? trouble
produces the same result.
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).
DIAGNOSTICS
Use help for explanations.
NOTES
If SCCS file names are supplied to the cdc command via the
standard input (- on the command line), then the -m and -y
keyletters must also be used.
Printed 11/19/92 Page 3