home *** CD-ROM | disk | FTP | other *** search
/ Borland Programmer's Resource / Borland_Programmers_Resource_CD_1995.iso / ntcode / gr564s / src / ms / rcsfile.5 < prev    next >
Encoding:
Text File  |  1995-05-19  |  7.7 KB  |  199 lines
  1.  
  2.  
  3.  
  4. RCSFILE(5)                                             RCSFILE(5)
  5.  
  6.  
  7. NNAAMMEE
  8.        rcsfile - format of RCS file
  9.  
  10. DDEESSCCRRIIPPTTIIOONN
  11.        An RCS file's contents are described by the grammar below.
  12.  
  13.        The text is free format: space, backspace, tab, newline,
  14.        vertical tab, form feed, and carriage return
  15.        (collectively, _w_h_i_t_e _s_p_a_c_e) have no significance except in
  16.        strings.  However, white space may not appear within an
  17.        id, num, or sym, and an RCS file must end with a newline.
  18.  
  19.        Strings are enclosed by @@.  If a string contains a @@, it
  20.        must be doubled; otherwise, strings may contain arbitrary
  21.        binary data.
  22.  
  23.        The meta syntax uses the following conventions: `|' (bar)
  24.        separates alternatives; `{' and `}' enclose optional
  25.        phrases; `{' and `}*' enclose phrases that may be repeated
  26.        zero or more times; `{' and '}+' enclose phrases that must
  27.        appear at least once and may be repeated; Terminal symbols
  28.        are in bboollddffaaccee; nonterminal symbols are in _i_t_a_l_i_c_s.
  29.  
  30.        _r_c_s_t_e_x_t    ::=  _a_d_m_i_n {_d_e_l_t_a}* _d_e_s_c {_d_e_l_t_a_t_e_x_t}*
  31.  
  32.        _a_d_m_i_n      ::=  hheeaadd       {_n_u_m};;
  33.                        { bbrraanncchh   {_n_u_m};; }
  34.                        aacccceessss     {_i_d}*;;
  35.                        ssyymmbboollss    {_s_y_m :: _n_u_m}*;;
  36.                        lloocckkss      {_i_d :: _n_u_m}*;;  {ssttrriicctt  ;;}
  37.                        { ccoommmmeenntt  {_s_t_r_i_n_g};; }
  38.                        { eexxppaanndd   {_s_t_r_i_n_g};; }
  39.                        { _n_e_w_p_h_r_a_s_e }*
  40.  
  41.        _d_e_l_t_a      ::=  _n_u_m
  42.                        ddaattee       _n_u_m;;
  43.                        aauutthhoorr     _i_d;;
  44.                        ssttaattee      {_i_d};;
  45.                        bbrraanncchheess   {_n_u_m}*;;
  46.                        nneexxtt       {_n_u_m};;
  47.                        { _n_e_w_p_h_r_a_s_e }*
  48.  
  49.        _d_e_s_c       ::=  ddeesscc       _s_t_r_i_n_g
  50.  
  51.        _d_e_l_t_a_t_e_x_t  ::=  _n_u_m
  52.                        lloogg        _s_t_r_i_n_g
  53.                        { _n_e_w_p_h_r_a_s_e }*
  54.                        tteexxtt       _s_t_r_i_n_g
  55.  
  56.        _n_u_m        ::=  {_d_i_g_i_t | ..}+
  57.  
  58.        _d_i_g_i_t      ::=  00 | 11 | 22 | 33 | 44 | 55 | 66 | 77 | 88 | 99
  59.  
  60.        _i_d         ::=  {_n_u_m} _i_d_c_h_a_r {_i_d_c_h_a_r | _n_u_m}*
  61.  
  62.  
  63.  
  64. GNU                         1992/07/28                          1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. RCSFILE(5)                                             RCSFILE(5)
  71.  
  72.  
  73.        _s_y_m        ::=  {_d_i_g_i_t}* _i_d_c_h_a_r {_i_d_c_h_a_r | _d_i_g_i_t}*
  74.  
  75.        _i_d_c_h_a_r     ::=  any visible graphic character except _s_p_e_c_i_a_l
  76.  
  77.        _s_p_e_c_i_a_l    ::=  $$ | ,, | .. | :: | ;; | @@
  78.  
  79.        _s_t_r_i_n_g     ::=  @@{any character, with @@ doubled}*@@
  80.  
  81.        _n_e_w_p_h_r_a_s_e  ::=  _i_d _w_o_r_d* ;;
  82.  
  83.        _w_o_r_d       ::=  _i_d | _n_u_m | _s_t_r_i_n_g | ::
  84.  
  85.        Identifiers are case sensitive.  Keywords are in lower
  86.        case only.  The sets of keywords and identifiers may
  87.        overlap.  In most environments RCS uses the ISO 8859/1
  88.        encoding: visible graphic characters are codes 041-176 and
  89.        240-377, and white space characters are codes 010-015 and
  90.        040.
  91.  
  92.        The _n_e_w_p_h_r_a_s_e productions in the grammar are reserved for
  93.        future extensions to the format of RCS files.  No
  94.        _n_e_w_p_h_r_a_s_e will begin with any keyword already in use.
  95.  
  96.        The _d_e_l_t_a nodes form a tree.  All nodes whose numbers
  97.        consist of a single pair (e.g., 2.3, 2.1, 1.3, etc.)  are
  98.        on the trunk, and are linked through the nneexxtt field in
  99.        order of decreasing numbers.  The hheeaadd field in the _a_d_m_i_n
  100.        node points to the head of that sequence (i.e., contains
  101.        the highest pair).  The bbrraanncchh node in the admin node
  102.        indicates the default branch (or revision) for most RCS
  103.        operations.  If empty, the default branch is the highest
  104.        branch on the trunk.
  105.  
  106.        All _d_e_l_t_a nodes whose numbers consist of 2_n fields (_n>=2)
  107.        (e.g., 3.1.1.1, 2.1.2.2, etc.)  are linked as follows.
  108.        All nodes whose first 2_n-1 number fields are identical are
  109.        linked through the nneexxtt field in order of increasing
  110.        numbers.  For each such sequence, the _d_e_l_t_a node whose
  111.        number is identical to the first 2_n-2 number fields of the
  112.        deltas on that sequence is called the branchpoint.  The
  113.        bbrraanncchheess field of a node contains a list of the numbers of
  114.        the first nodes of all sequences for which it is a
  115.        branchpoint.  This list is ordered in increasing numbers.
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130. GNU                         1992/07/28                          2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. RCSFILE(5)                                             RCSFILE(5)
  137.  
  138.  
  139.        Example:
  140.  
  141.                                   Head
  142.                                     |
  143.                                     |
  144.                                     v                        / \
  145.                                 ---------                   /   \
  146.           / \          / \      |       |      / \         /     \
  147.          /   \        /   \     |  2.1  |     /   \       /       \
  148.         /     \      /     \    |       |    /     \     /         \
  149.        /1.2.1.3\    /1.3.1.1\   |       |   /1.2.2.2\   /1.2.2.1.1.1\
  150.        ---------    ---------   ---------   ---------   -------------
  151.            ^            ^           |           ^             ^
  152.            |            |           |           |             |
  153.            |            |           v           |             |
  154.           / \           |       ---------      / \            |
  155.          /   \          |       \  1.3  /     /   \           |
  156.         /     \         ---------\     /     /     \-----------
  157.        /1.2.1.1\                  \   /     /1.2.2.1\
  158.        ---------                   \ /      ---------
  159.            ^                        |           ^
  160.            |                        |           |
  161.            |                        v           |
  162.            |                    ---------       |
  163.            |                    \  1.2  /       |
  164.            ----------------------\     /---------
  165.                                   \   /
  166.                                    \ /
  167.                                     |
  168.                                     |
  169.                                     v
  170.                                 ---------
  171.                                 \  1.1  /
  172.                                  \     /
  173.                                   \   /
  174.                                    \ /
  175.  
  176.                         Fig. 1: A revision tree
  177.  
  178.  
  179. IIDDEENNTTIIFFIICCAATTIIOONN
  180.        Author: Walter F. Tichy, Purdue University, West
  181.        Lafayette, IN, 47907.
  182.        Revision Number: 5.3; Release Date: 1992/07/28.
  183.        Copyright 1982, 1988, 1989 by Walter F. Tichy.
  184.        Copyright 1990, 1991, 1992 by Paul Eggert.
  185.  
  186. SSEEEE AALLSSOO
  187.        ci(1), co(1), ident(1), rcs(1), rcsdiff(1), rcsmerge(1),
  188.        rlog(1),
  189.        Walter F. Tichy, RCS--A System for Version Control,
  190.        _S_o_f_t_w_a_r_e_-_-_P_r_a_c_t_i_c_e _& _E_x_p_e_r_i_e_n_c_e 1155, 7 (July 1985),
  191.        637-654.
  192.  
  193.  
  194.  
  195.  
  196. GNU                         1992/07/28                          3
  197.  
  198.  
  199.