[unix-history] / usr / man / cat1 / liszt.0



LISZT(1)	    UNIX Programmer's Manual		 LISZT(1)


N\bNA\bAM\bME\bE
     liszt - compile a Franz Lisp program

S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
     l\bli\bis\bsz\bzt\bt [ -\b-m\bmp\bpq\bqr\bru\buw\bwx\bxC\bCQ\bQS\bST\bT ] [ -\b-e\be form ] [ -\b-o\bo objfile ]	[ name ]

D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
     _\bL_\bi_\bs_\bz_\bt takes a file whose names ends in `.l' and compiles the
     FRANZ LISP code there leaving an object program on the file
     whose name is that of the source with `.o' substituted for
     `.l'.

     The following options are interpreted by _\bl_\bi_\bs_\bz_\bt.

     -\b-e\be   Evaluate the given form before compilation begins.

     -\b-m\bm   Compile a MACLISP file, by changing the readtable to
	  conform to MACLISP syntax and including a macro-defined
	  compatibility package.

     -\b-o\bo   Put the object code in the specified file, rather than
	  the default `.o' file.

     -\b-p\bp   places profiling code at the beginning of each non-
	  local function.  If the lisp system is also created
	  with profiling in it, this allows function calling fre-
	  quency to be determined (see _\bp_\br_\bo_\bf(1).)

     -\b-q\bq   Only print warning and error messages.  Compilation
	  statistics and notes on correct but unusual constructs
	  will not be printed.

     -\b-r\br   place bootstrap code at the beginning of the object
	  file, which when the object file is executed will cause
	  a lisp system to be invoked and the object file fasl'ed
	  in.

     -\b-u\bu   Compile a UCI-lispfile, by changing the readtable to
	  conform to UCI-Lisp syntax and including a macro-
	  defined compatibility package.

     -\b-w\bw   Suppress warning diagnostics.

     -\b-x\bx   Create a lisp cross reference file with the same name
	  as the source file but with  `.x' appended.  The pro-
	  gram _\bl_\bx_\br_\be_\bf(1) reads this file and creates a human read-
	  able cross reference listing.

     -\b-C\bC   put comments in the assembler output of the compiler.
	  Useful for debugging the compiler.

     -\b-Q\bQ   Print compilation statistics and warn of strange


Printed 7/9/88		 April 29, 1985                         1


LISZT(1)	    UNIX Programmer's Manual		 LISZT(1)


	  constructs.  This is the default.

     -\b-S\bS   Compile the named program and leave the assembler-
	  language output on the corresponding file suffixed
	  `.s'.  This will also prevent the assembler language
	  file from being assembled.

     -\b-T\bT   send the assembler output to standard output.

     If no source file is specified, then the compiler will run
     interactively.  You will find yourself talking to the
     _\bl_\bi_\bs_\bp(1) top-level command interpreter.  You can compile a
     file by using the function _\bl_\bi_\bs_\bz_\bt (an nlambda) with the same
     arguments as you use on the command line.	For example to
     compile `foo', a MACLISP file, you would use:

	  (liszt -m foo)

     Note that _\bl_\bi_\bs_\bz_\bt supplies the ``.l'' extension for you.

F\bFI\bIL\bLE\bES\bS
     /usr/lib/lisp/machacks.lMACLISP compatibility package
     /usr/lib/lisp/syscall.l macro definitions of Unix system calls
     /usr/lib/lisp/ucifnc.l  UCI Lisp compatibility package

A\bAU\bUT\bTH\bHO\bOR\bR
     John Foderaro

S\bSE\bEE\bE A\bAL\bLS\bSO\bO
     lisp(1), lxref(1)


Printed 7/9/88		 April 29, 1985                         2
Commit	Line	Data
362b077f C	1
	2
	3
	4	LISZT(1) UNIX Programmer's Manual LISZT(1)
	5
	6
	7
	8	N\bNA\bAM\bME\bE
	9	liszt - compile a Franz Lisp program
	10
	11	S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
	12	l\bli\bis\bsz\bzt\bt [ -\b-m\bmp\bpq\bqr\bru\buw\bwx\bxC\bCQ\bQS\bST\bT ] [ -\b-e\be form ] [ -\b-o\bo objfile ] [ name ]
	13
	14	D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
	15	_\bL_\bi_\bs_\bz_\bt takes a file whose names ends in `.l' and compiles the
	16	FRANZ LISP code there leaving an object program on the file
	17	whose name is that of the source with `.o' substituted for
	18	`.l'.
	19
	20	The following options are interpreted by _\bl_\bi_\bs_\bz_\bt.
	21
	22	-\b-e\be Evaluate the given form before compilation begins.
	23
	24	-\b-m\bm Compile a MACLISP file, by changing the readtable to
	25	conform to MACLISP syntax and including a macro-defined
	26	compatibility package.
	27
	28	-\b-o\bo Put the object code in the specified file, rather than
	29	the default `.o' file.
	30
	31	-\b-p\bp places profiling code at the beginning of each non-
	32	local function. If the lisp system is also created
	33	with profiling in it, this allows function calling fre-
	34	quency to be determined (see _\bp_\br_\bo_\bf(1).)
	35
	36	-\b-q\bq Only print warning and error messages. Compilation
	37	statistics and notes on correct but unusual constructs
	38	will not be printed.
	39
	40	-\b-r\br place bootstrap code at the beginning of the object
	41	file, which when the object file is executed will cause
	42	a lisp system to be invoked and the object file fasl'ed
	43	in.
	44
	45	-\b-u\bu Compile a UCI-lispfile, by changing the readtable to
	46	conform to UCI-Lisp syntax and including a macro-
	47	defined compatibility package.
	48
	49	-\b-w\bw Suppress warning diagnostics.
	50
	51	-\b-x\bx Create a lisp cross reference file with the same name
	52	as the source file but with `.x' appended. The pro-
	53	gram _\bl_\bx_\br_\be_\bf(1) reads this file and creates a human read-
	54	able cross reference listing.
	55
	56	-\b-C\bC put comments in the assembler output of the compiler.
	57	Useful for debugging the compiler.
	58
	59	-\b-Q\bQ Print compilation statistics and warn of strange
	60
	61
	62
	63	Printed 7/9/88 April 29, 1985 1
	64
65
66
67
68
69
70	LISZT(1) UNIX Programmer's Manual LISZT(1)
71
72
73
74	constructs. This is the default.
75
76	-\b-S\bS Compile the named program and leave the assembler-
77	language output on the corresponding file suffixed
78	`.s'. This will also prevent the assembler language
79	file from being assembled.
80
81	-\b-T\bT send the assembler output to standard output.
82
83	If no source file is specified, then the compiler will run
84	interactively. You will find yourself talking to the
85	_\bl_\bi_\bs_\bp(1) top-level command interpreter. You can compile a
86	file by using the function _\bl_\bi_\bs_\bz_\bt (an nlambda) with the same
87	arguments as you use on the command line. For example to
88	compile `foo', a MACLISP file, you would use:
89
90	(liszt -m foo)
91
92	Note that _\bl_\bi_\bs_\bz_\bt supplies the ``.l'' extension for you.
93
94	F\bFI\bIL\bLE\bES\bS
95	/usr/lib/lisp/machacks.lMACLISP 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
99	A\bAU\bUT\bTH\bHO\bOR\bR
100	John Foderaro
101
102	S\bSE\bEE\bE A\bAL\bLS\bSO\bO
103	lisp(1), lxref(1)
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129	Printed 7/9/88 April 29, 1985 2
130
131
132