DELTA(1s,C) AIX Commands Reference DELTA(1s,C) ------------------------------------------------------------------------------- delta PURPOSE Creates a delta in a Source Code Control System (SCCS) file. SYNTAX +----------------------------------+ +-| +- -y --------+ +- -m -------+ |-- file --+ +------------+ | +-| |---| |-+ ^ | | delta ---| +--------+ |---| +- -ycomment -+ +- -mmrlist -+ +------+ |---| +-| -glist |-+ | +- -y --------+ +- -m -------+ | ^| -n || +-| |---| |----- - ------+ || -p || +- -ycomment -+ +- -mmrlist -+ || -rSID || || -s || |+--------+| +----------+ DESCRIPTION The delta command is used to introduce into the named Source Code Control System (SCCS) file any changes that were made to the file version retrieved by a get -e command. The delta command reads the g-files that correspond to the specified files (see "SCCS Files") and creates a new delta. If you specify a directory in place of file, the delta command performs the requested actions on all SCCS files within that directory (that is, on all files with the s. prefix). If you specify a - (minus) in place of file, the delta command reads standard input and interprets each line as the name of an SCCS file. When the command reads standard input, you must supply the -y flag. You must also supply the -m flag if the v header flag is set. (For more information on header flags, see the discussion under the admin command on page admin-3.) The delta command reads standard input until it reaches END OF FILE (Ctrl-D). If you are not familiar with the delta numbering system, see AIX Operating System Programming Tools and Interfaces for more information. Note: The SOH ASCII character (binary 001) has special meaning to SCCS. Therefore, lines beginning with an SOH ASCII character (binary 001) cannot be placed in the SCCS file unless the SOH is quoted using a \ (backslash). See the sccsfile file in AIX Operating System Technical Reference. Processed November 8, 1990 DELTA(1s,C) 1 DELTA(1s,C) AIX Commands Reference DELTA(1s,C) A get of many SCCS files, followed by delta of those files, should be avoided when the get command generates a large amount of data. Instead, you should alternate the use of the get and delta commands. FLAGS -glist Specifies a list of SIDs (deltas) that are to be ignored when the get command creates the g-file. After you use this flag, the get command ignores this SID if it is one that it should not include when it builds the g-file. -m[mrlist] If the SCCS file has the v header flag set, then a Modification Request (MR) number must be supplied as the reason for creating the new delta. If you do not specify the -m flag and the v header flag is set, the delta command reads MRs from the standard input. If standard input is a work station, the delta command prompts you for the MRs. The command continues to take input until it reads END OF FILE (Ctrl-D). It always reads MRs before reading the comments (see the -y flag). You can use blanks, tab characters, or both to separate MRs in a list. If the v header flag has a value, it is interpreted as the name of a program that validates the MR numbers. If the delta command returns a nonzero exit value from the MR validation program, the delta command assumes some of the MR numbers are invalid and stops running. -n Retains the g-file, which is normally removed at completion of delta command processing. -p Writes to standard output (in the format of the diff command) the SCCS file differences before and after the delta is applied. See "diff" for an explanation of the format. -rSID Specifies which delta is to be made to the SCCS file. You must use this flag only if two or more outstanding get -e commands were run on the same SCCS file by the same person. The SID can be either the SID specified on the get command line or the SID to be made, as reported by the get command (see Figure 4 for additional information). An error results if the specified SID cannot be uniquely identified, or if an SID must be specified but is not. -s Suppresses the information normally written to standard output on normal completion of the delta command. Processed November 8, 1990 DELTA(1s,C) 2 DELTA(1s,C) AIX Commands Reference DELTA(1s,C) -y[comment] Specifies text used to describe the reason for making the delta. A null string is considered a valid comment. If your comment line includes special characters or blanks, the line must be enclosed in single or double quotation marks. If you do not specify the -y flag, the delta command reads comments from standard input until it reads a blank line or END OF FILE (Ctrl-D). If input is from the keyboard, the delta command prompts for the comments. If the last character of a line is a backslash, it is ignored. Comments must be no longer than 512 characters. If you have selected a language (through the LANG environment variable) that supports multibyte characters, the 512-character limit may be reduced by as much as 50%, depending on the character code set being used. EXAMPLE To record changes you have made to an SCCS file: delta s.prog.c This command adds a delta to the SCCS file "s.prog.c", recording the changes made by editing the file "s.prog.c". The delta command then asks you for a comment that summarizes the changes you make. Enter the comment, then press END OF FILE (Ctrl-D), or press the Enter key twice to indicate that you have finished the comment. RELATED INFORMATION See the following commands: "admin," "bdiff," "cdc," "get," "sccshelp," "prs," and "rmdel." See the sccsfile file in AIX Operating System Technical Reference. See the discussion of SCCS in AIX Operating System Programming Tools and Interfaces. Processed November 8, 1990 DELTA(1s,C) 3