Annotation of 43BSDReno/pgrm/lisp/man/liszt.1, revision 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.