LISZT(1)                                                              LISZT(1)



NAME
       liszt - compile a Franz Lisp program

SYNOPSIS
       liszt [ -mpqruwxCQST ] [ -e form ] [ -o objfile ]  [ name ]

DESCRIPTION
       _L_i_s_z_t takes a file whose names ends in ‘.l’ and compiles the FRANZ LISP
       code there leaving an object program on the file whose name is that  of
       the source with ‘.o’ substituted for ‘.l’.

       The following options are interpreted by _l_i_s_z_t_.

       -e     Evaluate the given form before compilation begins.

       -m     Compile  a MACLISP file, by changing the readtable to conform to
              MACLISP syntax and including a macro-defined compatibility pack‐
              age.

       -o     Put  the  object  code  in  the  specified file, rather than the
              default ‘.o’ file.

       -p     places profiling code at the beginning of each  non-local  func‐
              tion.   If the lisp system is also created with profiling in it,
              this allows function calling frequency  to  be  determined  (see
              _p_r_o_f(1).)

       -q     Only  print  warning and error messages.  Compilation statistics
              and notes on correct but unusual constructs will not be printed.

       -r     place  bootstrap code at the beginning of the object file, which
              when the object file is executed will cause a lisp system to  be
              invoked and the object file fasl’ed in.

       -u     Compile  a UCI-lispfile, by changing the readtable to conform to
              UCI-Lisp syntax  and  including  a  macro-defined  compatibility
              package.

       -w     Suppress warning diagnostics.

       -x     Create  a  lisp  cross  reference file with the same name as the
              source file but with  ‘.x’ appended.  The program _l_x_r_e_f(1) reads
              this  file and creates a human readable cross reference listing.

       -C     put comments in the assembler output of the compiler. Useful for
              debugging the compiler.

       -Q     Print  compilation  statistics  and  warn of strange constructs.
              This is the default.

       -S     Compile the named program and leave the assembler-language  out‐
              put  on  the  corresponding  file suffixed ‘.s’.  This will also
              prevent the assembler language file from being assembled.

       -T     send the assembler output to standard output.

       If no source file is specified, then the  compiler  will  run  interac‐
       tively.   You  will find yourself talking to the _l_i_s_p(1) top-level com‐
       mand interpreter.  You can compile a file by using the  function  _l_i_s_z_t
       (an  nlambda)  with  the same arguments as you use on the command line.
       For example to compile ‘foo’, a MACLISP file, you would use:

              (liszt -m foo)

       Note that _l_i_s_z_t supplies the ‘‘.l’’ extension for you.

FILES
       /usr/lib/lisp/machacks.lMACLISP compatibility package
       /usr/lib/lisp/syscall.l macro definitions of Unix system calls
       /usr/lib/lisp/ucifnc.l  UCI Lisp compatibility package

AUTHOR
       John Foderaro

SEE ALSO
       lisp(1), lxref(1)



4th Berkeley Distribution       April 29, 1985                        LISZT(1)