.\" SCCSID: @(#)delta.1	8.1	9/11/90.nr f 0.bd S B 3.de SP.if n .ul\%[\fB\-\\$1\fR\\c.if n .ul 0\\$2\\$3...de SF.if n .ul\%[\fB\-\\$1\fR].if n .ul 0...de AR.if \\nf \{ \.    RE.    nr f 0 \}.PP.RS 5.TP 15\fB\-\\$1\\fR\\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9.nr f 1...de C1.if \\nf \{ \.    RE.    nr f 0 \}.PP.RS 5.TP 15\\$1\\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9.nr f 1...de A1.if \\nf \{ \.    RE.    nr f 0 \}.PP.RS 5.TP 15\fB\-\\$1\fR[\fI\\$2\fR]\\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9.nr f 1...de A2.if \\nf \{ \.    RE.    nr f 0 \}.PP.RS 5.TP 15\fB\-\\$1\fI\\$2\fR\\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9.nr f 1...ds W)  \fI\s-1RESTRICTIONS\s+1\fR.ds M)  \fB\s-1MR\s+1\fR.ds S)  \s-1SCCS\s+1.ds I)  \s-1SID\s+1.TH delta 1.SH Namedelta \- create new SCCS delta to save changes.SH Syntax  .B delta[\fB\-r\fISID\fR\|] [\fB\-s\fR] [\fB\-n\fR] [\fB\-g\fIlist\fR\|][\fB\-m\fR\|[\fImrlist\fR\|]\|] [\fB\-y\fR\|[c\fIomment\fR\|]\|][\fB\-p\fR] \fIfiles\fR.SH Description.NXB "delta command (sccs)".NXA "delta command (sccs)" "rmdel command (sccs)".NXB "sccs preprocessor" "changing file"The.PN deltacommand is used to permanently introduce intothe named \*(S) file changes that were made to the file retrieved by.MS get 1(called the.IR g-file ,or generated file)..PPThe.PN deltacommandmakes a delta to each named \*(S) file.If a directory is named,.PN deltabehaves as though each file in the directory werespecified as a named file,except that non-\*(S) files(last component of the path name does not begin with \fBs.\fR)and unreadable filesare silently ignored.If a name of \fB\-\fR is given, the standard input is read(see RESTRICTIONS);each line of the standard input is taken to be the name of an \*(S) fileto be processed..PPThe.PN deltacommand may issue prompts on the standard output depending uponcertain keyletters specified and flagsthat may bepresent in the \*(S) file.For further information, see.B \-mand.B \-ykeyletters below and .MS admin 1 ..PPThe.PN deltaincludes commentary, input by the user,that consists of one or more lines,terminated by a period (.) incolumn one of a new line..PPKeyletter argumentsapply independentlyto each named file..SH Options.NXB "delta command (sccs)" "keyletters"Keyletter arguments:.IP \fB\-g\fIlist\fR 20Ignores specified list of deltas..IP \fB\-m\fR[\fImrlist\fR] 20Indicates the modification request number.  (\fB\-m\fR[\fImrlist\fR])..RS 20.spIf.B \-mis not used and the standard input is a terminal, the prompt.SM.B MR\*Ss?is issued on the standard output before the standard inputis read; if the standard input is not a terminal, no prompt is issued.The.SM.B MR\*Ss?prompt always precedes the.B comments?prompt(see.B \-ykeyletter)..PPMRs in a list are separated by blanks and/or tab characters.An unescaped new-line character terminates the \*(M) list..PPNotethat if the.B vflag has a valueit is taken to be the name of a program (or shell procedure) which will validatethe correctness of the \*(M) numbers.For further information, see .MS admin 1 .If a non-zero exit status is returned from \*(M) number validation program,.PN deltaterminates(it is assumed that the \*(M) numbers were not all valid)..RE.IP \fB\-n\fR 20Does not delete edited file..IP \fB\-p\fR 20Displays differences before and after delta is applied..IP \fB\-r\fISID\fR 20Identifies which delta is to be made to the \*(S) file.Use this keyletter only if two or moreoutstanding.IR get sfor editing.RB ( "get \-e" )on the same \*(S) file has been done by the same person(login name).The \*(I) value specified with the.B \-rkeyletter can be either the \*(I) specified on the.PN getcommand line or the \*(I) to be made as reported by the.PN getcommand.For further information, see .MS get 1 .A diagnostic results if the specified \*(I) is ambiguous, or,if necessary and omitted on the command line..IP \fB\-s\fR 20Suppresses all messages..IP \fB\-y\fR[\fIcomment\fR] 20Creates delta with specified commentary.textA null string is considered a valid \fIcomment\fR..brIf.B \-yis not specified and the standard input is a terminal, the prompt.B comments?is issued on the standard output before the standardinput is read; if the standard input is not a terminal, noprompt is issued.A period (.) in column one of a newline terminates the.I commenttext..RE.NXE "delta command (sccs)" "keyletters".SH Restrictions .NXR "delta command (sccs)" "restricted"Lines beginning with an \s-1\fBSOH\fP ASCII\s+1 character (binary 001)cannot be placed in the \*(S) file unless the.SM.B SOHis escaped.This character has special meaning to \*(S)and will cause an error.For further information, see.MS sccsfile 5 ..PPA.PN getof many \*(S) files,followed by a.PN deltaof those files, should be avoided when the.PN getgenerates a large amount of data.Instead,multiple.PN "get/delta\^"sequences should be used..PPIf the standard input(\fB\-\fR)is specified on the.PN deltacommand line, the.B \-m(if necessary)and.B \-ykeyletters must also be present.Omission of these keyletters causes an error to occur..PP.SH DiagnosticsSee.MS sccshelp 1for explanations..SH Files.TP 20g-fileExistedbefore the execution of.PN delta;removed after completion of.PN delta ..TPp-fileExistedbefore the execution of.B delta;may exist after completion of.PN delta ..TPq-fileCreated during the execution of.PN delta;removed after completion of.PN delta ..TPx-fileCreated during the execution of.PN delta;renamed to \*(S) file after completion of.PN delta ..TPz-fileCreated during the execution of.PN delta;removed during the execution of.PN delta ..TPd-fileCreated during the execution of.PN delta;removed after completion of.PN delta ..TP/usr/bin/bdiffProgram to compute differencesbetween the ``gotten'' file and the.IR g-file ..PD.SH See Alsoadmin(1), bdiff(1), cdc(1), get(1), help(1), prs(1),rmdel(1), sccs(1), sccsfile(5).br\fIGuide to the Source Code Control System\fP.NXE "sccs preprocessor" "changing file".NXE "delta command (sccs)"