cdc

PURPOSE

     Changes  the comments  in  a Source  Code Control  System
     (SCCS) delta.

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


DESCRIPTION

     The cdc  command changes the Modification  Requests (MRs)
     and comments  for the  SID specified by  the -r  flag for
     each named  Source Code  Control System (SCCS)  file.  If
     you specify a directory  name, cdc performs the requested
     actions on all SCCS files in that directory (that is, all
     files  with  names that  have  the  s. prefix).   If  you
     specify a - (minus) in  place of file, cdc reads standard
     input and  interprets each  line as the  name of  an SCCS
     file.  For more information  on SCCS comments and Modifi-
     cation  Requests, see  AIX  Operating System  Programming
     Tools and Interfaces.

     You can  change the comments and  MRs for an SID  only if
     you made the  SID or you own the file  and the directory.
     For more information on  the permissions needed to change
     SCCS files, see "SCCS Files."

FLAGS

     -m[mrlist]   Supplies a list of MR numbers for cdc to add
                  or  delete in  the SID  specified by  the -r
                  flag.   You can  only use  this flag  if the
                  file  has   the  v  header  flag   set  (see
                  Figure 1).  A null MR list has no effect.

                  In the mrlist, MRs  are separated by blanks,
                  tab characters,  or both.  To delete  an MR,
                  precede the MR number with an ! (exclamation
                  point).   If the  MR you  want to  delete is
                  currently in the list  of MRs, it is changed
                  into a  comment line.  cdc places  a list of
                  all deleted  MRs in  the comment  section of
                  the delta  and precedes them with  a comment
                  line indicating that  the following MRs were
                  deleted.

                  If you do not specify the -m flag, and the v
                  header  flag  is  set,  MRs  are  read  from

                  standard input.  If standard input is a work
                  station, cdc  prompts you  for the  MRs. The
                  first new-line  character not preceded  by a
                  backslash ends the list on the command line.
                  cdc continues  to take input until  it reads
                  an end-of-file character (Ctrl-D) or a blank
                  line.  MRs  are always read  before comments
                  (see the -y flag).

                  If the  v flag  has a value,  cdc interprets
                  the  value as  the name  of a  program which
                  validates the MR numbers.   If the MR number
                  validation  program returns  a nonzero  exit
                  value,  cdc stops  and does  not change  the
                  MRs.
     -rSID        Specifies the SCCS  identification number of
                  the delta for which cdc will change the com-
                  ments or MRs.
     -y[comment]  Specifies  text   to  replace   any  comment
                  already existing for  the delta specified by
                  the -r  flag.  cdc  keeps the  existing com-
                  ments and  precedes them  by a  comment line
                  stating  that  they  were changed.   A  null
                  comment has no effect.

                  If you do not specify -y, cdc reads comments
                  from standard  input until it reads  an end-
                  of-file character.  If the standard input is
                  a work station, cdc prompts for the comments
                  and also  allows a blank line  to end input.
                  If the last  character of a line  is a back-
                  slash (\),  cdc ignores it and  continues to
                  read standard input.

                  Note:  If cdc reads  standard input for file
                  names (that is, when you specify a file name
                  of -), you must use the -y and -m flags.

RELATED INFORMATION

     The  following  commands:    "admin,"   "delta,"  "get,"
     "help," and  "prs."

     The sccsfile file in  AIX Operating System Technical Ref-
     erence.

     The discussion  of SCCS in AIX  Operating System Program-
     ming Tools and Interfaces.