|
|
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: .\" @(#)ch0.n 6.2 (Berkeley) 5/10/86
6: .\"
7: .\" $Header: ch0.n,v 1.3 83/07/27 15:10:52 layer Exp $
8: .pp
9: \ \
10: .sp 2i
11: .tl ''\s14The\ \s16F\s14RANZ\ \s16L\s14ISP\ \s14Manual''
12: .ps 10
13: .sp 1v
14: .tl ''by''
15: .sp 2v
16: .tl ''\fIJohn\ K.\ Foderaro\fP''
17: .sp 2v
18: .tl ''\fIKeith\ L.\ Sklower\fP''
19: .sp 2v
20: .tl ''\fIKevin\ Layer\fP''
21: .sp 2i
22: .tl ''June 1983''
23: .sp 2i
24: .tl '''A document in'
25: .tl '''four movements'
26: .He
27: .bp
28: .sp 1i
29: .ft I
30: .ll 5.5i
31: .in .5i
32: .tl ''Overture''
33: .sp 2v
34: A chorus of students
35: under the direction of
36: Richard Fateman have contributed to
37: building
38: .Fr
39: from a mere melody into a full
40: symphony .
41: The major contributors to the initial system were
42: Mike Curry, John Breedlove and Jeff Levinsky.
43: Bill Rowan added the garbage collector and array package.
44: Tom London worked on an early compiler and helped in
45: overall system design.
46: Keith Sklower has contributed much to
47: .Fr ,
48: adding the
49: bignum package and rewriting most of the code to increase
50: its efficiency and clarity.
51: Kipp Hickman and Charles Koester added hunks.
52: Mitch Marcus added *rset, evalhook and evalframe.
53: Don Cohen and others at Carnegie-Mellon
54: made some improvements to evalframe and
55: provided various features modelled after UCI/CMU PDP-10 Lisp and
56: Interlisp environments (editor, debugger, top-level).
57: John Foderaro wrote the compiler, added a few functions,
58: and wrote much of this manual. Of course, other authors have
59: contributed specific chapters as indicated.
60: Kevin Layer modified the compiler to produce code for the
61: Motorola 68000, and helped make
62: .Fr
63: pass ``Lint''.
64: .br
65: This manual may be supplemented or supplanted by local
66: chapters representing alterations, additions and deletions.
67: We at U.C. Berkeley are pleased to learn of generally
68: useful system features, bug fixes, or useful program packages,
69: and we will attempt to redistribute such contributions.
70: .sp 1.75i
71: .ft R
72: .ll 6.0i
73: .in 0
74: \(co 1980, 1981, 1983 by the Regents of the University of California.
75: (exceptions: Chapters 13, 14 (first half), 15 and 16 have separate copyrights,
76: as indicated. These are reproduced by permission of the copyright
77: holders.)
78: .br
79: Permission to copy without fee all or part of this material is granted
80: provided that the copies are not made or
81: distributed for direct commercial advantage, and the copyright
82: notice of the Regents, University of California, is given.
83: All rights reserved.
84: .br
85: .sp 2v
86: Work reported herein was supported in part by
87: the U. S. Department
88: of Energy, Contract DE-AT03-76SF00034, Project Agreement
89: DE-AS03-79ER10358, and the National Science
90: Foundation under Grant No. MCS 7807291
91: .sp 2v
92: UNIX is a trademark of Bell Laboratories. VAX and PDP are trademarks
93: of Digital Equiptment Coporation. MC68000 is a trademark of
94: Motorola Semiconductor Products, Inc.
95: .bp
96: .ps 16
97: .sp 1i
98: .tl ''Score''
99: .sp .5i
100: .ps 12
101: .in 1i.
102: .ti 2i
103: \fBFirst Movement \fI(allegro non troppo)\fR
104: .ps 10
105: .sp 1v
106: .de CH
107: .ti -.5i
108: \fR\\$1 \\$2\fP
109: .br
110: ..
111: .ft I
112: .CH 1. F\s-2RANZ\s0\ L\s-2ISP\s0
113: Introduction to
114: .Fr ,
115: details of data types,
116: and description of notation
117: .CH 2. Data\ Structure\ Access
118: Functions for the creation, destruction
119: and manipulation of lisp data objects.
120: .CH 3. Arithmetic\ Functions
121: Functions to perform arithmetic operations.
122: .CH 4. Special\ Functions
123: Functions for altering flow of control.
124: Functions for mapping other functions over lists.
125: .CH 5. I/O\ Functions
126: Functions for reading and writing from ports.
127: Functions for the modification of the reader's syntax.
128: .CH 6. System\ Functions
129: Functions for storage management, debugging, and for the reading
130: and setting of global Lisp status variables.
131: Functions for doing UNIX-specific tasks such as process control.
132: .ft R
133: .sp 2v
134: .ps 12
135: .ti 2i
136: \fBSecond Movement \fI(Largo)\fR
137: .ps 10
138: .sp 1v
139: .ft I
140: .CH 7. The\ Reader
141: A description of the syntax codes used by the reader.
142: An explanation of character macros.
143: .CH 8. Functions,\ Fclosures,\ and\ Macros
144: A description of various types of functional objects.
145: An example of the use of foreign functions.
146: .CH 9. Arrays\ and\ Vectors
147: A detailed description of the parts of an array and of
148: Maclisp compatible arrays.
149: .CH 10. Exception\ Handling
150: A description of the error handling sequence and of autoloading.
151: .ft R
152: .bp
153: .ps 12
154: .ti 2i
155: \fBThird Movement \fI(Scherzo)\fR
156: .ps 10
157: .sp 1v
158: .ft I
159: .CH 11. The\ Joseph\ Lister\ Trace\ Package
160: A description of a very useful debugging aid.
161: .CH 12. Liszt,\ the\ lisp\ compiler
162: A description of the operation of the
163: compiler and hints for making functions compilable.
164: .CH 13. CMU\ Top\ Level\ and\ File\ Package
165: A description of a top level with a history mechanism and a
166: package which helps you keep track of files of lisp functions.
167: .CH 14 Stepper
168: A description of a program which permits you to put breakpoints
169: in lisp code and to single step it. A description of the
170: evalhook and funcallhook mechanism.
171: .CH 15 Fixit
172: A program which permits you to examine and modify evaluation stack
173: in order to fix bugs on the fly.
174: .CH 16 Lisp\ Editor
175: A structure editor for interactive modification of lisp code.
176: .ft R
177: .sp 2v
178: .ps 12
179: .ti 2i
180: \fBFinal Movement \fI(allegro)\fR
181: .ps 10
182: .sp 1v
183: .ft I
184: .CH Appendix\ A -\ Function\ Index
185: .CH Appendix\ B -\ List\ of\ Special\ Symbols
186: .CH Appendix\ C -\ Short\ Subjects
187: Garbage collector, Debugging, Default Top Level
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.