|
|
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.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.