Commit | Line | Data |
---|---|---|
e16dc90a C |
1 | .TH LISZT 1 "1 October 1980" |
2 | .UC 4 | |
3 | .SH NAME | |
4 | liszt \- compile a Franz Lisp program | |
5 | .SH SYNOPSIS | |
6 | .B liszt | |
7 | [ | |
8 | .B \-mpqruwxCQST | |
9 | ] [ | |
10 | .B \-o | |
11 | objfile | |
12 | ] [ name ] | |
13 | .SH DESCRIPTION | |
14 | .I Liszt | |
15 | takes a file whose names ends in `.l' and compiles the F\s-2RANZ\s0 L\s-2ISP\s0 | |
16 | code there leaving an object program on the file whose name is that of the | |
17 | source with `.o' substituted for `.l'. | |
18 | .PP | |
19 | The following options are interpreted by | |
20 | .I liszt. | |
21 | .TP | |
22 | .B \-m | |
23 | Compile a M\s-2ACLISP\s0 file, by changing the readtable to conform to | |
24 | \s-2MACLISP\s0 syntax and including a macro-defined compatibility package. | |
25 | .TP | |
26 | .B \-o | |
27 | Put the object code in the specified file, rather than the default `.o' file. | |
28 | .TP | |
29 | .B \-p | |
30 | places profiling code at the beginning of each non-local function. | |
31 | If the lisp system is also created with profiling in it, this allows | |
32 | function calling frequency to be determined (see | |
33 | .IR prof (1).) | |
34 | .TP | |
35 | .B \-q | |
36 | Only print warning and error messages. | |
37 | Compilation statistics and notes on correct but unusual constructs | |
38 | will not be printed. | |
39 | .TP | |
40 | .B \-r | |
41 | place bootstrap code at the beginning of the object file, which when | |
42 | the object file is executed will cause a lisp system to be invoked | |
43 | and the object file fasl'ed in. | |
44 | .TP | |
45 | .B \-u | |
46 | Compile a UCI-lispfile, by changing the readtable to conform to | |
47 | UCI-Lisp syntax and including a macro-defined compatibility package. | |
48 | .TP | |
49 | .B \-w | |
50 | Suppress warning diagnostics. | |
51 | .TP | |
52 | .B \-x | |
53 | Create a lisp cross reference file with the same name as the source | |
54 | file but with `.x' appended. | |
55 | The program | |
56 | .IR lxref (1) | |
57 | reads this file and creates a human readable cross | |
58 | reference listing. | |
59 | .TP | |
60 | .B \-C | |
61 | put comments in the assembler output of the compiler. Useful | |
62 | for debugging the compiler. | |
63 | .TP | |
64 | .B -Q | |
65 | Print compilation statistics and warn of strange constructs. | |
66 | This is the default. | |
67 | .TP | |
68 | .B \-S | |
69 | Compile the named program and leave the assembler-language output on | |
70 | the corresponding file suffixed `.s'. | |
71 | This will also prevent the assembler language file from being assembled. | |
72 | .TP | |
73 | .B \-T | |
74 | send the assembler output to standard output. | |
75 | .PP | |
76 | If | |
77 | no source file is specified, then the compiler will run interactively. | |
78 | You will find yourself talking to the | |
79 | .IR lisp (1) | |
80 | top-level command interpreter. | |
81 | You can compile a file by using the | |
82 | function | |
83 | .I liszt | |
84 | (an nlambda) with the same arguments as you use on the command line. | |
85 | For example to compile `foo', a M\s-2ACLISP\s0 file, you would use: | |
86 | .IP | |
87 | (liszt \-m foo) | |
88 | .PP | |
89 | Note that | |
90 | .I liszt | |
91 | supplies the ``.l'' extension for you. | |
92 | .SH FILES | |
93 | .ta 2.4i | |
94 | .nf | |
95 | /usr/lib/lisp/machacks.l M\s-2ACLISP\s0 compatibility package | |
96 | /usr/lib/lisp/syscall.l macro definitions of Unix system calls | |
97 | /usr/lib/lisp/ucifnc.l UCI Lisp compatibility package | |
98 | .fi | |
99 | .SH AUTHOR | |
100 | John Foderaro | |
101 | .SH SEE ALSO | |
102 | lisp(1), lxref(1) |