cdc(1)                                                               cdc(1)




 NAME    [Toc]    [Back]
      cdc - change the delta commentary of an SCCS delta

 SYNOPSIS    [Toc]    [Back]
      cdc -r SID [-m[mrlist]] [-y[comment]] files

 DESCRIPTION    [Toc]    [Back]
      The cdc command 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 if 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    [Toc]    [Back]
      Arguments to cdc, which can appear in any order, consist of option
      arguments and file names.

      All of the described option arguments 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.

           -m[mrlist]     If the SCCS file has the v option 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, the prompt MRs?  is issued on the
                          standard output before the standard input is read;



 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003






 cdc(1)                                                               cdc(1)




                          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 MRs list.

                          Note that if the v option has a value (see
                          admin(1)), it is treated as 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]    Arbitrary text used to replace the comment or
                          comments already existing for the delta specified
                          by the -r option.  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 standard input is read; if
                          standard input is not a terminal, no prompt is
                          issued.  An unescaped new-line character
                          terminates the comment text.

      The exact permissions necessary to modify the SCCS file are documented
      in get(1).  Simply stated, they are either:

           +  If you made the delta, you can change its delta commentary, or

           +  If you own the file and directory, you can modify the delta
              commentary.

 EXTERNAL INFLUENCES    [Toc]    [Back]
    Environment Variables
      LANG determines the language in which messages are displayed.

    International Code Set Support    [Toc]    [Back]
      Single- and multi-byte character code sets are supported.

 DIAGNOSTICS    [Toc]    [Back]
      Use sccshelp(1) for explanations.

 EXAMPLES    [Toc]    [Back]
      Add bl78-12345 and bl79-00001 to the MR list, remove bl77-54321 from
      the MR list, and add the comment trouble to delta 1.6 of s.file:




 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003






 cdc(1)                                                               cdc(1)




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

      The following does the same thing:

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

 WARNINGS    [Toc]    [Back]
      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    [Toc]    [Back]
      x-file    See delta(1).
      z-file    See delta(1).

 SEE ALSO    [Toc]    [Back]
      admin(1), delta(1), get(1), sccshelp(1), prs(1), sccsfile(4),
      rcsfile(4), acl(5), rcsintro(5).


 Hewlett-Packard Company            - 3 -   HP-UX 11i Version 2: August 2003