delta(1) delta(1)NAME delta - makes a delta (change) to an SCCS file SYNOPSIS delta [-glist] [-m[mrlist]] [-n] [-p] [-rSID] [-s] [-y[comment]] file... ARGUMENTS file Specifies the file to be changed. -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. -m[mrlist] Requires that a Modification Request (MR) number be supplied as the reason for creating the new delta, if the SCCS file has the v option set (see admin(1)). If the -m option 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 option). 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 option has a value (see admin(1)), 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). -n Specifies retention of the edited g-file (normally removed at completion of delta processing). -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. January 1992 1
delta(1) delta(1)-rSID Identifies (uniquely) 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 message will display if the specified SID is ambiguous or 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. -y[comment] Specifies arbitrary text used to describe the reason for making the delta. A null string is considered a valid comment. If the comment includes spaces, you must enclose the entire string in double quotes. -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. 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). The delta command 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 pathname does not begin with s.) and unreadable files are silently ignored. If a hypen (-) 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. The delta command may issue prompts on the standard output depending upon certain keyletters specified and flags (see admin(1)) that may be present in the SCCS file (see -m and -y options above). 2 January 1992
delta(1) delta(1)EXAMPLES The command: % delta s.test1.c comments? second version 1.2 1 inserted 0 deleted 12 unchanged does a delta on file test1.c. STATUS MESSAGES AND VALUES Use help for explanations. 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 options must also be present. Omission of these keyletters causes an error to occur. Comments are limited to text strings of at most 512 characters. FILES /usr/bin/delta Executable file g-file File that existed before the execution of delta; removed after completion of delta p-file File that existed before the execution of delta; may exist after completion of delta q-file File that was created during the execution of delta; removed after completion of delta x-file File that was created during the execution of delta; renamed to SCCS file after completion of delta z-file File that was created during the execution of delta; removed during the execution of delta January 1992 3
delta(1) delta(1)d-file File that was created during the execution of delta; removed after completion of delta /usr/bin/bdiff File containing the program to compute differences between the ``gotten'' file and the g-file SEE ALSO admin(1), bdiff(1), cdc(1), get(1), help(1), prs(1), rmdel(1), sccs(1) sccsfile(4) in A/UX Programmer's Reference ``SCCS Reference,'' in A/UX Programming Languages and Tools, Volume 2 4 January 1992