unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-4.1.3)
Page:
Section:
Apropos / Subsearch:
optional field

SCCS-CDC(1)                 General Commands Manual                SCCS-CDC(1)



NAME
       sccs-cdc, cdc - change the delta commentary of an SCCS delta

SYNOPSIS
       /usr/sccs/cdc -rsid [ -mmr-list ] [ -y [ comment ] ] s.filename ...

DESCRIPTION
       cdc  annotates  the delta commentary for the SCCS delta ID (SID) speci-
       fied by the -r option in each named s.file.

       If the v flag is set in the s.file, you can also use cdc to update  the
       Modification Request (MR) list.

       If  you checked in the delta, or, if you own the file and directory and
       have write permission, you can use cdc to annotate the commentary.

       Rather than replacing the existing commentary, cdc inserts the new com-
       ment you supply, followed by a line of the form:

              *** CHANGED *** yy/mm/dd hh/mm/ss username

       above the existing commentary.

       If  a  directory  is  named as the s.filename argument, the cdc command
       applies to all s.files in that directory.  Unreadable  s.files  produce
       an  error; processing continues with the next file (if any).  If `-' is
       given as the s.filename argument, each line of the  standard  input  is
       taken  as  the name of an SCCS history file to be processed, and the -m
       and -y options must be used.

OPTIONS
       -rsid  Specify the SID of the delta to change.

       -mmr-list
              Specify one or more MR numbers to add or delete.  When  specify-
              ing more than one MR on the command line, mr-list takes the form
              of a quoted, space-separated list.  To delete an MR number, pre-
              cede it with a !  character (an empty MR list has no effect).  A
              list of deleted MRs is placed in  the  comment  section  of  the
              delta commentary.  If -m is not used and the standard input is a
              terminal, cdc prompts with MRs?  for the  list  (before  issuing
              the  comments?   prompt).   -m is only useful when the v flag is
              set in the s.file.  If that flag has a value, it is taken to  be
              the name of a program to validate the MR numbers.  If that vali-
              dation program returns a non-zero exit  status,  cdc  terminates
              and the delta commentary remains unchanged.

       -y[comment] Use comment as the annotation in the delta commentary.  The
              previous comments are retained; the comment is added along  with
              a  notation  that  the  commentary  was changed.  A null comment
              leaves the commentary unaffected.  If -y is  not  specified  and
              the  standard  input  is  a terminal, cdc prompts with comments?
              for the text of the notation to be added.  An unescaped  NEWLINE
              character terminates the annotation text.

EXAMPLES
       The following command:
              example% cdc -r1.6 -y"corrected commentary" s.program.c

       produces  the  following  annotated  commentary for delta 1.6 in s.pro-
       gram.c:

              D 1.6 88/07/05 23:21:07 username 9 0 00001/00000/00000
              MRs:
              COMMENTS:
              corrected commentary
              *** CHANGED *** 88/07/07 14:09:41 username
              performance enhancements in main()

FILES
       z.file temporary lock file

SEE ALSO
       sccs(1),  sccs-admin(1),  sccs-comb(1),  sccs-delta(1),   sccs-help(1),
       sccs-prs(1), sccs-prt(1), sccs-rmdel(1), what(1), sccsfile(5)

DIAGNOSTICS
       Use the SCCS help command for explanations (sccs-help(1)).



                                 27 June 1988                      SCCS-CDC(1)