Conventions Used in Describing Command Syntax

            Throughout  the  documentation  available from the 'help' command
            and in the _S_o_f_t_w_a_r_e _T_o_o_l_s _S_u_b_s_y_s_t_e_m _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l, the  syntax
            of  commands  is  described  through  the  use  of various 'meta-
            symbols'.  These symbols comprise a system of  notation  commonly
            known  as  'Backus-Naur  Form', or simply BNF.  What follows is a
            brief description of the BNF that is used in this documentation.

                 <>   A word or phrase enclosed in left and right angle brac-
                      kets stands for any string of characters whose  meaning
                      is  either  suggested by the word or phrase so enclosed
                      or explicitely defined later in the syntax.  For  exam-
                      ple,  "<number>"  might  stand  for  "127"  or  "3"  or
                      "98.6".  Words or phrases enclosed  in  these  brackets
                      are called 'meta-linguistic variables'.

                 ::=  This  symbol  means  "is defined as"  and it is used to
                      separate   a   meta-linguistic   variable   from    its
                      definition.  For example,

                           <number> ::= <integer>

                      would  be  read  "a  number  is defined as an integer."
                      Everything to the right of the "::=" is called a 'meta-
                      linguistic formula'.

                 |    The vertical bar means "or" and  is  used  to  separate
                      alternatives  within  a  meta-linguistic  formula.  For
                      example,

                           <number> ::= <integer> | <real>

                      would be read "a number is defined as an integer  or  a
                      real."

                 ()   Parentheses  are  used  to  enclose  a series of alter-
                      natives in a formula when the series comprises only one
                      part of the formula.  For example,

                           <signed_number> ::= (+|-)<number>

                      would be read "a signed number is  defined  as  a  plus
                      sign or a minus sign, followed by a number."

                 []   Formulae (or parts thereof) that are enclosed in square
                      brackets are optional.  For example,

                           <command> ::= <filename> [<parameters>]

                      would  be  read  "a  command  is defined as a filename,
                      optionally followed by parameters."

                 {}   Formulae that are  enclosed  in  curly  braces  may  be
                      repeated  any  number  of  times,  including zero.  For
                      example,










                           <integer> ::= <digit>{<digit>}

                      would be read "an integer is defined as  a  digit  fol-
                      lowed by zero or more digits."

            In  situations  where  the  syntax requires that one of the above
            meta-symbols  appear  literally,  the  symbol  is   enclosed   in
            apostrophes.  For example, in

                 <vertical_bar> ::= '|'

            the  vertical  bar  on  the  right  hand side is interpreted as a
            literal character, not as an "or" symbol.