|
|
Good Comments
07-24-2008
|
|
cdc(1) General Commands Manual cdc(1) NAME
cdc - Changes the comments in a Source Code Control System (SCCS) delta SYNOPSIS
cdc -rSID [-m] [MRlist] [-y] [comment] file... cdc -rSID -mMRlist -ycomment - The cdc command changes the Modification Requests (MRs) and comments for the SID specified by the -r option for each named Source Code Con- trol System (SCCS) file. OPTIONS
Supplies a list of MR numbers for cdc to add or delete in the SID specified by the -r option. You can use this option only if the file has the v header flag set (see the admin command). A null MR list has no effect. In MRlist, MRs are separated by spaces, 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 following MRs were deleted. If you do not specify the -m option, and the v header flag is set, MRs are read from standard input. If standard input is a termi- nal, the cdc command prompts you for the MRs. The first newline character not preceded by a (backslash) ends the list on the com- mand line. The cdc command continues to take input until it reads an End-of-File character or a blank line. MRs are always read before comments (see the -y option). If the v flag has a value, cdc interprets the value as the name of a program that validates the MR numbers. If the MR number validation program returns a nonzero exit value, the cdc command stops and does not change the MRs. Specifies the SCCS identification number of the delta for which cdc will change the comments or MRs. Specifies text to replace any comment already existing for the delta specified by the -r option. The cdc command keeps the existing comments and pre- cedes them by a comment line, stating that they were changed. A null comment has no effect. If you do not specify -y, the cdc command reads comments from standard input until it reads an End-of-File character. If the stan- dard input is a terminal, 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. If cdc reads standard input for file names (that is, when you specify a file name of - (dash)), you must use the -y and -m options. DESCRIPTION
If you specify a directory name, cdc 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 - (dash) in place of file, cdc reads standard input and interprets each line as the name of an SCCS file. For more information on SCCS, see the Programming Support Tools. You can change the comments and MRs for an SID only if you made the SID or you own the file and the directory. For more information on the permissions needed to change SCCS files, see the get command. EXIT STATUS
For information about exit values, see the OPTIONS section. EXAMPLES
To change the comment for SID 1.3 of SCCS file s.test.c to new comment, enter: cdc -r1.3 -y"new comment" s.test.c SEE ALSO
Commands: admin(1), comb(1), delta(1), get(1), prs(1), rmdel(1), sact(1), sccs(1), sccsdiff(1), sccshelp(1), unget(1), val(1), what(1) Files: sccsfile(4) Programming Support Tools cdc(1)
