cdc(1) cdc(1)NAME cdc - change the delta commentary of an SCCS delta SYNOPSIS cdc [-m[mrlist]] -r SID [-y[comment]] file ... DESCRIPTION cdc changes the ``delta commentary'', for the SID specified by the -r keyletter, of each named SCCS file. A ``delta commentary'' is defined to be the Modification Re- quest (MR) and comment information normally specified via the delta(1) command (-m and -y keyletters). If a directory is named, cdc behaves as though each file in the directory were specified as a named file, except that non-SCCS files (last component of the pathname does not be- gin 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. Arguments to cdc, which may appear in any order, consist of keyletter arguments, and filenames. All the described keyletter arguments apply independently to each named file: -rSID Used to specify the SCCS Identification (SID) string of a delta for which the delta commenta- ry is to be changed. -m[mrlist] If the SCCS file has the v flag option set (see admin(1)) then a list of MR numbers to be added and/or deleted in the delta commentary of the SID specified by the -r keyletter may be sup- plied. 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). In order 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 com- ment section of the delta commentary and pre- ceded 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 April, 1990 1
cdc(1) cdc(1)read; if the standard input is not a terminal, no prompt is issued. The MRs? prompt always precedes the comments? prompt (see -ykeyletter). 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 option has a value (see admin(1)), it is taken to be the name of a pro- gram (or shell procedure) which validates the correctness of the MR numbers. If a nonzero exit status is returned from the MR number validation program, cdc terminates and the del- ta commentary remains unchanged. -y[comment] Arbitrary text used to replace the comment(s) already existing for the delta specified by the -r keyletter. The previous comments are kept and preceded by a comment line stating that they were changed. A null comment has no ef- fect. If -y is not specified and the standard input is a terminal, the prompt comments? is issued on the standard output before the standard in- put is read; if the standard input is not a terminal, no prompt is issued. An unescaped newline character terminates the comment text. The exact permissions necessary to modify the SCCS file are documented in the ``SCCS Reference'' in A/UX Programming Languages and Tools, Volume 2. Simply stated, they are ei- ther (1) if you made the delta, you may change its delta commentary; or (2) if you own the file and directory, you may modify the delta commentary. EXAMPLES cdc -r1.6 -m"bl78-12345 !bl77-54321 bl79-00001" -ytrouble s.file adds bl78-12345 and bl79-00001 to the MR list, removes bl77-54321 from the MR list, and adds the comment trouble to delta 1.6 of s.file. cdc -r1.6 s.file MRs? !bl77-54321 bl78-12345 bl79-00001 comments? trouble does the same thing. 2 April, 1990
cdc(1) cdc(1)WARNINGS If SCCS filenames are supplied to the cdc command via the standard input (- on the command line), then the -m and -y keyletters must also be used. FILES /usr/bin/cdc SEE ALSO admin(1), delta(1), get(1), help(1), prs(1), sccsfile(4). ``SCCS Reference'' in A/UX Programming Languages and Tools, Volume 2. DIAGNOSTICS Use help(1) for explanations. April, 1990 3