cdc(1) CLIX cdc(1)
NAME
cdc - Changes delta commentary of an SCCS delta
SYNOPSIS
cdc -rSID [-m[mrlist]] [-y[comment]] file ...
FLAGS
-rSID Specifies the SCCS identification (SID) string of a delta
for which the delta commentary is to be changed.
-m[mrlist] If the SCCS file has the v flag set (see admin()) then a
list of MR numbers to be added and/or deleted in the delta
commentary of the SID specified by the -r flag may be
supplied. A null MR list has no effect.
MR entries are added to the list of MRs in the same manner
as that of delta. 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 comment section of the delta commentary and
preceded by a comment line stating that they were deleted.
If -m is not used and stdin is a terminal, the prompt MRs?
is issued on stdout before stdin is read; if stdin is not a
terminal, no prompt is issued. The MRs? prompt always
precedes the comments? prompt (see -y flag).
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 [see admin()], it is
taken to be the name of a program (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 delta commentary remains
unchanged.
-y[comment] Arbitrary text used to replace the comment(s) already
existing for the delta specified by the -r flag. The
previous comments are kept and preceded by a comment line
stating that they were changed. A null comment has no
effect.
If -y is not specified and stdin is a terminal, the prompt
comments? is issued on stdout before stdin is read; if stdin
is not a terminal, no prompt is issued. An unescaped
newline character terminates the comment text.
2/94 - Intergraph Corporation 1
cdc(1) CLIX cdc(1)
DESCRIPTION
The cdc command changes the delta commentary, for the SID (SCCS
identification string) specified by the -r flag, of each named SCCS file.
Delta commentary is defined to be the Modification Request (MR) and
comment information normally specified with the delta command (-m and -y
flags).
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 begin with s.) and unreadable files are silently
ignored. If a name of - is given, stdin is read (see CAUTIONS) and each
line of stdin is taken to be the name of an SCCS file to be processed.
Arguments to cdc, which may appear in any order, consist of flag arguments
and filenames. The flag arguments are either (1) if you made the delta,
you can change its delta commentary; or (2) if you own the file and
directory you can modify the delta commentary.
EXAMPLES
1. To add bl78-12345 and bl79-00001 to the MR list, remove bl77-54321
from the MR list, 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.
2. The following has the same effect as the previous example:
cdc -r1.6 s.file
MRs? !bl77-54321 bl78-12345 bl79-00001
comments? trouble
CAUTIONS
If SCCS filenames are supplied to the cdc command with stdin (- on the
command line), then the -m and -y flags must also be used.
FILES
x-file (see delta)
Z-file (see delta)
DIAGNOSTICS
Use help for explanations.
EXIT VALUES
2 Intergraph Corporation - 2/94
cdc(1) CLIX cdc(1)
The cdc command returns a value of 0 if successful. If unsuccessful, cdc
returns a value of 1.
RELATED INFORMATION
Commands: admin(1), delta(1), get(1), prs(1), help(1)
Files: sccsfile(4)
2/94 - Intergraph Corporation 3