cdc(1)
_________________________________________________________________
cdc Command
change 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
keyletter of each named SID file.
Delta commentary is defined to be the Modification Request (MR)
and comment information normally specified via the delta(1)
command (-m and -y keyletters).
If a directory is named, cdc behaves as though each file in the
directory were specified as a named file, except that non-SCCS
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 "WARNINGS"); each line of the
standard input is taken to be the name of an SCCS file to be
processed.
Arguments to cdc can appear in any order. They consist of
keyletter arguments and filenames.
All the described keyletter arguments apply independently to each
named file:
-rSID
Specifies the SCCS IDentification (ID) 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(1)), then
you can supply a list of MR numbers to be added and/or
deleted in the delta commentary of the SID specified by the
-r keyletter. A null MR list has no effect. MR entries are
added to the list of MRs as in delta(1). 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.
DG/UX 4.00 Page 1
Licensed material--property of copyright holder(s)
cdc(1)
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 keyletter). MRs 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 MR numbers. If a non-zero exit status is
returned from the MR number validation
program, cdc terminates and the delta
commentary remains unchanged.
-y[comment] Arbitrary text that replaces the current
comment(s) 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.
The exact permissions necessary to modify the SCCS file are
documented in Programmer's Guide to the DG/UX System.
Simply stated, they are either (1) if you made the delta,
you can change its delta commentary; or (2) if you own the
file and directory, you can modify the delta commentary.
EXAMPLES
cdc -r1.6 -m"bl78-12345 !bl77-54321 bl79-00001" -ytrouble
s.file
cdc -r1.6 s.file
MRs? !bl77-54321 bl78-12345 bl79-00001
comments? trouble
Both examples add bl78-12345 and bl79-00001 to the MR list,
DG/UX 4.00 Page 2
Licensed material--property of copyright holder(s)
cdc(1)
remove bl77-54321 from the MR list, and add the comment trouble
to delta 1.6 of s.file.
WARNINGS
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.
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(1) for explanations of error messages.
DG/UX 4.00 Page 3
Licensed material--property of copyright holder(s)