DELTA(CP) XENIX System V DELTA(CP)
Name
delta - Makes a delta (change) to an SCCS file.
Syntax
delta [-rSID] [-s] [-n] [-glist] [-m[mrlist]] [-y[comment]]
[-p] files
Description
delta is used to permanently introduce into the named SCCS
file changes that were made to the file retrieved by get(CP)
(called the g-file, or generated file).
delta makes a delta to each SCCS file named by files. If a
directory is named, delta behaves as though each file in the
directory were specified as a named file, except that
nonSCCS files (last component of the pathname does not begin
with s.) and unreadable files are silently ignored. If a
name of - is given, the standard input is read (see
Warning); each line of the standard input is taken to be the
name of an SCCS file to be processed.
delta may issue prompts on the standard output depending
upon certain options specified and flags (see admin(CP))
that may be present in the SCCS file (see -m and -y options
below).
Options apply independently to each named file.
-rSID Uniquely identifies which delta is to be made
to the SCCS file. The use of this keyletter
is necessary only if two or more versions of
the same SCCS file have been retrieved for
editing (get -e) by the same person (login
name). The SID value specified with the -r
keyletter can be either the SID specified on
the get command line or the SID to be made as
reported by the get command (see get(CP)). A
diagnostic results if the specified SID is
ambiguous, or if it is necessary and omitted
on the command line.
-s Suppresses the issue, on the standard output,
of the created delta's SID, as well as the
number of lines inserted, deleted and
unchanged in the SCCS file.
-n Specifies retention of the edited g-file
(normally removed at completion of delta
processing).
Page 1 (printed 8/7/87)
DELTA(CP) XENIX System V DELTA(CP)
-glist Specifies a list (see get(CP) for the
definition of list) of deltas which are to be
ignored when the file is accessed at the
change level (SID) created by this delta.
-m[mrlist] If the SCCS file has the v flag set (see
admin(CP)) then a Modification Request (MR)
number must be supplied as the reason for
creating the new delta.
If -m is not used and the standard input is a
terminal, the prompt MRs? is issued on the
standard output before the standard input is
read; if the standard input is not a
terminal, no prompt is issued. The MRs?
prompt always precedes the comments? prompt
(see -y keyletter).
MRs in a list are separated by blanks and/or
tab characters. An unescaped newline
character terminates the MR list.
Note that if the v flag has a value (see
admin(CP)), it is taken to be the name of a
program (or shell procedure) which will
validate the correctness of the MR numbers.
If a nonzero exit status is returned from MR
number validation program, delta terminates
(it is assumed that the MR numbers were not
all valid).
-y[comment] Arbitrary text used to describe the reason
for making the delta. A null string is
considered a valid comment.
If -y is not specified and the standard input
is a terminal, the prompt comments? is issued
on the standard output before the standard
input is read; if the standard input is not a
terminal, no prompt is issued. An unescaped
newline character terminates the comment
text.
-p Causes delta to print (on the standard
output) the SCCS file differences before and
after the delta is applied. Differences are
displayed in a diff(C) format.
Files
All files of the form ?-file are explained in Chapter 3,
``SCCS: A Source Code Control System" in the XENIX
Programmer's Guide. The naming convention for these files
Page 2 (printed 8/7/87)
DELTA(CP) XENIX System V DELTA(CP)
is also described there.
g-file Existed before the execution of delta;
removed after completion of delta.
p-file Existed before the execution of delta; may
exist after completion of delta.
q-file Created during the execution of delta;
removed after completion of delta.
x-file Created during the execution of delta;
renamed to SCCS file after completion of
delta.
z-file Created during the execution of delta;
removed during the execution of delta.
d-file Created during the execution of delta;
removed after completion of delta.
/usr/bin/bdiff Program to compute differences between the
``retrieved'' file and the g-file.
Warning
Lines beginning with an SOH ASCII character (binary 001)
cannot be placed in the SCCS file unless the SOH is escaped.
This character has special meaning to SCCS (see sccsfile(F))
and will cause an error.
A get of many SCCS files, followed by a delta of those
files, should be avoided when the get generates a large
amount of data. Instead, multiple get/delta sequences
should be used.
If the standard input (-) is specified on the delta command
line, the -m (if necessary) and -y options must also be
present. Omission of these options causes an error to
occur.
See Also
admin(CP), bdiff(C), get(CP), help(CP), prs(CP), sccsfile(F)
Diagnostics
Use help(CP) for explanations.
Page 3 (printed 8/7/87)