NAME
cdc — change the delta commentary of an SCCS delta
SYNOPSIS
cdc -r
SID
[-m
[mrlist]]
[-y
[comment]]
files
DESCRIPTION
The
cdc
command changes the
delta commentary,
for the
SID
specified by the
-r
option, of each named
SCCS
file.
Delta commentary
is defined to be the Modification Request
(MR)
and comment information normally specified via the
delta(1)
command
(-m
and
-y
options).
If a directory is named,
cdc
behaves as if each file in the directory were
specified as a named file, except that non-SCCS files
(last component of the path name does not begin 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.
Options
Arguments to
cdc,
which can appear in any order, consist of
option
arguments and file names.
All of the described
option
arguments apply independently to each named file:
- -rSID
Used to specify 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
option set (see
admin(1)),
a list of
MR
numbers to be added and/or deleted in the delta commentary of the
SID
specified by the
-r
option
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(1).
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 the standard input is a terminal, the prompt
MRs?
is issued on the standard output
before the standard input is read;
if the standard input is not a terminal, no prompt is issued.
The
MRs?
prompt always precedes the
comments?
prompt (see
-y
option).
MRs in a list are separated by blanks and/or tab characters.
An unescaped new-line character terminates the
MRs list.
Note that if the
v
option has a value
(see
admin(1)),
it is treated as the name of a program
(or shell procedure) that validates the correctness of the
MR
numbers.
If a non-zero 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
or
comments
already existing for the delta specified by the
-r
option.
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 the standard input is a terminal, the prompt
comments?
is issued on the standard output before standard input is read;
if standard input is not a terminal, no prompt is issued.
An unescaped new-line character terminates the
comment
text.
The exact permissions necessary to modify the
SCCS
file are documented in
get(1).
Simply stated, they are either:
If you made the delta,
you can change its delta commentary, or
If you own the file and directory,
you can modify the delta commentary.
EXTERNAL INFLUENCES
Environment Variables
LANG
determines the language in which messages are displayed.
International Code Set Support
Single- and multi-byte character code sets are supported.
EXAMPLES
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
The following does the same thing:
cdc -r1.6 s.file
MRs? !bl77-54321 bl78-12345 bl79-00001
comments? trouble
WARNINGS
If
SCCS
file names are supplied to the
cdc
command via the standard input
(-
on the command line), the
-m
and
-y
options must also be used.
Printable version
