usr/man/cat1/liszt.0



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


N\bNA\bAM\bME\bE
     liszt - compile a Franz Lisp program

S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
     l\bli\bis\bsz\bzt\bt [ -\b-m\bmp\bpq\bqr\bru\buw\bwx\bxC\bCQ\bQS\bST\bT ] [ -\b-e\be form ] [ -\b-o\bo objfile ]        [ name ]

D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
     _\bL_\bi_\bs_\bz_\bt 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 _\bl_\bi_\bs_\bz_\bt.

     -\b-e\be   Evaluate the given form before compilation begins.

     -\b-m\bm   Compile a MACLISP file, by changing the readtable to
          conform to MACLISP syntax and including a macro-defined
          compatibility package.

     -\b-o\bo   Put the object code in the specified file, rather than
          the default `.o' file.

     -\b-p\bp   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 _\bp_\br_\bo_\bf(1).)

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

     -\b-r\br   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.

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

     -\b-w\bw   Suppress warning diagnostics.

     -\b-x\bx   Create a lisp cross reference file with the same name
          as the source file but with  `.x' appended.  The pro-
          gram _\bl_\bx_\br_\be_\bf(1) reads this file and creates a human read-
          able cross reference listing.

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

     -\b-Q\bQ   Print compilation statistics and warn of strange


Printed 7/9/88           April 29, 1985                         1


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


          constructs.  This is the default.

     -\b-S\bS   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.

     -\b-T\bT   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
     _\bl_\bi_\bs_\bp(1) top-level command interpreter.  You can compile a
     file by using the function _\bl_\bi_\bs_\bz_\bt (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 _\bl_\bi_\bs_\bz_\bt supplies the ``.l'' extension for you.

F\bFI\bIL\bLE\bES\bS
     /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

A\bAU\bUT\bTH\bHO\bOR\bR
     John Foderaro

S\bSE\bEE\bE A\bAL\bLS\bSO\bO
     lisp(1), lxref(1)


Printed 7/9/88           April 29, 1985                         2