|
|
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.