cdc(CP)                        6 January 1993                        cdc(CP)


 Name

    cdc - change the delta commentary of an SCCS delta

 Syntax

    cdc -rSID [-m[mrlist]] [-y[comment]] files
    cdc -rSID -m[mrlist] -y[comment] -

 Description

    The cdc command changes the delta commentary, for the SID (SCCS identifi-
    cation string) specified by the -r option, of each named SCCS file.

    Delta commentary is defined to be the Modification Request (MR) and com-
    ment information normally specified via the delta(CP) command's -m and -y
    options.

    If a directory is named, cdc treats each file in the directory as if it
    had been specified as a named file, except that non-SCCS files and
    unreadable files are silently ignored.  If a name of - is given, cdc
    reads standard input (see ``Warnings'' below) and each line of standard
    input is taken to be the name of an SCCS file to be processed.

    All the described options apply independently to each named file:

    -rSID        Used to specify 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(CP)) then 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 sup-
                 plied.  A null MR list has no effect.

                 MR entries are added to the list of MRs in the same manner
                 as that of delta(CP).  In order to delete an MR, precede the
                 MR number with the character ``!'' (see ``Examples'' below).
                 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 standard output before 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(CP)), it is
                 taken to be the name of a program (or shell procedure) which
                 validates 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 the comment(s) already exist-
                 ing 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 standard input is a terminal, the
                 prompt comments? is issued on standard output before stan-
                 dard input is read; if standard input is not a terminal, no
                 prompt is issued.  An unescaped new-line character ter-
                 minates the comment text.

                 Simply stated, if you made the delta, or you own the file
                 and directory, you can modify the delta commentary.

 Examples

         cdc -r1.6 -m"bl78-12 !bl77-54 bl79-01" -ytrouble s.file

    adds bl78-12 and bl79-01 to the MR list, removes bl77-54 from the MR
    list, and adds the comment trouble to delta 1.6 of s.file.

    The same thing can be done as follows:
         cdc -r1.6 s.file
         MRs? !bl77-54 bl78-12 bl79-01
         comments? trouble

 Files


    x-file    (see delta(CP))

    z-file    (see delta(CP))

 Warnings

    If SCCS file names are supplied to cdc via standard input (using - on the
    command line), then the -m and -y option must also be used.

 See also

    admin(CP), delta(CP), get(CP), prs(CP), sccsfile(FP)