Annotation of 43BSDTahoe/man/man1/liszt.1, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1980 Regents of the University of California.
                      2: .\" All rights reserved.  The Berkeley software License Agreement
                      3: .\" specifies the terms and conditions for redistribution.
                      4: .\"
                      5: .\"    @(#)liszt.1     6.1 (Berkeley) 4/29/85
                      6: .\"
                      7: .TH LISZT 1 "April 29, 1985"
                      8: .UC 4
                      9: .SH NAME
                     10: liszt \- compile a Franz Lisp program
                     11: .SH SYNOPSIS
                     12: .B liszt
                     13: [
                     14: .B \-mpqruwxCQST
                     15: ] [
                     16: .B \-e
                     17: form
                     18: ] [
                     19: .B \-o
                     20: objfile
                     21: ]  [ name ]
                     22: .SH DESCRIPTION
                     23: .I Liszt
                     24: takes a file whose names ends in `.l' and compiles the F\s-2RANZ\s0 L\s-2ISP\s0
                     25: code there leaving an object program on the file whose name is that of the
                     26: source with `.o' substituted for `.l'.
                     27: .PP
                     28: The following options are interpreted by
                     29: .I liszt.
                     30: .TP
                     31: .B \-e
                     32: Evaluate the given form before compilation begins.
                     33: .TP
                     34: .B \-m
                     35: Compile a M\s-2ACLISP\s0 file, by changing the readtable to conform to
                     36: \s-2MACLISP\s0 syntax and including a macro-defined compatibility package.
                     37: .TP
                     38: .B \-o
                     39: Put the object code in the specified file, rather than the default `.o' file.
                     40: .TP
                     41: .B \-p
                     42: places profiling code at the beginning of each non-local function.
                     43: If the lisp system is also created with profiling in it, this allows
                     44: function calling frequency to be determined (see
                     45: .IR prof (1).)
                     46: .TP
                     47: .B \-q
                     48: Only print warning and error messages.
                     49: Compilation statistics and notes on correct but unusual constructs
                     50: will not be printed.
                     51: .TP
                     52: .B \-r
                     53: place bootstrap code at the beginning of the object file, which when
                     54: the object file is executed will cause a lisp system to be invoked
                     55: and the object file fasl'ed in.
                     56: .TP
                     57: .B \-u
                     58: Compile a UCI-lispfile, by changing the readtable to conform to
                     59: UCI-Lisp syntax and including a macro-defined compatibility package.
                     60: .TP
                     61: .B \-w
                     62: Suppress warning diagnostics.
                     63: .TP
                     64: .B \-x
                     65: Create a lisp cross reference file with the same name as the source
                     66: file but with  `.x' appended.
                     67: The program 
                     68: .IR lxref (1) 
                     69: reads this file and creates a human readable cross
                     70: reference listing.
                     71: .TP
                     72: .B \-C
                     73: put comments in the assembler output of the compiler. Useful
                     74: for debugging the compiler.
                     75: .TP
                     76: .B -Q
                     77: Print compilation statistics and warn of strange constructs.
                     78: This is the default. 
                     79: .TP
                     80: .B \-S
                     81: Compile the named program and leave the assembler-language output on
                     82: the corresponding file suffixed `.s'.
                     83: This will also prevent the assembler language file from being assembled.
                     84: .TP
                     85: .B \-T
                     86: send the assembler output to standard output.
                     87: .PP
                     88: If 
                     89: no source file is specified, then the compiler will run interactively.
                     90: You will find yourself talking to the 
                     91: .IR lisp (1)
                     92: top-level command interpreter.
                     93: You can compile a file by using the
                     94: function
                     95: .I liszt 
                     96: (an nlambda) with the same arguments as you use on the command line.
                     97: For example to compile `foo', a M\s-2ACLISP\s0 file, you would use:
                     98: .IP
                     99: (liszt \-m foo)
                    100: .PP
                    101: Note that
                    102: .I liszt
                    103: supplies the ``.l'' extension for you.
                    104: .SH FILES
                    105: .ta 2.4i
                    106: .nf
                    107: /usr/lib/lisp/machacks.l       M\s-2ACLISP\s0 compatibility package
                    108: /usr/lib/lisp/syscall.l        macro definitions of Unix system calls 
                    109: /usr/lib/lisp/ucifnc.l UCI Lisp compatibility package
                    110: .fi
                    111: .SH AUTHOR
                    112: John Foderaro
                    113: .SH SEE ALSO
                    114: lisp(1), lxref(1)

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.