DELTA(1)							      DELTA(1)

NAME    [Toc]    [Back]

     delta - make a delta (change) to an SCCS file

SYNOPSIS    [Toc]    [Back]

     delta [-r SID] [-s] [-n] [-g list]	[-m mrlist] [-y[comment]] [-p] files

DESCRIPTION    [Toc]    [Back]

     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 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 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 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).

	  -glist	 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]	 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 creating the new delta.




									Page 1






DELTA(1)							      DELTA(1)



			 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
			 procedure) which will validate	the correctness	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]	 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    [Toc]    [Back]

     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.
     /usr/bin/bdiff   Program to compute differences between the ``gotten''
		      file and the g-file.






									Page 2






DELTA(1)							      DELTA(1)

WARNINGS    [Toc]    [Back]

     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(4) (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.  Omission of these
     keyletters	causes an error	to occur.

     Comments are limited to text strings of at	most 512 characters.

SEE ALSO    [Toc]    [Back]

     admin(1), bdiff(1), cdc(1), get(1), help(1), prs(1), rmdel(1),
     sccsfile(4)

DIAGNOSTICS    [Toc]    [Back]

     Use help(1) for explanations.


									PPPPaaaaggggeeee 3333