splc (1) --- interface to Primos SPL compiler            08/27/84


          | _U_s_a_g_e

                 splc {-<option>[<level>]} <input file>
                          [-b [<binary file>]]
                          [-l [<listing file>]]
                          [-z <SPL option>]
                    <option> ::= c | d | e | f | h | k | m | n |
                                 o | p | q | r | s | v | w | x


            _D_e_s_c_r_i_p_t_i_o_n

                 'Splc'  serves  as the Subsystem interface to the Primos SPL
                 compiler (SPL).  It examines its option  specifications  and
                 checks  them  for consistency, provides Subsystem-compatible
                 default file names for  the  listing  and  binary  files  as
                 needed, and then produces a Primos SPL command and causes it
                 to be executed.

                 OOOppptttiiiooonnnsss

                 The  general  structure of an 'splc' option is a single let-
                 ter, possibly followed by a "level  number"  indicating  the
                 extent to which an option should be employed.  The following
                 list  outlines the options and the meanings of their various
                 levels.  The first line of  each  description  contains  the
                 option  letter  followed  by  its  default level enclosed in
                 parentheses, the  range  of  available  levels  enclosed  in
                 square  brackets,  and  a  brief description of the option's
                 purpose.  In all cases, when an option is specified  without
                 a level number, the maximum allowable value is assumed.


                 -c(0) [0..1] - Case mapping.

                      Level 0 forces case to be insignificant in identifiers.
                      Upper case identifiers are considered the same as lower
                      case identifiers.

                      Level  1  cause  case  to  significant  in identifiers.
                      Upper case identifiers are  considered  different  from
                      lower case identifiers.

                 -d(0) [0..2] - Debugging control.

                      Level  0  prevents all debugging information from being
                      included in the generated code.  A program so  compiled
                      may not be used with the source level debugger.

                      Level  1  allows  limited  debugging  information to be
                      included in the generated code, but does not  interfere
                      with optimization.

                      Level  2  causes  complete  debugging information to be
                      included   in   the   generated   code   and   inhibits
                      optimization.   (Cannot be used when the "-o" option is


            splc (1)                      - 1 -                      splc (1)




            splc (1) --- interface to Primos SPL compiler            08/27/84


                      specified with a level greater than zero.)

                 -e(1) [0..1] - Error listing on terminal.

                      Level 0 inhibits the printing of compilation errors  on
                      the user's terminal.

                      Level  1 causes compilation errors to be printed on the
                      terminal.

                 -f(2) [0..3] - Symbol table map and offset map control.

                      Level 0 inhibits the  generation  of  either  a  symbol
                      table  map  or  a  storage offset map.  (Cannot be used
                      when the "-x" option is specified with a level  greater
                      than zero.)

                      Level  1  causes  the  generation  of a map listing the
                      storage offset of  each  program  variable,  but  still
                      inhibits the generation of a a symbol table map.  (Can-
                      not  be  used  when the "-x" option is specified with a
                      level greater than zero.)

                      Level 2 causes the generation of a map listing the sym-
                      bol names appearing in the program,  but  inhibits  the
                      generation of a storage offset map.

                      Level  3 causes the generation of both the symbol table
                      and storage offset maps.

                 -h(0) [0..1] - Huge (multi-segment) arrays.

                      Level 0 insures that dummy arrays and array  parameters
                      will not be treated as multi-segment arrays.

                      Level  1  causes  references  to dummy arrays and array
                      parameters to generate code that will work even if  the
                      arrays  are  larger  than  one  segment  (64K words) in
                      length.

                 -k(0) [0..1] - Compilation statistics.

                      Level 0 inhibits the display of compilation  statistics
                      on the terminal.

                      Level 1 causes the display of compilation statistics on
                      the terminal.

                 -m(2) [2..2] - Addressing mode.

                      Level  2  implies 64V addressing mode.  At present this
                      is the only addressing mode fully supported  under  the
                      Subsystem.





            splc (1)                      - 2 -                      splc (1)




            splc (1) --- interface to Primos SPL compiler            08/27/84


                 -n(1) [0..1] - Nesting level indicator.

                      Level  0  inhibits the printing of the nesting level of
                      each statement on the listing.

                      Level 1 causes the printing of  the  nesting  level  of
                      each statement.

                 -o(1) [0..1] - Optimization control.

                      Level 0 turns off all optimizations.

                      Level  1 turns on optimizations.  This option cannot be
                      used with full debugging (-d2).

                 -p(0) [0..1] - Quick call of internal subroutines.

                      Level 0 causes all internal subroutines  to  be  called
                      with the normal procedure call (PCL) mechanism.

                      Level  1  causes internal subroutines to be "quick cal-
                      led" (shortcalled) whenever possible.  This option can-
                      not be used with full debugging (-d2).

                 -q(1) [0..1] - Suppress warning messages.

                      Level 0 inhibits the display of compiler  warning  mes-
                      sages.

                      Level  1  allows  the  display of compiler warning mes-
                      sages.

                 -r(0) [0..1] - Range checking.

                      Level 0 inhibits run-time checking  of  subscripts  and
                      substrings.

                      Level 1 causes the compiler to insert code for the run-
                      time checking of subscripts and substrings.

                 -s(1) [0..1] - Constant copying for subroutine calls.

                      Level  0  inhibits  the  copying of constants into tem-
                      porary variables for passing as subroutine parameters.

                      Level 1 causes the compiler to copy constants into tem-
                      porary variables before calling subroutines.

                 -v(1) [0..2] - Listing verbosity.

                      Level 0 prevents the listing of source code, but allows
                      the listing  of  error  messages  and  statements  that
                      caused them.

                      Level 1 generates a full source code listing.



            splc (1)                      - 3 -                      splc (1)




            splc (1) --- interface to Primos SPL compiler            08/27/84


                      Level  2  generates  a  full source code listing plus a
                      representation of the machine code generated  for  each
                      statement.

                 -w(0) [0..1] - Generate floating round instructions.

                      Level 0 does not generate floating round (FRN) instruc-
                      tions.

                      Level  1 cause a floating round (FRN) instruction to be
                      generated before every floating store (FST) instruction
                      in the code produced by the SPL compiler.  This  option
                      improves  the  accuracy  of  single  precision floating
                      point calculations at some slight run-time  performance
                      expense.

                 -x(1) [0..1] - Cross-reference listing control.

                      Level 0 inhibits the generation of a cross-reference.

                      Level  1  causes  the  compiler  to  generate  a cross-
                      reference listing.   (Cannot  be  used  when  the  "-f"
                      option is specified with a level less than two.)

                 In addition to the options above, the "-z" option allows the
                 explicit passing of a string verbatim into the command line.

                 FFFiiillleee CCCooonnntttrrrooolll

                 The  "-b"  option  is used to select the name of the file to
                 receive the binary object code output of the compiler.  If a
                 file name follows the option, then that  file  receives  the
                 object  code.  (Note that if "/dev/null" is specified as the
                 file name, no object code will be produced.)  If the  option
                 is  not  specified,  or  no  file name follows it, a default
                 filename is constructed from the input filename by  changing
                 its  suffix  to ".b".  For example, if the input filename is
                 "prog.spl", the binary file will be "prog.b"; if  the  input
                 filename is "foo", the binary file will be "foo.b".

                 The  "-l"  option  is used to select the name of the file to
                 receive the listing generated by the compiler.   If  a  file
                 name  follows  the  option,  then  that  file  receives  the
                 listing.  The file name "/dev/null" may be used  to  inhibit
                 the  listing; "/dev/tty" to cause it to appear on the user's
                 terminal; "/dev/lps" to cause it to be spooled to  the  line
                 printer.   If  the  "-l"  option is specified without a file
                 name following it, a default filename  is  constructed  from
                 the  input  filename  by  changing  its suffix to ".l".  For
                 example, if the input filename is "gonzo.spl",  the  listing
                 file  will be "gonzo.l"; if the input filename is "bar", the
                 listing file will be "bar.l".  If the  "-l"  option  is  not
                 used, no listing is produced.

                 The  input  filename  may  be  either a disk file name (con-
                 ventionally ending in ".spl").  or the device "/dev/tty", in


            splc (1)                      - 4 -                      splc (1)




            splc (1) --- interface to Primos SPL compiler            08/27/84


                 which case input to the compiler is  read  from  the  user's
                 terminal.

                 In  summary,  then, the default command line for compiling a
                 file named "file.spl" is

                      splc -c0d0e1f2h0k0m2n1o1p0q1r0s1v1w0x1 _
                           file.spl  -b file.b  -l /dev/null

                 which corresponds to the SPL command

                      spl -i *>file.spl -b *>file.b -l no



            _E_x_a_m_p_l_e_s

                 splc file.spl
                 splc -kf dmach.spl
                 splc -x dmach.spl -b b_dmach -l l_dmach
                 splc -m2 v_mode_prog.spl -z"-newopt"


            _M_e_s_s_a_g_e_s

                 "Usage:  splc ..."  for invalid option syntax.
                 "level  numbers   for   -<option>   are   <lower bound>   to
                      <upper bound>"  if  an  out-of-range  level  number  is
                      specified.
                 "missing input file name" if  no  input  filename  could  be
                      found.
                 "<name>:   unreasonable  input  file name" if an attempt was
                      made to read from the null device or the  line  printer
                      spooler.
                 "<name>:   unreasonable  binary file name" if an attempt was
                      made to produce object code on  the  terminal  or  line
                      printer spooler.
                 "inconsistency  in  internal  tables"  if the tables used to
                      process the options are incorrectly constructed.   This
                      message  indicates  a serious error in the operation of
                      'splc'  that  should  be  reported   to   your   system
                      administrator.

                 Numerous other self-explanatory messages may be generated to
                 diagnose conflicts between selected options.


            _B_u_g_s

                 'Splc' pays no attention to standard ports.


            _S_e_e _A_l_s_o

          |      ld (1), splcl (1), bind (3)



            splc (1)                      - 5 -                      splc (1)