c

cdc(1)

cdc(1)

NAME

cdc - change the delta commentary of an SCCS delta

SYNOPSIS

cdc -rSID [-m[mrlist ] ] [-y[comment ] ] ®les

DESCRIPTION

The cdc command changes the delta commentary, for the SID speci®ed by the -roption, of each named SCCS ®le.

Delta commentary is de®ned to be the Modi®cation Request (MR) and comment information normally speci®ed via the delta(1) command (-mand -yoptions).

If a directory is named, cdc behaves as if each ®le in the directory were speci®ed as a named ®le, except that non-SCCS®les (last component of the path name does not begin with s.) and unreadable ®les 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 ®le to be processed.

Options

Arguments to cdc, which can appear in any order, consist of option arguments and ®le names.

All of the described option arguments apply independently to each named ®le:

-rSID

Used to specify the SCCS IDenti®cation (SID) string of a delta for which the delta com-

 

mentary is to be changed.

-m[mrlist]

If the SCCS ®le 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 speci®ed by the -roption 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 ``com-

 

ment'' line. A list of all deleted MRs is placed in the comment section of the delta com-

 

mentary and preceded by a comment line stating that they were deleted.

 

If -mis 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 -yoption).

 

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 pro-

 

gram (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

 

speci®ed by the -roption. Previous comments are kept and preceded by a comment

 

line stating that they were changed. A null comment has no effect.

 

If -yis not speci®ed 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 ®le 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 ®le and directory, you can modify the delta commentary.

EXTERNAL INFLUENCES

Environment Variables

LANG determines the language in which messages are displayed.

Section 1−68

− 1 −

HP-UX Release 11i: December 2000