Annotation of 43BSDReno/pgrm/lisp/man/liszt.1, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1980, 1990 The Regents of the University of California.
                      2: .\" All rights reserved.
                      3: .\"
                      4: .\" Redistribution and use in source and binary forms are permitted provided
                      5: .\" that: (1) source distributions retain this entire copyright notice and
                      6: .\" comment, and (2) distributions including binaries display the following
                      7: .\" acknowledgement:  ``This product includes software developed by the
                      8: .\" University of California, Berkeley and its contributors'' in the
                      9: .\" documentation or other materials provided with the distribution and in
                     10: .\" all advertising materials mentioning features or use of this software.
                     11: .\" Neither the name of the University nor the names of its contributors may
                     12: .\" be used to endorse or promote products derived from this software without
                     13: .\" specific prior written permission.
                     14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
                     15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
                     16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
                     17: .\"
                     18: .\"     @(#)liszt.1    6.2 (Berkeley) 6/24/90
                     19: .\"
                     20: .Dd June 24, 1990
                     21: .Dt LISZT 1
                     22: .Os BSD 4
                     23: .Sh NAME
                     24: .Nm liszt
                     25: .Nd compile a Franz Lisp program
                     26: .Sh SYNOPSIS
                     27: .Nm liszt
                     28: .Op Fl mpqruwxCQST
                     29: .Op Fl e Ar form
                     30: .Op Fl o Ar objfile
                     31: .Op Ar name
                     32: .Sh DESCRIPTION
                     33: .Nm Liszt
                     34: takes a file whose names ends in `.l' and compiles the FRANZ
                     35: LISP
                     36: code there leaving an object program on the file whose name is that of the
                     37: source with `.o' substituted for `.l'.
                     38: .Pp
                     39: The following options are interpreted by
                     40: .Nm liszt .
                     41: .Tw Fl
                     42: .Tp Fl e
                     43: Evaluate the given form before compilation begins.
                     44: .Tp Fl m
                     45: Compile a MACLISP
                     46: file, by changing the readtable to conform to
                     47: MACLISP
                     48: syntax and including a macro-defined compatibility package.
                     49: .Tp Fl o
                     50: Put the object code in the specified file, rather than the default `.o' file.
                     51: .Tp Fl p
                     52: places profiling code at the beginning of each non-local function.
                     53: If the lisp system is also created with profiling in it, this allows
                     54: function calling frequency to be determined (see
                     55: .Xr prof  1  . )
                     56: .Tp Fl q
                     57: Only print warning and error messages.
                     58: Compilation statistics and notes on correct but unusual constructs
                     59: will not be printed.
                     60: .Tp Fl r
                     61: place bootstrap code at the beginning of the object file, which when
                     62: the object file is executed will cause a lisp system to be invoked
                     63: and the object file fasl'ed in.
                     64: .Tp Fl u
                     65: Compile a UCI-lispfile, by changing the readtable to conform to
                     66: UCI-Lisp syntax and including a macro-defined compatibility package.
                     67: .Tp Fl w
                     68: Suppress warning diagnostics.
                     69: .Tp Fl x
                     70: Create a lisp cross reference file with the same name as the source
                     71: file but with  `.x' appended.
                     72: The program
                     73: .Xr lxref  1
                     74: reads this file and creates a human readable cross
                     75: reference listing.
                     76: .Tp Fl C
                     77: put comments in the assembler output of the compiler. Useful
                     78: for debugging the compiler.
                     79: .Tp Fl Q
                     80: Print compilation statistics and warn of strange constructs.
                     81: This is the default.
                     82: .Tp Fl S
                     83: Compile the named program and leave the assembler-language output on
                     84: the corresponding file suffixed `.s'.
                     85: This will also prevent the assembler language file from being assembled.
                     86: .Tp Fl T
                     87: send the assembler output to standard output.
                     88: .Tp
                     89: .Pp
                     90: If
                     91: no source file is specified, then the compiler will run interactively.
                     92: You will find yourself talking to the
                     93: .Xr lisp  1
                     94: top-level command interpreter.
                     95: You can compile a file by using the
                     96: function
                     97: .Nm liszt
                     98: (an nlambda) with the same arguments as you use on the command line.
                     99: For example to compile `foo', a MACLISP
                    100: file, you would use:
                    101: .Pp
                    102: .Dl (liszt \-m foo)
                    103: .Pp
                    104: Note that
                    105: .Nm liszt
                    106: supplies the ``.l'' extension for you.
                    107: .Sh FILES
                    108: .Dw /usr/lib/lisp/machacks.l
                    109: .Di L
                    110: .Dp Pa /usr/lib/lisp/machacks.l
                    111: MACLISP
                    112: compatibility package
                    113: .Dp Pa /usr/lib/lisp/syscall.l
                    114: macro definitions of Unix system calls
                    115: .Dp Pa /usr/lib/lisp/ucifnc.l
                    116: UCI Lisp compatibility package
                    117: .Dp
                    118: .Sh AUTHOR
                    119: John Foderaro
                    120: .Sh SEE ALSO
                    121: .Xr lisp 1 ,
                    122: .Xr lxref 1
                    123: .Sh ENVIRONMENT
                    124: .Nm Liszt
                    125: checks these
                    126: environment variables;
                    127: .Ev PATH ,
                    128: .Ev SHELL
                    129: and
                    130: .Ev TERM .
                    131: .Sh HISTORY
                    132: .Nm Lisp
                    133: appeared in 3 BSD.

unix.superglobalmegacorp.com

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