DELTA(1-SVR4) RISC/os Reference Manual DELTA(1-SVR4)
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 -e
(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 component 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 the NOTES sec-
tion); 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 on
certain 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
(normally removed at completion of delta
processing).
Printed 11/19/92 Page 1
DELTA(1-SVR4) RISC/os Reference Manual DELTA(1-SVR4)
-glist Specify a list [see get(1) for the
definition of list] of deltas that 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(1)] then a Modification Request
(MR) number must be supplied as the rea-
son 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
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 program (or shell pro-
cedure) that will validate the correct-
ness of the MR numbers. If a non-zero
exit status is returned from the MR
number validation program, delta ter-
minates. (It is assumed that the MR
numbers were not all valid.)
-y[comment] Arbitrary text used to describe the rea-
son 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.
INTERNATIONAL FUNCTIONALITY
Keyletter arguments:
-y[comment] Characters from supplementary code sets can
be used in comment.
Page 2 Printed 11/19/92
DELTA(1-SVR4) RISC/os Reference Manual DELTA(1-SVR4)
Characters from supplementary code sets can be used for the
SCCS file names file. However, they must begin with the
ASCII characters s.. SCCS files may also include characters
from supplementary code sets.
FILES
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.
bdiff
Program to compute differences between the ``gotten''
file and the g-file.
SEE ALSO
admin(1), cdc(1), get(1), help(1), prs(1), rmdel(1),
sccsfile(4).
bdiff(1) in the User's Reference Manual.
DIAGNOSTICS
Use help(1) for explanations.
NOTES
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. Omission of these keyletters causes an error.
Comments are limited to text strings of at most 1024 charac-
ters. Line lengths greater than 1000 characters cause unde-
fined results.
Printed 11/19/92 Page 3