cdc(1) — bsd

CDC(1)                               BSD                                CDC(1)



NAME
     cdc - change the delta commentary of an SCCS delta

SYNOPSIS
     cdc -rSID [ -m[mrlist] ] [ -y[comment] ] file ...

DESCRIPTION
     cdc changes the delta commentary for a specific SID of each named file.
     Delta commentary is defined to be the modification request (MR) and
     comment information normally specified via the -m and -y arguments to the
     delta(1) command.

     If you specify a directory, cdc behaves as though each file in the
     directory is specified as a named file, except that it silently ignores
     non-SCCS and unreadable files.  If you specify a name of -, cdc reads the
     standard input.  It takes each line of the standard input to be the name
     of an SCCS file to be processed.

     Arguments to cdc, which may appear in any order, consist of options and
     filenames.  All options described below apply independently to each named
     file.

OPTIONS
     -rSID          Specify the SCCS identification string (SID) of a delta
                    for which the delta commentary is to be changed.

     -m[mrlist]     Supply a list of MR numbers to be added and/or deleted in
                    the delta commentary of the SID specified by the -r
                    option.  The SCCS file must have the v flag set.  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 an exclamation point (!).  If the MR to be
                    deleted exists in the current list of MRs, cdc removes it
                    and changes it into a "comment" line.  cdc places a list
                    of all deleted MRs in the comment section of the delta
                    commentary, preceding the list by a comment line stating
                    that the MRs were deleted.

                    If you do not specify -m, and the standard input is a
                    terminal, cdc issues the prompt "MRs?" on the standard
                    output before it reads the standard input.  If the
                    standard input is not a terminal, cdc does not issue a
                    prompt.  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 flag has a value, 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.

     -y[comment]    Supersede the existing "comment(s)" for the delta
                    specified by the -r option.  The previous comments are
                    kept, but preceded by a comment line stating that they
                    were changed.  A null "comment" has no effect.  If you do

                    not specify -y, and the standard input is a terminal, cdc
                    issues the prompt "comments?" on the standard output
                    before it reads the standard input.  If the standard input
                    is not a terminal, cdc does not issue a prompt.  An
                    unescaped newline character terminates the "comment" text.

EXAMPLE
     To add bl78-12345 and bl79-00001 to the MR list, remove bl77-54321, and
     add the comment "trouble" to delta 1.6 of s.file:

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

BUGS
     If you supply SCCS filenames to cdc via the standard input (- on the
     command line), you must also use the -m and -y options.

     To modify the delta commentary, you must be either the creator of the
     delta or the owner of the SCCS file and directory.

FILES
     x-file    See delta(1).
     z-file    See delta(1).

DIAGNOSTICS
     Use help(1) for explanations.

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

Museum

Related Articles