Commit | Line | Data |
---|---|---|
d9d7a9f0 CL |
1 | .\" Copyright (c) 1980, 1990 The Regents of the University of California. |
2 | .\" All rights reserved. | |
0f4c8ef5 | 3 | .\" |
d9d7a9f0 | 4 | .\" %sccs.include.redist.man% |
0f4c8ef5 | 5 | .\" |
d0719240 | 6 | .\" @(#)liszt.1 6.3 (Berkeley) %G% |
d9d7a9f0 CL |
7 | .\" |
8 | .Dd | |
9 | .Dt LISZT 1 | |
10 | .Os BSD 4 | |
11 | .Sh NAME | |
12 | .Nm liszt | |
13 | .Nd compile a Franz Lisp program | |
14 | .Sh SYNOPSIS | |
15 | .Nm liszt | |
16 | .Op Fl mpqruwxCQST | |
17 | .Op Fl e Ar form | |
18 | .Op Fl o Ar objfile | |
19 | .Op Ar name | |
20 | .Sh DESCRIPTION | |
21 | .Nm Liszt | |
22 | takes a file whose names ends in `.l' and compiles the FRANZ | |
23 | LISP | |
0f4c8ef5 KM |
24 | code there leaving an object program on the file whose name is that of the |
25 | source with `.o' substituted for `.l'. | |
d9d7a9f0 | 26 | .Pp |
0f4c8ef5 | 27 | The following options are interpreted by |
d9d7a9f0 CL |
28 | .Nm liszt . |
29 | .Tw Fl | |
30 | .Tp Fl e | |
0720d54e | 31 | Evaluate the given form before compilation begins. |
d9d7a9f0 CL |
32 | .Tp Fl m |
33 | Compile a MACLISP | |
34 | file, by changing the readtable to conform to | |
35 | MACLISP | |
36 | syntax and including a macro-defined compatibility package. | |
37 | .Tp Fl o | |
0f4c8ef5 | 38 | Put the object code in the specified file, rather than the default `.o' file. |
d9d7a9f0 | 39 | .Tp Fl p |
0f4c8ef5 KM |
40 | places profiling code at the beginning of each non-local function. |
41 | If the lisp system is also created with profiling in it, this allows | |
42 | function calling frequency to be determined (see | |
d9d7a9f0 CL |
43 | .Xr prof 1 . ) |
44 | .Tp Fl q | |
0f4c8ef5 KM |
45 | Only print warning and error messages. |
46 | Compilation statistics and notes on correct but unusual constructs | |
47 | will not be printed. | |
d9d7a9f0 | 48 | .Tp Fl r |
0f4c8ef5 KM |
49 | place bootstrap code at the beginning of the object file, which when |
50 | the object file is executed will cause a lisp system to be invoked | |
51 | and the object file fasl'ed in. | |
d9d7a9f0 | 52 | .Tp Fl u |
0f4c8ef5 KM |
53 | Compile a UCI-lispfile, by changing the readtable to conform to |
54 | UCI-Lisp syntax and including a macro-defined compatibility package. | |
d9d7a9f0 | 55 | .Tp Fl w |
0f4c8ef5 | 56 | Suppress warning diagnostics. |
d9d7a9f0 | 57 | .Tp Fl x |
0f4c8ef5 KM |
58 | Create a lisp cross reference file with the same name as the source |
59 | file but with `.x' appended. | |
d9d7a9f0 CL |
60 | The program |
61 | .Xr lxref 1 | |
0f4c8ef5 KM |
62 | reads this file and creates a human readable cross |
63 | reference listing. | |
d9d7a9f0 | 64 | .Tp Fl C |
0f4c8ef5 KM |
65 | put comments in the assembler output of the compiler. Useful |
66 | for debugging the compiler. | |
d9d7a9f0 | 67 | .Tp Fl Q |
0f4c8ef5 | 68 | Print compilation statistics and warn of strange constructs. |
d9d7a9f0 CL |
69 | This is the default. |
70 | .Tp Fl S | |
0f4c8ef5 KM |
71 | Compile the named program and leave the assembler-language output on |
72 | the corresponding file suffixed `.s'. | |
73 | This will also prevent the assembler language file from being assembled. | |
d9d7a9f0 | 74 | .Tp Fl T |
0f4c8ef5 | 75 | send the assembler output to standard output. |
d9d7a9f0 CL |
76 | .Tp |
77 | .Pp | |
78 | If | |
0f4c8ef5 | 79 | no source file is specified, then the compiler will run interactively. |
d9d7a9f0 CL |
80 | You will find yourself talking to the |
81 | .Xr lisp 1 | |
0f4c8ef5 KM |
82 | top-level command interpreter. |
83 | You can compile a file by using the | |
84 | function | |
d9d7a9f0 | 85 | .Nm liszt |
0f4c8ef5 | 86 | (an nlambda) with the same arguments as you use on the command line. |
d9d7a9f0 CL |
87 | For example to compile `foo', a MACLISP |
88 | file, you would use: | |
89 | .Pp | |
90 | .Dl (liszt \-m foo) | |
91 | .Pp | |
0f4c8ef5 | 92 | Note that |
d9d7a9f0 | 93 | .Nm liszt |
0f4c8ef5 | 94 | supplies the ``.l'' extension for you. |
d9d7a9f0 CL |
95 | .Sh FILES |
96 | .Dw /usr/lib/lisp/machacks.l | |
97 | .Di L | |
98 | .Dp Pa /usr/lib/lisp/machacks.l | |
99 | MACLISP | |
100 | compatibility package | |
101 | .Dp Pa /usr/lib/lisp/syscall.l | |
102 | macro definitions of Unix system calls | |
103 | .Dp Pa /usr/lib/lisp/ucifnc.l | |
104 | UCI Lisp compatibility package | |
105 | .Dp | |
106 | .Sh AUTHOR | |
0f4c8ef5 | 107 | John Foderaro |
d9d7a9f0 CL |
108 | .Sh SEE ALSO |
109 | .Xr lisp 1 , | |
110 | .Xr lxref 1 | |
111 | .Sh ENVIRONMENT | |
112 | .Nm Liszt | |
113 | checks these | |
114 | environment variables; | |
115 | .Ev PATH , | |
116 | .Ev SHELL | |
117 | and | |
118 | .Ev TERM . | |
119 | .Sh HISTORY | |
120 | .Nm Lisp | |
121 | appeared in 3 BSD. |