delta(1) CLIX delta(1)
NAME
delta - Makes a delta (change) to an SCCS file
SYNOPSIS
delta [-rSID] [-s] [-n] [-glist] [-m[mrlist]] [-y[comment]] [-p] files
The delta command introduces, into the named SCCS file, the changes made
to the file retrieved by the get command.
FLAGS
-rSID Identifies uniquely which delta is to be made to the SCCS
file. The use of this flag is necessary only if two or more
outstanding get commands for editing (get -e) on the same
SCCS file were entered by the same person (login name). The
SID value specified with the -r flag can either be the SID
specified on the get command line or the SID to be made as
reported by the get command (see get). An error message
appears if the specified SID is ambiguous or (if necessary)
omitted on the command line.
-s Suppresses the issue, on stdout, 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 (generated file),
normally removed after delta processing is complete.
-glist Gives a list (see get 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), then a
modification request (MR) number must be supplied as the
reason for creating the new delta.
If -m is not used and stdin is a terminal, the prompt MRs is
issued on stdout before stdin is read. If stdin is not a
terminal, no prompt is issued. The prompt AMRs? precedes
the prompt comments? (see the -y flag).
The 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), it is taken
as the name of a program or shell procedure validating the
correctness of the MR numbers. If a nonzero exit status
returns from the MR number validation program, delta
2/94 - Intergraph Corporation 1
delta(1) CLIX delta(1)
terminates. (It is assumed that not all MR numbers were
valid.)
-y[comment] Arbitrary text describing the reason for making a delta. A
NULL string is considered a valid comment.
If -y is not specified and stdin is a terminal, the prompt
comments? is issued on stdout before stdin is read. If
stdin is not a terminal, no prompt is issued. An unescaped
newline character terminates the comment text.
-p Causes delta to display (on stdout) the SCCS file
differences before and after the delta is applied in a diff
format.
DESCRIPTION
The delta command introduces, into the named SCCS file, changes made to
the file retrieved by the get command (called the g-file or generated
file).
The delta command makes a delta (change) to each named SCCS file. If a
directory is named, delta views each file in the directory as a named
file, except non-SCCS files (last pathname component does not begin with
s) and unreadable files are ignored. If a name of - is given, stdin is
read (see CAUTIONS). Each line of the stdin is taken as a name of a SCCS
file to be processed.
The delta command may issue prompts on stdout, depending upon the
command-line flags given and other flags (see admin) present in the SCCS
file. (See the -m and -y flag descriptions.
Flags specified on the command line are applied independently to each
named file.
EXAMPLES
The following example records the changes made to file1 and makes a new
delta assigned as Revision 1.3:
delta -r1.3 s.file
FILES
/usr/bin/bdiff
Program to compute differences between the file retrieved with get
and the g-file.
g-file Existed before the execution of delta; removed after completion of
delta.
2 Intergraph Corporation - 2/94
delta(1) CLIX delta(1)
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.
CAUTIONS
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) and causes an error.
Avoid using get to retrieve many SCCS files followed by a delta of those
files when the get command generates a large amount of data. Instead, use
multiple get/delta sequences.
If stdin (-) is specified on the delta command line, the -m (if necessary)
and -y flags must be present. Omission of these flags causes an error.
Comments are limited to text strings of 512 characters.
DIAGNOSTICS
Error messages are designed to be self-explanatory.
EXIT VALUES
Returns a value of 0 if successful; otherwise, 1.
RELATED INFORMATION
Commands: admin(1), cdc(1), get(1), prs(1), rmdel(1), bdiff(1), help(1)
Files: sccsfile(4)
2/94 - Intergraph Corporation 3