.\"
.\" CDDL HEADER START
.\"
.\" The contents of this file are subject to the terms of the
.\" Common Development and Distribution License (the "License").  
.\" You may not use this file except in compliance with the License.
.\"
.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
.\" or http://www.opensolaris.org/os/licensing.
.\" See the License for the specific language governing permissions
.\" and limitations under the License.
.\"
.\" When distributing Covered Code, include this CDDL HEADER in each
.\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
.\" If applicable, add the following below this CDDL HEADER, with the
.\" fields enclosed by brackets "[]" replaced with your own identifying
.\" information: Portions Copyright [yyyy] [name of copyright owner]
.\"
.\" CDDL HEADER END
.\" Copyright (c) 1999, Sun Microsystems, Inc.
.\"
.\" Portions Copyright (c) 2007 Gunnar Ritter, Freiburg i. Br., Germany
.\"
.\" Sccsid @(#)cdc.1	1.8 (gritter) 3/23/07
.\"
.\" from OpenSolaris sccs-cdc 1 "1 Nov 1999" "SunOS 5.11" "User Commands"
.TH CDC 1 "3/23/07" "Heirloom Development Tools" "User Commands"
.SH NAME
cdc \- change the delta commentary of an SCCS delta
.SH SYNOPSIS
.HP
.ad l
.nh
\fBcdc\fR \fB\-r\fR\fIsid\fR
[\fB\-m\fR\fImr\-list\fR] [\fB\-y\fR[\fIcomment\fR]]
\fIs.filename\fR...
.br
.ad b
.hy 1
.SH DESCRIPTION
.LP
\fIcdc\fR annotates the delta commentary for the \s-1SCCS\s+1 delta ID (SID) specified by the \fB\-r\fR
option in each named \fBs.\fRfile.
.PP
If the \fBv\fR flag is set in the \fBs.\fRfile,
you can also use \fIcdc\fR to update the Modification Request
(MR) list.
.PP
If you checked in the delta, or, if you own the file and directory
and have write permission, you can use \fIcdc\fR to annotate
the commentary.
.PP
Rather than replacing the existing commentary, \fIcdc\fR
inserts the new comment you supply, followed by a line of the form:
.PP
\fB*** CHANGED ***\fR \fIyy\fR\fB/\fR\fImm\fR\fB/\fR\fBdd\fR \fIhh\fR\fB/\fR\fImm\fR\fB/\fR\fIss\fR \fIusername\fR
.PP
above the existing commentary.
.PP
If a directory is named as the \fIs.filename\fR
argument, the \fIcdc\fR command applies to all \fBs.\fRfiles in that directory.
Unreadable \fBs.\fRfiles
produce an error; processing continues with the next file (if any).
If `\fB\(mi\fR' is given as the \fIs.filename\fR
argument, each line of the standard input is taken as the name of an \s-1SCCS\s+1 history file to be processed, and the \fB\-m\fR and \fB\-y\fR options must be used.
.TP
\fB\-r\fR\fIsid\fR
Specify the \s-1SID\s+1 of the delta to change.
.TP
\fB\-m\fR\fImr-list\fR
Specify one or more MR numbers to add or delete.
When specifying
more than one MR on the command line, \fImr-list\fR
takes the form of a quoted, space-separated list.
To delete an MR number,
precede it with a \fB!\fR character (an empty \fBMR\fR list has no effect).
A list of deleted \fBMRs\fR is placed in the comment section of the delta commentary.
If \fB\-m\fR is not used and the standard input is a terminal, \fIcdc\fR prompts with \fBMRs?\fR for the list (before
issuing the \fBcomments?\fR prompt).
\fB\-m\fR is
only useful when the \fBv\fR flag is set in the \fBs.\fRfile.
If that flag has a value, it is taken to be the name of
a program to validate the MR numbers.
If that validation program returns
a non-zero exit status, \fIcdc\fR terminates and the delta
commentary remains unchanged.
.TP
\fB\-y\fR[\fIcomment\fR]\fR
Use \fIcomment\fR as the annotation
in the delta commentary.
The previous comments are retained; the \fIcomment\fR is added along with a notation that the commentary
was changed.
A null \fIcomment\fR leaves the commentary
unaffected.
If \fB\-y\fR is not specified and the standard input
is a terminal, \fBcdc\fR prompts with \fBcomments?\fR
for the text of the notation to be added.
An unescaped \fBNEWLINE\fR character terminates the annotation text.
.SH EXAMPLES
.LP
\fBExample 1 \fRChanging the annotated commentary
.LP
The following command:
.PP
.in +2
.nf
$ \fBcdc \-r1.6 \-y"corrected commentary" s.program.c\fR
.fi
.in -2
.PP
produces the following annotated commentary for delta 1.6 in \fBs.program.c\fR:
.PP
.in +2
.nf
D 1.6 88/07/05 23:21:07 username 9 0 00001/00000/00000
MRs:
COMMENTS:
corrected commentary
*** CHANGED *** 88/07/07 14:09:41 username
performance enhancements in main()
.fi
.in -2
.SH FILES
.TP 14
\fBz.file\fR
temporary lock file
.SH SEE ALSO
admin(1), 
delta(1), 
help(1), 
prs(1), 
sccsfile(5) 
.SH DIAGNOSTICS
Use the \s-1SCCS\s+1 \fIhelp\fR
command for explanations (see 
\fIhelp\fR(1)).