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