Commands Reference, Volume 1

cdc Command

Purpose

Changes the comments in a SCCS delta.

Syntax

cdc -rSID [ -m [ModificationRequestList ] ] [ -y [Comment ] ] File ...

Description

The cdc command changes the Modification Requests (MRs) and comments for the specified SCCS delta (the SID variable) for each named Source Code Control System (SCCS) file. If you specify a directory name, the cdc command performs the requested actions on all SCCS files in that directory (that is, all files with names that have the s. prefix). If you specify a - (minus) in place of File, the cdc command reads standard input and interprets each line as the name of an SCCS file.

You can change the comments and MRs for an SID only if you made the SID or you own the file and the directory.

Flags

-m[ModificationRequestList]

Supplies a list of MR numbers for the cdc program to add or delete in the SID specified by the -r flag. You can only use this flag if the specified file has the v header flag set. A null MR list has no effect.

In the actual ModificationRequestList parameter, MRs are separated by blanks, tab characters, or both. To delete an MR, precede the MR number with an ! (exclamation point). If the MR you want to delete is currently in the list of MRs, it is changed into a comment line. The cdc command places a list of all deleted MRs in the comment section of the delta and precedes them with a comment line indicating that the MRs were deleted.

If you do not specify the -m flag, and the v header flag is set, MRs are read from standard input. If standard input is a workstation, the cdc command prompts you for the MRs. The first new-line character not preceded by a backslash ends the list on the command line. The cdc command continues to take input until it reads an end-of-line character or a blank line. MRs are always read before comments (see the -y flag).

If the v header flag has a value, the cdc command interprets the value as the name of a program that validates MR numbers. If the MR number validation program returns a nonzero exit value, the cdc command stops and does not change the MRs.

-rSID

Specifies the SCCS identification number of the delta for which the cdc command will change the comments or MRs.

-y[Comment]

Specifies comment text to replace an existing comment for the delta specified by the -r flag. The cdc command keeps the existing comments but precedes them by a comment line stating that they were changed. A null Comment value has no effect.

If you do not specify the -y flag, the cdc command reads comments from standard input until it reads an end-of-file character. If the standard input is a workstation, the cdc command prompts for the comments and also allows a blank line to end input. If the last character of a line is a \ (backslash), the cdc command ignores it and continues to read standard input.

Note: If the cdc command reads standard input for file names (that is, when you specify a file name of -), you must use the -y and -m flags.

Example

To change the comment for SID 1.3 of SCCS file s.text.c to "new comment", enter:

cdc -r1.3 -y"new comment" s.test.c

Files

/usr/bin/cdc

Contains the path to SCCS cdc command.

Related Information

The admin command, delta command, get command, prs command, sccshelp command.

The sccsfile file format.

Source Code Control System (SCCS) Overview in AIX 5L Version 5.2 General Programming Concepts: Writing and Debugging Programs.

List of SCCS Commands in AIX 5L Version 5.2 General Programming Concepts: Writing and Debugging Programs.