DELTA(1) GENIX Programmer's Manual DELTA(1)
NAME
delta - make a delta (change) to an SCCS file
SYNOPSIS
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(1) (called the
g-file, or generated file).
Delta makes a delta to each named SCCS file. If a directory is
named, delta behaves as though each file in the directory were
specified as a named file, except that non-SCCS files (last com-
ponent of the path name does not begin with s.) and unreadable files
are silently ignored. If a name of - is given, the standard input
is read (see WARNINGS); 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 cer-
tain keyletters specified and flags (see admin(1)) that may be
present in the SCCS file (see -m and -y keyletters below).
Keyletter arguments 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 outstanding gets
for editing (get -e) on the same SCCS file were
done 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(1)). A diagnostic results if
the specified SID is ambiguous, or, if 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 (nor-
mally removed at completion of delta process-
ing).
-glist Specifies a list (see get(1) 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.
Printed 11/16/83 1
DELTA(1) GENIX Programmer's Manual DELTA(1)
-m[mrlist] If the SCCS file has the v flag set (see
admin(1)) then a Modification Request (MR)
number must be supplied as the reason for creat-
ing the new delta.
If -m is not used and the standard input is a
terminal, the prompt MRs? is issued on the stan-
dard output before the standard input is read;
if the standard input is not a terminal, no
prompt is issued. The MRs? prompt always pre-
cedes the comments? prompt (see -y keyletter).
MRs in a list are separated by blanks and/or tab
characters. An unescaped new-line character
terminates the MR list.
Note that if the v flag has a value (see
admin(1)), it is taken to be the name of a pro-
gram (or shell procedure) which will validate
the correctness of the MR numbers. If a non-
zero 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 new-line
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 in a diff(1) format.
FILES
All files of the form ?-file are explained in the Source Code Con-
trol System User's Guide. The naming convention for these files 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.
Printed 11/16/83 2
DELTA(1) GENIX Programmer's Manual DELTA(1)
z-file Created during the execution of delta; removed dur-
ing 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 "gotten"
file and the g-file.
WARNINGS
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(5)) 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 keyletters must also be present. Omis-
sion of these keyletters causes an error to occur.
SEE ALSO
admin(1), bdiff(1), get(1), sccshelp(1), prs(1), prt(1), sccs(1),
sccsfile(5).
Source Code Control System User's Guide by L. E. Bonanni and C. A.
Salemi.
DIAGNOSTICS
Use sccshelp(1) for explanations.
Printed 11/16/83 3