cdc(1)                                                     cdc(1)



NAME
     cdc - changes the delta commentary of an SCCS delta

SYNOPSIS
     cdc [-m[mrlist]] -r SID [-y[comment]] file...

ARGUMENTS
     file Specifies the file to be changed.  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.

     -m[mrlist]
          Allows you to supply a list of MR numbers to be added
          and/or deleted in the delta commentary of the SID
          specified by the -r option, if the SCCS file has the v
          option set (see admin(1)).  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).  In order 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 the -m option 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 option has a value (see admin(1)),
          it is taken to be the name of a program (or shell
          procedure) that validates the correctness of the MR
          numbers.  If a nonzero exit status is returned from the
          MR number validation program, cdc terminates and the
          delta commentary remains unchanged.

     -r SID
          Specifies the SCCS Identification (SID) string of a
          delta for which the delta commentary is to be changed.

     -y[comment]
          Specifies arbitrary text used to replace the comment(s)



January 1992                                                    1

cdc(1)                                                     cdc(1)



          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 the -y option 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.

DESCRIPTION
     cdc changes the ``delta commentary'', for the SID specified
     by the -r option, of each named SCCS file.

     A ``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.

     The exact permissions necessary to modify the SCCS file are
     documented in the ``SCCS Reference'' in A/UX Programming
     Languages and Tools, Volume 2.  Simply stated, they are
     either (1) if you made the delta, you may change its delta
     commentary; or (2) if you own the file and directory, you
     may modify the delta commentary.

EXAMPLES
     The command:

        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:

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

     does the same thing.





2                                                    January 1992

cdc(1)                                                     cdc(1)



STATUS MESSAGES AND VALUES
     Use help for explanations.

WARNINGS
     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.

FILES
     /usr/bin/cdc
          Executable file

SEE ALSO
     admin(1), delta(1), get(1), help(1), prs(1)

     sccsfile(4) in A/UX Programmer's Reference

     ``SCCS Reference'' in A/UX Programming Languages and Tools,
     Volume 2




































January 1992                                                    3