/usr/share/doc/cssc/cssc.html/cdc.html

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- 
This file documents the GNU cssc package for working with
SCCS files.

Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002,
              2003, 2004, 2005, 2007, 2008 Free Software Foundation, Inc.

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
Texts.  A copy of the license is included in the section entitled "GNU
Free Documentation License". -->
<!-- Created by GNU Texinfo 6.0, http://www.gnu.org/software/texinfo/ -->
<head>
<title>CSSC: Compatibly Stupid Source Control: cdc</title>

<meta name="description" content="CSSC: Compatibly Stupid Source Control: cdc">
<meta name="keywords" content="CSSC: Compatibly Stupid Source Control: cdc">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Concept-Index.html#Concept-Index" rel="index" title="Concept Index">
<link href="Concept-Index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Invoking-CSSC-Programs.html#Invoking-CSSC-Programs" rel="up" title="Invoking CSSC Programs">
<link href="comb.html#comb" rel="next" title="comb">
<link href="Modification-Request-Numbers.html#Modification-Request-Numbers" rel="prev" title="Modification Request Numbers">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smalllisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nocodebreak {white-space: nowrap}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: serif; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>


</head>

<body lang="en">
<a name="cdc"></a>
<div class="header">
<p>
Next: <a href="comb.html#comb" accesskey="n" rel="next">comb</a>, Previous: <a href="admin.html#admin" accesskey="p" rel="prev">admin</a>, Up: <a href="Invoking-CSSC-Programs.html#Invoking-CSSC-Programs" accesskey="u" rel="up">Invoking CSSC Programs</a> &nbsp; [<a href="Concept-Index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html#Concept-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="cdc-1"></a>
<h3 class="section">3.2 <code>cdc</code></h3>
<a name="index-cdc"></a>
<a name="index-sccs_002dcdc"></a>
<a name="index-change-delta-commentary"></a>
<a name="index-delta-comment_002c-changing"></a>
<a name="index-comment_002c-changing"></a>
<p>The <code>cdc</code> command allows you to add comments to the commentary for
a particular delta in an <small>SCCS</small> file.  Any delta in the file (other
than ones removed with <code>rmdel</code>) can be modified.
</p>
<p>If a comment is not specified on the command line, comments are accepted
via standard input.
</p>
<p>If the special argument name &lsquo;<samp>-</samp>&rsquo; is being used, this means that a
list of files to operate on is being read from standard input, and
therefore the <samp>-y</samp> option is mandatory in this case.
</p>
<p>The new comments are prepended to the existing comment for that delta,
followed by a line of the form &lsquo;<samp>*** CHANGED *** yy/mm/dd hh:mm:ss
who</samp>&rsquo;.  This is followed by the original comment.   Comments cannot be
removed using <code>cdc</code>, but they can be added.
</p>
<p>Only three options are supported:-
</p>
<dl compact="compact">
<dt><samp>-m<var>MR-list</var></samp></dt>
<dd><p>The specified (space-separated) list of <small>MR</small>s is added to the
<small>MR</small>-list for the relevant delta.  If more than one <small>MR</small> number is
to be added, the whole option should be quoted, to protect the spaces.
If an <small>MR</small> is prefixed with an exclamation mark (&lsquo;<samp>!</samp>&rsquo;), then the
indicated delta is removed from the existing list of <small>MR</small>s for the
delta.  The file comment is modified to indicate what <small>MR</small>s have been
removed.  If an <small>MR</small> to be removed is in fact not present in any
case, this is silently ignored. and the comment is not updated for that
<small>MR</small>.  If you do not also want to add to the comment for the delta,
specify an empty comment option (that, is, a bare <samp>-y</samp>).
</p>
</dd>
<dt><samp>-r<var>SID</var></samp></dt>
<dd><p>This indicates which delta is to be changed.   It must refer to an
existing delta in the file, which has not been removed with
<code>rmdel</code>.
</p>
</dd>
<dt><samp>-y<var>Comment</var></samp></dt>
<dd><p>This option introduces a comment to be added to the commentary for the
specified <small>SID</small>.  If more than one line is needed, it is a good idea
to enclose the option in quotation marks to ensure that the shell
includes them in the argument passed to <code>cdc</code>.  An empty <samp>-y</samp>
option can be used to indicate that the commentary for this delta is not
to be modified (this is only useful when the <samp>-m</samp> option is used).
If the <samp>-y</samp> option is not given, the user is prompted for comments.
</p>
</dd>
</dl>


<hr>
<div class="header">
<p>
Next: <a href="comb.html#comb" accesskey="n" rel="next">comb</a>, Previous: <a href="admin.html#admin" accesskey="p" rel="prev">admin</a>, Up: <a href="Invoking-CSSC-Programs.html#Invoking-CSSC-Programs" accesskey="u" rel="up">Invoking CSSC Programs</a> &nbsp; [<a href="Concept-Index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html#Concept-Index" title="Index" rel="index">Index</a>]</p>
</div>



</body>
</html>
cssc 1.4.0-5 / usr / share / doc / cssc / cssc.html / cdc.html
