delta
PURPOSE
Creates a delta in a Source Code Control System file.
SYNOPSIS
delta [-rSID] [-s] [-n] [-glist] [-m[mrlist]] [-y[comment]] [-p] files
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, delta per-
forms 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, delta reads
standard input and interprets each line as the name of an
SCCS file. When delta 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 in the admin command on
page .) delta 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: Lines beginning with an SOH ASCII character
(binary 001) cannot be placed in the SCCS file unless the
SOH is quoted using a \ (backslash). SOH has special
meaning to SCCS and causes an error. See the sccsfile
file in AIX Operating System Technical Reference.
A get of many SCCS files, followed by delta of those
files, should be avoided when the get generates a large
amount of data. Instead, you should alternate the use of
get and delta.
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, get
ignores this delta 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, delta reads MRs from the
standard input. If standard input is a work
station, delta prompts you for the MRs.
delta continues to take input until it reads
END OF FILE (Ctrl-D). It always reads MRs
before 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 delta returns
a nonzero exit value from the MR validation
program, delta assumes some of the MR
numbers were invalid and stops running.
-n Retains the g-file, which is normally
removed at completion of delta 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
done on the same SCCS file by the same
person. The SID can be either the SID spec-
ified on the get command line or the SID to
be made.as reported by the get command (see
Figure 2 for additional information). An
error results if the specified SID cannot be
uniquely identified, or if a SID must be
specified but it is not.
-s Suppresses the information normally written
to standard output on normal completion of
the delta command.
-y[comment] Specifies text used to describe the reason
for making the delta. A null string is con-
sidered 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 -y, delta reads com-
ments from standard input until it reads a
blank line or END OF FILE (Ctrl-D). If
input is from the keyboard, delta prompts
for the comments. If the last character of
a line is a backslash, it is ignored. Com-
ments must be no longer than 512 characters.
EXAMPLE
To record changes you have made to an SCCS file:
delta s.prog.c
This adds a delta to the SCCS file "s.prog.c", recording
the changes made by editing "prog.c". delta then asks
you for a comment that summarizes the changes you made.
Enter the comment, then press END OF FILE (Ctrl-D) or
press the Enter key twice to indicate that you have fin-
ished the comment.
RELATED INFORMATION
The following commands: "admin," "bdiff," "cdc,"
"get," "help," "prs," and "rmdel."
The sccsfile file in AIX Operating System Technical Ref-
erence.
The discussion of SCCS in AIX Operating System Program-
ming Tools and Interfaces.