1sccs-cdc(1)                      User Commands                     sccs-cdc(1)
2
3
4

NAME

6       sccs-cdc, cdc - change the delta commentary of an SCCS delta
7

SYNOPSIS

9       cdc -rsid [-mmr-list] [-y [comment]] s.filename...
10
11

DESCRIPTION

13       cdc  annotates  the delta commentary for the SCCS delta ID (SID) speci‐
14       fied by the -r option in each named s.file.
15
16
17       If the v flag is set in the s.file, you can also use cdc to update  the
18       Modification Request (MR) list.
19
20
21       If  you checked in the delta, or, if you own the file and directory and
22       have write permission, you can use cdc to annotate the commentary.
23
24
25       Rather than replacing the existing commentary, cdc inserts the new com‐
26       ment you supply, followed by a line of the form:
27
28
29       *** CHANGED *** yy/mm/dd hh/mm/ss username
30
31
32       above the existing commentary.
33
34
35       If  a  directory  is  named as the s.filename argument, the cdc command
36       applies to all s.files in that directory. Unreadable s.files produce an
37       error;  processing  continues  with  the  next file (if any). If `' is
38       given as the s.filename argument, each line of the  standard  input  is
39       taken  as  the name of an SCCS history file to be processed, and the -m
40       and -y options must be used.
41

OPTIONS

43       -rsid          Specify the SID of the delta to change.
44
45
46       -mmr-list      Specify one or more MR numbers to add  or  delete.  When
47                      specifying more than one MR on the command line, mr-list
48                      takes the form of a  quoted,  space-separated  list.  To
49                      delete  an  MR number, precede it with a ! character (an
50                      empty MR list has no effect). A list of deleted  MRs  is
51                      placed  in  the comment section of the delta commentary.
52                      If -m is not used and the standard input is a  terminal,
53                      cdc  prompts  with MRs? for the list (before issuing the
54                      comments? prompt). -m is only useful when the v flag  is
55                      set in the s.file. If that flag has a value, it is taken
56                      to be the name of a program to validate the MR  numbers.
57                      If  that validation program returns a non-zero exit sta‐
58                      tus, cdc terminates and  the  delta  commentary  remains
59                      unchanged.
60
61
62       -y[comment]    Use  comment  as the annotation in the delta commentary.
63                      The previous comments are retained; the comment is added
64                      along with a notation that the commentary was changed. A
65                      null comment leaves the commentary unaffected. If -y  is
66                      not  specified and the standard input is a terminal, cdc
67                      prompts with comments? for the text of the  notation  to
68                      be added.  An unescaped NEWLINE character terminates the
69                      annotation text.
70
71

EXAMPLES

73       Example 1 Changing the annotated commentary
74
75
76       The following command:
77
78
79         example% cdc -r1.6 -y"corrected commentary" s.program.c
80
81
82
83
84       produces the following annotated commentary for  delta  1.6  in  s.pro‐
85       gram.c:
86
87
88         D 1.6 88/07/05 23:21:07 username 9 0 00001/00000/00000
89         MRs:
90         COMMENTS:
91         corrected commentary
92         *** CHANGED *** 88/07/07 14:09:41 username
93         performance enhancements in main()
94
95
96

FILES

98       z.file    temporary lock file
99
100

ATTRIBUTES

102       See attributes(5) for descriptions of the following attributes:
103
104
105
106
107       ┌─────────────────────────────┬─────────────────────────────┐
108       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
109       ├─────────────────────────────┼─────────────────────────────┤
110       │Availability                 │SUNWsprot                    │
111       └─────────────────────────────┴─────────────────────────────┘
112

SEE ALSO

114       sccs(1),   sccs-admin(1),  sccs-comb(1),  sccs-delta(1),  sccs-help(1),
115       sccs-prs(1),   sccs-prt(1),   sccs-rmdel(1),   what(1),    sccsfile(4),
116       attributes(5)
117

DIAGNOSTICS

119       Use the SCCS help command for explanations (see sccs-help(1)).
120
121
122
123SunOS 5.11                        30 Jun 2007                      sccs-cdc(1)
Impressum