L>delta(CP)
DOC HOMESITE MAPMAN PAGESGNU INFOSEARCHPRINT BOOK
delta(CP)delta --make a delta (change) to an SCCS fileSyntaxdelta <-rSID> <-s> <-n> <-glist> <-m> <-y> <-p> filesdelta -DescriptionThe delta command is used to introduce into the namedSCCS file changes that were made to the file retrieved byget(CP)(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 thougheach file in the directory were specified as a named file,except that non-SCCS filesand 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 takento be the name of an SCCS file to be processed.The delta command may issue prompts on the standardoutput depending upon certain options specified and flags (seeadmin(CP))that may be present in theSCCS file (see -m and -y options below).Options apply independently to each named file.-rSIDUniquely identifies which delta is to be made to the SCCS file.The use of this option is necessary only if two or moreoutstanding gets for editing (get -e)on the same SCCS file were done by the same person (login name).The SID value specified with the -roption can be either the SID specified on theget command line or the SID to be madeas reported by the get command (seeget(CP)).A diagnostic results if the specified SID isambiguous or if a required SID is omitted on thecommand line.-sSuppresses the issue, on the standard output, of the createddelta"s SID, as well as the number of lines inserted,deleted, and unchanged in the SCCS file.-nSpecifies retention of the edited g-file (normallyremoved at completion of delta processing).-glista list (seeget(CP)for the definition of list) of deltas which are to beignored when the file is accessed at the change level(SID) created by this delta.-mIf the SCCS file has the v flag set (seeadmin(CP)),then a Modification Request (MR) number mustbe supplied as the reason for creating the new delta.If -m is not used and the standard input is aterminal, the prompt MRs? is issued on the standardoutput before the standard input is read; if the standardinput 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 new-line character terminates the MR list.Note that if the v flag has a value (seeadmin(CP)),it is taken to be the name of a program(or shell procedure) which validates MR numbers.If a non-zero exit status is returned from the MRnumber validation program, delta terminates.(It is assumed that the MR numbers were not all valid.)-yArbitrary 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 aterminal, the prompt comments? is issued on standardoutput before standard input is read; if standard input is nota terminal, no prompt is issued.An unescaped new-line character terminates the comment text.-pCauses delta to print (on standard output) theSCCS file differences before and after the delta isapplied in adiff(C)format.Filesd-fileCreated during the execution of delta; removed after completion.g-fileExisted before the execution of delta; removed after completion.p-fileExisted before the execution of delta; may exist after completion.q-fileCreated during the execution of delta; removed after completion.x-fileCreated during the execution of delta; renamed toSCCS file after completion.z-fileCreated and removed during the execution of delta. /usr/bin/bdiffProgram to compute differences between the ``gotten"" file andthe g-file.WarningsLines beginning with an ASCII SOH character(binary 001) cannot be placed in the SCCS fileunless the SOH is escaped.This character has special meaning to SCCS (seesccsfile(FP))and will cause an error.A get of many SCCS files, followed by adelta of those files, should be avoided when theget generates a large amount of data.Instead, multiple get/delta sequences should be used.If standard input (``-"") is specified on thedelta command line, the -m (if necessary)and -y options must also be present.Omission of these options causes an error.Comments are limited to text strings of at most 1020 characters.Line lengths greater than 1000 bytes may cause undefined behavior.Any change which results in more than 99,999 lines beingdeleted, inserted or remaining the same will result inan error message and may corrupt the data.See alsoadmin(CP),bdiff(C)cdc(CP),get(CP),prs(CP),rmdel(CP),sccsfile(FP)Standards conformancedelta is conformant with:X/Open Portability Guide, Issue 3, 1989.© 2005 The brianowens.tv Group, Inc. All rights reserved.brianowens.tv OpenServer Release 6.0.0 -- 02 June 2005