cdc.1 (2010 09)
c
cdc(1) cdc(1)
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 com-
ments? 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 ter-
minates and the delta commentary remains unchanged.
-y[comment] Arbitrary text used to replace the comment or comment s 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.
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1