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 Modification 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 stating 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 terminal, no prompt is issued. The MRs? prompt always precedes the comments? prompt (see the −y option). MRs in a list are separated by blanks and/or tab characters. An unescaped newline character 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 program, cdc terminates and the delta commentary remains unchanged.
−y [comment] Supersede the existing comment(s) for the delta specified by the −r option. The previous comments are kept, but 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 newline 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 (1) the creator of the delta, or (2) the owner of the SCCS file and directory.
FILES
x-file see delta (1).
z-file see delta (1).
DIAGNOSTICS
Use help (1) for explanations.