NAME

cdc − change the delta commentary of an SCCS delta

SYNOPSIS

/usr/sccs/cdc −rSID [ −m [ mrlist ] ] [ −y [ comment ] ] filename ...

DESCRIPTION

cdc changes the delta commentary, for the SID (SCCS ID) 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 by the delta(1) command. 

If a directory is named, cdc behaves as though each file in the directory were specified, except that non-SCCS files (last component of the path name does not begin with ‘s.’) and unreadable files are silently ignored.  If a filename of ‘-’ is given, each line of the standard input is taken to be the name of an SCCS file to be processed, and the −m and −y options must be used. 

Permissions

If you made the delta, you can normally change its delta commentary, or if you own the file and directory, and have write permission, you can modify the delta commentary. 

OPTIONS

Arguments to cdc, which may appear in any order, consist of options and file names. 

Each option applies independently to each filename.

−rSID Specify the (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)), 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 (see EXAMPLES).  A null MR list has no effect. 

MR 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 ‘!’.  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 the −y option). 

MRs in a list are separated by SPACE and/or TAB characters.  An unescaped NEWLINE character terminates the MR list. 

Note: if the v flag has a value 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. 

−y [ comment ] Arbitrary text used to replace a comment already existing for the specified delta.  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 NEWLINE character terminates the comment text. 

EXAMPLES

The following command:

example% 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. 

The command:

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

does the same thing. 

FILES

x-file (see delta(1))

z-file (see delta(1))

SEE ALSO

admin(1), comb(1), delta(1), get(1), help(1), prs(1), sccs(1), sccsdiff(1), val(1), what(1), sccsfile(5)

Programming Utilities and Libraries. 

DIAGNOSTICS

Use help(1) for explanations. 

Sun Release 4.0  —  Last change: 9 September 1987