


      DDDDEEEELLLLTTTTAAAA((((1111))))                    ((((UUUUNNNNIIIIXXXX 5555....0000))))                   DDDDEEEELLLLTTTTAAAA((((1111))))



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

      SSSSYYYYNNNNTTTTAAAAXXXX
           ddddeeeellllttttaaaa [----rrrrSID] [----ssss] [----nnnn] [----gggglist] [----mmmm[mrlist]] [----yyyy[comment]]
           [----pppp] files

      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
           _D_e_l_t_a permanently introduces into the named SCCS file
           changes that were made to the file retrieved by _g_e_t(1)
           (called the _g-_f_i_l_e, or generated file).

           _D_e_l_t_a makes a delta to each named SCCS file.  If a directory
           is named, _d_e_l_t_a 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 ssss....) and
           unreadable files are silently ignored.  If a name of ---- is
           given, the standard input is read (see _W_A_R_N_I_N_G_S); each line
           of the standard input is taken to be the name of an SCCS
           file to be processed.

           _D_e_l_t_a may issue prompts on the standard output, depending
           upon certain keyletters specified and flags (see _a_d_m_i_n(1))
           that may be present in the SCCS file (see ----mmmm and ----yyyy
           keyletters below).

           Keyletter arguments apply independently to each named file.

                ----rrrr_S_I_D          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 _g_e_ts for editing (ggggeeeetttt
                               ----eeee) on the same SCCS file were done by
                               the same person (login name).  The SID
                               value specified with the ----rrrr keyletter
                               can be either the SID specified on the
                               _g_e_t command line or the SID to be made
                               as reported by the _g_e_t command (see
                               _g_e_t(1)).  A diagnostic results if the
                               specified SID is ambiguous, or, if
                               necessary and omitted on the command
                               line.

                ----ssss             Suppresses the issue of the created
                               delta's SID on the standard output; as
                               well as the number of lines inserted,
                               deleted and unchanged in the SCCS file.

                ----nnnn             Specifies retention of the edited _g-_f_i_l_e
                               (normally removed at completion of delta
                               processing).




      Page 1                                                   (9010-E)






      DDDDEEEELLLLTTTTAAAA((((1111))))                    ((((UUUUNNNNIIIIXXXX 5555....0000))))                   DDDDEEEELLLLTTTTAAAA((((1111))))



                ----gggg_l_i_s_t         Specifies a _l_i_s_t (see _g_e_t(1) for the
                               definition of _l_i_s_t) of deltas which are
                               to be _i_g_n_o_r_e_d when the file is accessed
                               at the change level (SID) created by
                               this delta.

                ----mmmm[_m_r_l_i_s_t]     If the SCCS file has the vvvv flag set (see
                               _a_d_m_i_n(1)) then a Modification Request
                               (MMMMRRRR) number _m_u_s_t be supplied as the
                               reason for creating the new delta.

                               If ----mmmm is not used and the standard input
                               is a terminal, the prompt MMMMRRRRssss???? 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 MMMMRRRRssss???? prompt always precedes
                               the ccccoooommmmmmmmeeeennnnttttssss???? prompt (see ----yyyy keyletter).

                               MMMMRRRRs in a list are separated by blanks
                               and/or tab characters.  An unescaped
                               new-line character terminates the MMMMRRRR
                               list.

                               Note that if the vvvv flag has a value (see
                               _a_d_m_i_n(1)), it is taken to be the name of
                               a program (or shell procedure) which
                               will validate the correctness of the MMMMRRRR
                               numbers.  If a non-zero exit status is
                               returned from MMMMRRRR number validation
                               program, _d_e_l_t_a terminates (it is assumed
                               that the MMMMRRRR numbers were not all valid).

                ----yyyy[_c_o_m_m_e_n_t]    Arbitrary text used to describe the
                               reason for making the delta.  A null
                               string is considered a valid _c_o_m_m_e_n_t.

                               If ----yyyy is not specified and the standard
                               input is a terminal, the prompt
                               ccccoooommmmmmmmeeeennnnttttssss???? 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.

                ----pppp             Causes _d_e_l_t_a to print (on the standard
                               output) the SCCS file differences before
                               and after the delta is applied in a
                               _d_i_f_f(1) format.

      FFFFIIIILLLLEEEESSSS



      PPPPaaaaggggeeee 2222                                                   ((((9999000011110000----EEEE))))






      DDDDEEEELLLLTTTTAAAA((((1111))))                    ((((UUUUNNNNIIIIXXXX 5555....0000))))                   DDDDEEEELLLLTTTTAAAA((((1111))))



           All files of the form ?-file are explained in the _S_o_u_r_c_e
           _C_o_d_e _C_o_n_t_r_o_l _S_y_s_t_e_m _U_s_e_r'_s _G_u_i_d_e.  The naming convention for
           these files is also described there.

           g-file           Existed before the execution of _d_e_l_t_a;
                            removed after completion of _d_e_l_t_a.
           p-file           Existed before the execution of _d_e_l_t_a; may
                            exist after completion of _d_e_l_t_a.
           q-file           Created during the execution of _d_e_l_t_a;
                            removed after completion of _d_e_l_t_a.
           x-file           Created during the execution of _d_e_l_t_a;
                            renamed to SCCS file after completion of
                            _d_e_l_t_a.
           z-file           Created during the execution of _d_e_l_t_a;
                            removed during the execution of _d_e_l_t_a.
           d-file           Created during the execution of _d_e_l_t_a;
                            removed after completion of _d_e_l_t_a.
           /usr/bin/bdiff   Program to compute differences between the
                            ``gotten'' file and the _g-_f_i_l_e.

      WWWWAAAARRRRNNNNIIIINNNNGGGGSSSS
           Lines beginning with an SSSSOOOOHHHH ASCII character (binary 001)
           cannot be placed in the SCCS file unless the SSSSOOOOHHHH is escaped.
           This character has special meaning to SCCS (see _s_c_c_s_f_i_l_e(5))
           and will cause an error.

           A _g_e_t of many SCCS files, followed by a _d_e_l_t_a of those
           files, should be avoided when the _g_e_t generates a large
           amount of data.  Instead, multiple _g_e_t/_d_e_l_t_a sequences
           should be used.

           If the standard input (----) is specified on the _d_e_l_t_a command
           line, the ----mmmm (if necessary) and ----yyyy keyletters _m_u_s_t also be
           present.  Omission of these keyletters causes an error to
           occur.

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

      SSSSEEEEEEEE AAAALLLLSSSSOOOO
           admin(1), bdiff(1), cdc(1), get(1), help(1), prs(1),
           rmdel(1), sccsfile(4).
           _S_o_u_r_c_e _C_o_d_e _C_o_n_t_r_o_l _S_y_s_t_e_m _U_s_e_r'_s _G_u_i_d_e in _R_O_S _U_t_i_l_i_t_y
           _G_u_i_d_e.

      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
           Use _h_e_l_p(1) for explanations.








      Page 3                                                   (9010-E)



