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