


      SSSSCCCCCCCCSSSSFFFFIIIILLLLEEEE((((4444))))                 ((((UUUUNNNNIIIIXXXX 5555....0000))))                SSSSCCCCCCCCSSSSFFFFIIIILLLLEEEE((((4444))))



      NNNNAAAAMMMMEEEE
           sccsfile - format of SCCS file

      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
           An SCCS file is an ASCII file.  It consists of six logical
           parts:  the _c_h_e_c_k_s_u_m, the _d_e_l_t_a _t_a_b_l_e  (contains information
           about each delta), _u_s_e_r _n_a_m_e_s  (contains login names and/or
           numerical group IDs of users who may add deltas), _f_l_a_g_s
           (contains definitions of internal keywords), _c_o_m_m_e_n_t_s
           (contains arbitrary descriptive information about the file),
           and the _b_o_d_y (contains the actual text lines intermixed with
           control lines).

           Throughout an SCCS file there are lines which begin with the
           AAAASSSSCCCCIIIIIIII SSSSOOOOHHHH (start of heading) character (octal 001).  This
           character is hereafter referred to as _t_h_e _c_o_n_t_r_o_l _c_h_a_r_a_c_t_e_r
           and will be represented graphically as @.  Any line
           described below which is not depicted as beginning with the
           control character is prevented from beginning with the
           control character.

           Entries of the form DDDDDDDDDDDDDDDDDDDD represent a five digit string (a
           number between 00000 and 99999).

           Each logical part of an SCCS file is described in detail
           below.

           _C_h_e_c_k_s_u_m
                The checksum is the first line of an SCCS file.  The
                form of the line is:

                     @hhhhDDDDDDDDDDDDDDDDDDDD

                The value of the checksum is the sum of all characters,
                except those of the first line.  The @hhhh provides a
                _m_a_g_i_c _n_u_m_b_e_r  of (octal) 064001.

           _D_e_l_t_a _t_a_b_l_e
                The delta table consists of a variable number of
                entries of the form:
                     @ssss DDDDDDDDDDDDDDDDDDDD/DDDDDDDDDDDDDDDDDDDD/DDDDDDDDDDDDDDDDDDDD
                     @d <type> <SSSSCCCCCCCCSSSS IIIIDDDD> yr/mo/da hr:mi:se <pgmr> DDDDDDDDDDDDDDDDDDDD DDDDDDDDDDDDDDDDDDDD
                     @iiii DDDDDDDDDDDDDDDDDDDD ............
                     @xxxx DDDDDDDDDDDDDDDDDDDD ............
                     @gggg DDDDDDDDDDDDDDDDDDDD ............
                     @mmmm <MMMMRRRR number>
                       ....
                       ....
                       ....
                     @cccc <comments> ............
                       ....
                       ....



      Page 1                                                   (9010-E)






      SSSSCCCCCCCCSSSSFFFFIIIILLLLEEEE((((4444))))                 ((((UUUUNNNNIIIIXXXX 5555....0000))))                SSSSCCCCCCCCSSSSFFFFIIIILLLLEEEE((((4444))))



                       ....
                     @eeee

                The first line (@ssss) contains the number of lines
                inserted/deleted/unchanged respectively.  The second
                line (@dddd) contains the type of the delta (currently,
                normal: DDDD, and removed: RRRR), the SCCS ID of the delta,
                the date and time of creation of the delta, the login
                name corresponding to the real user ID at the time the
                delta was created, and the serial numbers of the delta
                and its predecessor, respectively.

                The @iiii, @xxxx, and @gggg lines contain the serial numbers of
                deltas included, excluded, and ignored, respectively.
                These lines are optional.

                The @mmmm lines (optional) each contain one MMMMRRRR number
                associated with the delta; the @cccc lines contain
                comments associated with the delta.

                The @eeee line ends the delta table entry.

           _U_s_e_r _n_a_m_e_s
                The list of login names and/or numerical group IDs of
                users who may add deltas to the file, separated by
                new-lines.  The lines containing these login names
                and/or numerical group IDs are surrounded by the
                bracketing lines @uuuu and @UUUU.  An empty list allows
                anyone to make a delta.

           _F_l_a_g_s
                Keywords used internally (see _a_d_m_i_n(1) for more
                information on their use).  Each flag line takes the
                form:

                     @ffff <flag> <optional text>

                The following flags are defined:
                     @ffff t <type of program>
                     @ffff v <program name>
                     @ffff i
                     @ffff b
                     @ffff m <module name>
                     @ffff f <floor>
                     @ffff c <ceiling>
                     @ffff d <default-sid>
                     @ffff n
                     @ffff j
                     @ffff l <lock-releases>
                     @ffff q <user defined>
                     @ffff z <reserved for use in interfaces>




      Page 2                                                   (9010-E)






      SSSSCCCCCCCCSSSSFFFFIIIILLLLEEEE((((4444))))                 ((((UUUUNNNNIIIIXXXX 5555....0000))))                SSSSCCCCCCCCSSSSFFFFIIIILLLLEEEE((((4444))))



                The tttt flag defines the replacement for the %%%%YYYY%%%%
                identification keyword.  The vvvv flag controls prompting
                for MMMMRRRR numbers in addition to comments; if the optional
                text is present it defines an MMMMRRRR number validity
                checking program.  The iiii flag controls the
                warning/error aspect of the ``No id keywords'' message.
                When the iiii flag is not present, this message is only a
                warning; when the iiii flag is present, this message will
                cause a ``fatal'' error (the file will not be gotten,
                or the delta will not be made).  When the bbbb flag is
                present the ----bbbb keyletter may be used on the _g_e_t command
                to cause a branch in the delta tree.  The mmmm flag
                defines the first choice for the replacement text of
                the %%%%MMMM%%%% identification keyword.  The ffff flag defines the
                ``floor'' release; the release below which no deltas
                may be added.  The cccc flag defines the ``ceiling''
                release; the release above which no deltas may be
                added.  The dddd flag defines the default SID to be used
                when none is specified on a _g_e_t command.  The nnnn flag
                causes _d_e_l_t_a to insert a ``null'' delta (a delta that
                applies _n_o changes) in those releases that are skipped
                when a delta is made in a _n_e_w release (e.g., when delta
                5.1 is made after delta 2.7, releases 3 and 4 are
                skipped).  The absence of the nnnn flag causes skipped
                releases to be completely empty.  The jjjj flag causes _g_e_t
                to allow concurrent edits of the same base SID.  The llll
                flag defines a _l_i_s_t of releases that are _l_o_c_k_e_d against
                editing (_g_e_t(1) with the ----eeee keyletter).  The qqqq flag
                defines the replacement for the %%%%QQQQ%%%% identification
                keyword.  zzzz flag is used in certain specialized
                interface programs.

           _C_o_m_m_e_n_t_s
                Arbitrary text surrounded by the bracketing lines @tttt
                and @TTTT.  The comments section typically will contain a
                description of the file's purpose.

           _B_o_d_y
                The body consists of text lines and control lines.
                Text lines don't begin with the control character,
                control lines do.  There are three kinds of control
                lines:  _i_n_s_e_r_t, _d_e_l_e_t_e, and _e_n_d, represented by:

                     @IIII DDDDDDDDDDDDDDDDDDDD
                     @DDDD DDDDDDDDDDDDDDDDDDDD
                     @EEEE DDDDDDDDDDDDDDDDDDDD

                respectively.  The digit string is the serial number
                corresponding to the delta for the control line.

      SSSSEEEEEEEE AAAALLLLSSSSOOOO
           admin(1), delta(1), get(1), prs(1).



      Page 3                                                   (9010-E)






      SSSSCCCCCCCCSSSSFFFFIIIILLLLEEEE((((4444))))                 ((((UUUUNNNNIIIIXXXX 5555....0000))))                SSSSCCCCCCCCSSSSFFFFIIIILLLLEEEE((((4444))))



           _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 the _I_n_t_e_r_a_c_t_i_v_e
           _A_c_c_e_s_s _t_o _R_O_S manual.





















































      Page 4                                                   (9010-E)



