delta(1) delta(1)
NAME
delta - make a change to an SCCS file
SYNOPSIS
delta [-r SID] [-s] [-n] [-g list] [-m MR-list] [-y[comment]] [-p]
[--] file...
DESCRIPTION
delta is used to copy into the named SCCS file changes that were made
to the file created by get -e (called the g-file or generated file),
i.e. to create a new version of it.
If a directory is specified, delta processes all the files in the
directory, except for any files which are non-SCCS files (i.e. those
for which the filename does not begin with s., ignoring the pathname)
and unreadable files; these files are ignored without comment. 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 whether
the user specifies certain keyletters and flags that may be present in
the SCCS file (see -m and -y keyletters).
OPTIONS
Keyletter arguments apply independently to each named file.
-r SID
SID 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 get calls for editing (get -e) on the same SCCS file
were done by the same person (login name). The SID value speci-
fied 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)]. An error message results if the specified
SID is ambiguous or is not specified.
-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. This is normally
deleted on completion of delta processing.
-g list
A list of deltas that are to be ignored when the file is accessed
at the change level (SID) created by this delta [for the defini-
tion of list see get(1)].
Page 1 Reliant UNIX 5.44 Printed 11/98
delta(1) delta(1)
-m MR-list
If the SCCS file has the v flag set [see admin(1)] then a Modifi-
cation 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 screen, the prompt MRs? is issued on the standard output
before the standard input is read; if the standard input is not a
screen, no prompt is issued. The MRs? prompt always precedes the
comments? prompt (see -y). 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, it is taken to be the name
of a program or shell procedure 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 terminates. It is
assumed that the MR numbers were not all valid.
-y[comment]
comment is arbitrary text used to describe the reason for produc-
ing the delta. A null string is considered a valid comment. If -y
is not specified and the standard input is a screen, the prompt
comments? is issued on the standard output before the standard
input is read; if the standard input is not a screen, no prompt
is issued. An unescaped new-line character terminates the comment
text.
-p The SCCS file differences before and after the delta is applied
are printed on the standard output, in a diff(1) format.
-- If the first filename begins with a dash (-), the end of the
command-line options must be marked with --.
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 by - in the delta command line, the
-y and, if applicable, -m keyletters must also be present. Omission of
these keyletters causes an error.
Comments are limited to text strings of at most 1024 characters. Line
lengths greater than 1000 characters cause undefined results.
LOCALE
The language of the message texts is governed by the environment vari-
able LCALL, LCMESSAGES or LANG.
When the default is set, the system behaves as if it were not interna-
tionalized, i.e. the message texts are in English. You must change one
of these variables in order to change the language of the message
texts.
Page 2 Reliant UNIX 5.44 Printed 11/98
delta(1) delta(1)
Detailed information on the dependencies of the environment variables
and on internationalization in general can be found in the manual
"Programmer's Guide: Internationalization - Localization". Refer also
to environ(5) for information on setting the user environment.
FILES
g-file Existed before the execution of delta; removed after com-
pletion 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 com-
pletion 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 com-
pletion of delta.
bdiff Program to compute differences between the "gotten" file
and the g-file.
SEE ALSO
admin(1), bdiff(1), cdc(1), diff(1), get(1), help(1), prs(1),
rmdel(1), sccsfile(4).
Chapter on "SCCS" in the "Guide to Tools for Programming in C"
Page 3 Reliant UNIX 5.44 Printed 11/98