4.3BSD-UWisc/man/cat1/liszt.1

LISZT(1)            UNIX Programmer's Manual             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 package.

     -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 function.  If the lisp system is also created
          with profiling in it, this allows function calling fre-
          quency 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 pro-
          gram _l_x_r_e_f(1) reads this file and creates a human read-
          able 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



Printed 12/27/86         April 29, 1985                         1






LISZT(1)            UNIX Programmer's Manual             LISZT(1)



          constructs.  This is the default.

     -S   Compile the named program and leave the assembler-
          language output 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
     interactively.  You will find yourself talking to the
     _l_i_s_p(1) top-level command 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)

























Printed 12/27/86         April 29, 1985                         2