cdc(1) DG/UX 5.4R3.00 cdc(1)
NAME
cdc - change the delta commentary of an SCCS delta
SYNOPSIS
cdc -rSID [-m[mrlist]] [-y[comment]] files
DESCRIPTION
Cdc changes the delta commentary for the SID specified by the -r
option 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 options).
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 options
and filenames.
All the described options 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 option.
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.
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
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.
Licensed material--property of copyright holder(s) 1
cdc(1) DG/UX 5.4R3.00 cdc(1)
-y[comment]
Arbitrary text that replaces the current comment(s) 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 new-line
character terminates the comment text.
The exact permissions necessary to modify the SCCS file are
documented in Programmer's Guide: ANSI C and Programming Support
Tools. 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,
remove bl77-54321 from the MR list, and add the comment
trouble to delta 1.6 of s.file.
FILES
x-file (see delta(1))
z-file (see delta(1))
DIAGNOSTICS
Use help(1) for explanations of error messages.
SEE ALSO
admin(1), comb(1), delta(1), get(1), help(1), prs(1), sccsfile(4).
NOTES
If SCCS filenames are supplied to the cdc command via the standard
input (- on the command line), then the -m and -y options must also
be used.
Licensed material--property of copyright holder(s) 2