NAME

cdc − change the delta commentary of an SCCS delta

SYNOPSIS

cdc −r SID −m[mrlist]] [ −y[comment]] file ...

DESCRIPTION

Cdc changes the delta commentary for the SID specified by the −r option, of each named SCCS 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 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 ­WARNINGS); each line of the standard input is taken to be the name of an SCCS file to be processed. 

OPTIONS

Options apply independently to each named file

−rSID
Specifies the SCCS IDentification (SID) string of a delta for which the delta commentary is to be changed. 

−mmrlist
If the SCCS file has the v flag set (see admin(1)), a list of MR numbers to be added and/or deleted in the delta commentary of the SID specified by the −r option may be supplied.  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 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, cdc displays the prompt MRs?, and waits for you to type MRs. No prompt is issued if the standard input is not a terminal.  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) which 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. 

−ycomment
Arbitrary text which replaces the comment(s) already existing 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, cdc displays a comments? prompt and waits for you to type comments.  No prompt is issued if the standard input is not a terminal.  An unescaped new-line character terminates the comment text. 

The exact permissions necessary to modify the SCCS file are documented in the Source Code Control System User’s Guide. Simply stated, they are either (1) you can change a delta commentary if you made the delta, or (2) you can modify the delta commentary if you own the file and directory.

EXAMPLES

cdc −r1.6 −m"bl78-12345 !bl77-54321 bl79-00001" −ytrouble s.file

adds bl78-12345 and bl79-00001 to the MR list, removes bl77-54321 from the MR list, and adds the comment trouble to delta 1.6 of s.file. 

cdc −r1.6 s.file
MRs? !bl77-54321 bl78-12345 bl79-00001
comments? trouble

does the same thing. 

WARNINGS

If SCCS file names are supplied to the cdc command via the standard input (− on the command line), the −m and −y options 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(5). 
Source Code Control System User’s Guide by L. E. Bonanni and C. A. Salemi. 
An Introduction to the Source Code Control System, by Eric Allman. 

DIAGNOSTICS

Use help(1) for explanations.

Sun System Release 0.3  —  14 April 1983