6 Fairly good, but should probably be integrated with description of primitives
10 Needs updating cleanup scan. Not too bad.
13 Need VMR overview. New names for GTN/LTN? Needs general cleanup, but not too
14 bad. NLX and stack are the worst.
17 Pack and assembler need more info. General cleanup.
21 Adapt introductory material from /../fred/usr/ram/comp.mss, pap:talk.mss
22 Division between ICR overview and ICR convert needs work.
25 Needs much work. Merge much info from debug-info and debug-int. Duplicating a
26 fair amount of stuff in the source may make sense where, since this is a part
27 of the system that is generally interesting. And also, a part that people
28 building on CMU CL might want to understand.
31 Finish, integrate w/ main text?
34 Very sketchy and tentative. Needs to be fleshed out from the code.
37 Very rough. Needs to be merged with parts of vm.tex (call vops). Needs some
38 additional text. Documentation of assembler, and all other exported
39 interfaces. (Generate defined VOP descriptions from the core, keyed to files?)
42 This file should probably cease to exist, going into object, retargeting and
43 introductory material. [Also other scrap in stuff/]
46 [VMR and ICR overview also needed...]
49 Missing sections on startup code, compiling, building.
52 Needs to be written: type system and info database interfaces.
55 Needs to be written: source paths and error message utilities.
58 Needs to be written. All manner of low-level stuff: memory layout and
59 management, core file format, C interface, low-level debugging (and ldb.)
62 Several different audiences:
63 -- Curious compiler implementors (not a big priority. Downplay academic
64 aspects, i.e. comparisons to other techniques, analysis of limitations,
65 future work...) Compiler part can be more academic, and include some
66 justifications of other design decisions.
67 -- System maintainers.
68 -- People retargeting the compiler.
69 -- People bringing up the system in a new environment.
72 Package + file structure [system.txt]
73 system building [compiling.txt]
74 bootstrapping & cross compiling
77 Overview (mirror structure of rest of the part)
80 Basic VMR data structures (no back-end stuff)
81 Middle end [middle.tex]
82 Back end + data structures [back.tex]
84 Error system interface
88 VM definition concepts [porting.txt, mail.txt, retargeting.tex]
89 SCs, SBs, primitive-types
93 and using the assembler
94 Required VOPs [internal.txt, lowlev.txt, vm.mss]
95 Standard primitives [vm.mss] (broken down by type, parallels object format
97 Customizing VMR conversion
100 VM specific transforms
101 special-case IR2 convert methods
106 Data format [object.tex]
108 Info format [debug.txt]
109 Stack parsing [debug.txt]
113 Memory management: [William]
117 misc implementation stuff: foreign call, assembly routines [lowlev.txt]
118 LDB and low-level debugging
119 core file format [William]
120 fasl format [fasl.tex]