/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / pcl / docs.lha / internals / architecture.tex

< prev

next >

MacOS 8.1

Win98

DOS

browse contents

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 5c 70 61 72 74 7b 53 79 | 73 74 65 6d 20 41 72 63 |\part{Sy|stem Arc|
|00000010| 68 69 74 65 63 74 75 72 | 65 7d 25 20 2d 2a 2d 20 |hitectur|e}% -*- |
|00000020| 44 69 63 74 69 6f 6e 61 | 72 79 3a 20 69 6e 74 3a |Dictiona|ry: int:|
|00000030| 64 65 73 69 67 6e 20 2d | 2a 2d 0a 0a 5c 63 68 61 |design -|*-..\cha|
|00000040| 70 74 65 72 7b 50 61 63 | 6b 61 67 65 20 61 6e 64 |pter{Pac|kage and|
|00000050| 20 46 69 6c 65 20 53 74 | 72 75 63 74 75 72 65 7d | File St|ructure}|
|00000060| 0a 0a 5c 73 65 63 74 69 | 6f 6e 7b 52 43 53 20 61 |..\secti|on{RCS a|
|00000070| 6e 64 20 62 75 69 6c 64 | 20 61 72 65 61 73 7d 0a |nd build| areas}.|
|00000080| 0a 54 68 65 20 43 4d 55 | 20 43 4c 20 73 6f 75 72 |.The CMU| CL sour|
|00000090| 63 65 73 20 61 72 65 20 | 6d 61 69 6e 74 61 69 6e |ces are |maintain|
|000000a0| 65 64 20 75 73 69 6e 67 | 20 52 43 53 20 69 6e 20 |ed using| RCS in |
|000000b0| 61 20 68 69 65 72 61 72 | 63 68 69 63 61 6c 20 64 |a hierar|chical d|
|000000c0| 69 72 65 63 74 6f 72 79 | 0a 73 74 72 75 63 74 75 |irectory|.structu|
|000000d0| 72 65 20 77 68 69 63 68 | 20 73 75 70 70 6f 72 74 |re which| support|
|000000e0| 73 3a 0a 5c 62 65 67 69 | 6e 7b 69 74 65 6d 69 7a |s:.\begi|n{itemiz|
|000000f0| 65 7d 0a 5c 69 74 65 6d | 20 20 20 20 73 68 61 72 |e}.\item|    shar|
|00000100| 65 64 20 52 43 53 20 63 | 6f 6e 66 69 67 20 66 69 |ed RCS c|onfig fi|
|00000110| 6c 65 20 61 63 72 6f 73 | 73 20 61 20 62 75 69 6c |le acros|s a buil|
|00000120| 64 20 61 72 65 61 2c 20 | 0a 0a 5c 69 74 65 6d 20 |d area, |..\item |
|00000130| 20 20 20 66 72 6f 7a 65 | 6e 20 73 6f 75 72 63 65 |   froze|n source|
|00000140| 73 20 66 6f 72 20 6d 75 | 6c 74 69 70 6c 65 20 72 |s for mu|ltiple r|
|00000150| 65 6c 65 61 73 65 73 2c | 20 61 6e 64 20 0a 0a 5c |eleases,| and ..\|
|00000160| 69 74 65 6d 20 20 20 20 | 73 65 70 61 72 61 74 65 |item    |separate|
|00000170| 20 73 79 73 74 65 6d 20 | 62 75 69 6c 64 20 61 72 | system |build ar|
|00000180| 65 61 73 20 66 6f 72 20 | 64 69 66 66 65 72 65 6e |eas for |differen|
|00000190| 74 20 61 72 63 68 69 74 | 65 63 74 75 72 65 73 2e |t archit|ectures.|
|000001a0| 0a 5c 65 6e 64 7b 69 74 | 65 6d 69 7a 65 7d 0a 0a |.\end{it|emize}..|
|000001b0| 53 69 6e 63 65 20 74 68 | 69 73 20 6f 72 67 61 6e |Since th|is organ|
|000001c0| 69 7a 61 74 69 6f 6e 20 | 6d 61 69 6e 74 61 69 6e |ization |maintain|
|000001d0| 73 20 6d 75 6c 74 69 70 | 6c 65 20 63 6f 70 69 65 |s multip|le copie|
|000001e0| 73 20 6f 66 20 74 68 65 | 20 73 6f 75 72 63 65 2c |s of the| source,|
|000001f0| 20 69 74 20 69 73 20 73 | 6f 6d 65 77 68 61 74 0a | it is s|omewhat.|
|00000200| 73 70 61 63 65 20 69 6e | 74 65 6e 73 69 76 65 2e |space in|tensive.|
|00000210| 20 20 42 75 74 20 69 74 | 20 69 73 20 65 61 73 79 |  But it| is easy|
|00000220| 20 74 6f 20 64 65 6c 65 | 74 65 20 61 6e 64 20 6c | to dele|te and l|
|00000230| 61 74 65 72 20 72 65 73 | 74 6f 72 65 20 61 20 63 |ater res|tore a c|
|00000240| 6f 70 79 20 6f 66 20 74 | 68 65 0a 73 6f 75 72 63 |opy of t|he.sourc|
|00000250| 65 20 75 73 69 6e 67 20 | 52 43 53 20 73 6e 61 70 |e using |RCS snap|
|00000260| 73 68 6f 74 73 2e 0a 0a | 54 68 65 72 65 20 61 72 |shots...|There ar|
|00000270| 65 20 74 68 72 65 65 20 | 6d 61 6a 6f 72 20 73 75 |e three |major su|
|00000280| 62 74 72 65 65 73 20 6f | 66 20 74 68 65 20 72 6f |btrees o|f the ro|
|00000290| 6f 74 20 5c 76 65 72 62 | 7c 2f 61 66 73 2f 63 73 |ot \verb||/afs/cs|
|000002a0| 2f 70 72 6f 6a 65 63 74 | 2f 63 6c 69 73 70 7c 3a |/project|/clisp|:|
|000002b0| 0a 5c 62 65 67 69 6e 7b | 64 65 73 63 72 69 70 74 |.\begin{|descript|
|000002c0| 69 6f 6e 7d 0a 5c 69 74 | 65 6d 5b 72 63 73 5d 20 |ion}.\it|em[rcs] |
|000002d0| 68 6f 6c 64 73 20 74 68 | 65 20 52 43 53 20 73 6f |holds th|e RCS so|
|000002e0| 75 72 63 65 20 28 73 75 | 66 66 69 78 20 5c 76 65 |urce (su|ffix \ve|
|000002f0| 72 62 7c 2c 76 7c 29 20 | 66 69 6c 65 73 2e 0a 0a |rb|,v|) |files...|
|00000300| 5c 69 74 65 6d 5b 73 72 | 63 5d 20 68 6f 6c 64 73 |\item[sr|c] holds|
|00000310| 20 60 60 63 68 65 63 6b | 65 64 20 6f 75 74 27 27 | ``check|ed out''|
|00000320| 20 28 62 75 74 20 6e 6f | 74 20 6c 6f 63 6b 65 64 | (but no|t locked|
|00000330| 29 20 76 65 72 73 69 6f | 6e 73 20 6f 66 20 74 68 |) versio|ns of th|
|00000340| 65 20 73 6f 75 72 63 65 | 20 66 69 6c 65 73 2c 0a |e source| files,.|
|00000350| 61 6e 64 20 69 73 20 73 | 75 62 64 69 76 69 64 65 |and is s|ubdivide|
|00000360| 64 20 62 79 20 72 65 6c | 65 61 73 65 2e 20 20 45 |d by rel|ease.  E|
|00000370| 61 63 68 20 72 65 6c 65 | 61 73 65 20 64 69 72 65 |ach rele|ase dire|
|00000380| 63 74 6f 72 79 20 69 6e | 20 74 68 65 20 73 6f 75 |ctory in| the sou|
|00000390| 72 63 65 20 74 72 65 65 | 20 68 61 73 20 61 0a 73 |rce tree| has a.s|
|000003a0| 79 6d 62 6f 6c 69 63 20 | 6c 69 6e 6b 20 6e 61 6d |ymbolic |link nam|
|000003b0| 65 64 20 60 60 7b 5c 74 | 74 20 52 43 53 7d 27 27 |ed ``{\t|t RCS}''|
|000003c0| 20 77 68 69 63 68 20 70 | 6f 69 6e 74 73 20 74 6f | which p|oints to|
|000003d0| 20 74 68 65 20 52 43 53 | 20 73 75 62 64 69 72 65 | the RCS| subdire|
|000003e0| 63 74 6f 72 79 20 6f 66 | 20 74 68 65 0a 63 6f 72 |ctory of| the.cor|
|000003f0| 72 65 73 70 6f 6e 64 69 | 6e 67 20 64 69 72 65 63 |respondi|ng direc|
|00000400| 74 6f 72 79 20 69 6e 20 | 74 68 65 20 60 60 7b 5c |tory in |the ``{\|
|00000410| 74 74 20 72 63 73 7d 20 | 74 72 65 65 2e 20 20 41 |tt rcs} |tree.  A|
|00000420| 74 20 74 6f 70 2d 6c 65 | 76 65 6c 20 69 6e 20 61 |t top-le|vel in a|
|00000430| 20 73 6f 75 72 63 65 20 | 74 72 65 65 0a 69 73 20 | source |tree.is |
|00000440| 74 68 65 20 60 60 7b 5c | 74 74 20 52 43 53 63 6f |the ``{\|tt RCSco|
|00000450| 6e 66 69 67 7d 27 27 20 | 66 69 6c 65 20 66 6f 72 |nfig}'' |file for|
|00000460| 20 74 68 61 74 20 61 72 | 65 61 2e 20 20 41 6c 6c | that ar|ea.  All|
|00000470| 20 73 75 62 64 69 72 65 | 63 74 6f 72 69 65 73 20 | subdire|ctories |
|00000480| 61 6c 73 6f 20 68 61 76 | 65 20 61 0a 73 79 6d 62 |also hav|e a.symb|
|00000490| 6f 6c 69 63 20 6c 69 6e | 6b 20 74 6f 20 74 68 69 |olic lin|k to thi|
|000004a0| 73 20 52 43 53 63 6f 6e | 66 69 67 20 66 69 6c 65 |s RCScon|fig file|
|000004b0| 2c 20 61 6c 6c 6f 77 69 | 6e 67 20 74 68 65 20 63 |, allowi|ng the c|
|000004c0| 6f 6e 66 69 67 75 72 61 | 74 69 6f 6e 20 66 6f 72 |onfigura|tion for|
|000004d0| 20 61 6e 20 61 72 65 61 | 20 74 6f 0a 62 65 20 65 | an area| to.be e|
|000004e0| 61 73 69 6c 79 20 63 68 | 61 6e 67 65 64 2e 0a 0a |asily ch|anged...|
|000004f0| 5c 69 74 65 6d 5b 62 75 | 69 6c 64 5d 20 63 6f 6d |\item[bu|ild] com|
|00000500| 70 69 6c 65 64 20 6f 62 | 6a 65 63 74 20 66 69 6c |piled ob|ject fil|
|00000510| 65 73 20 61 72 65 20 70 | 6c 61 63 65 64 20 69 6e |es are p|laced in|
|00000520| 20 74 68 69 73 20 74 72 | 65 65 2c 20 77 68 69 63 | this tr|ee, whic|
|00000530| 68 20 69 73 20 73 75 62 | 64 69 76 69 64 65 64 0a |h is sub|divided.|
|00000540| 62 79 20 6d 61 63 68 69 | 6e 65 20 74 79 70 65 20 |by machi|ne type |
|00000550| 61 6e 64 20 76 65 72 73 | 69 6f 6e 2e 20 20 54 68 |and vers|ion.  Th|
|00000560| 65 20 43 4d 55 20 43 4c | 20 73 65 61 72 63 68 2d |e CMU CL| search-|
|00000570| 6c 69 73 74 20 6d 65 63 | 68 61 6e 69 73 6d 20 69 |list mec|hanism i|
|00000580| 73 20 75 73 65 64 20 74 | 6f 20 61 6c 6c 6f 77 0a |s used t|o allow.|
|00000590| 74 68 65 20 73 6f 75 72 | 63 65 20 66 69 6c 65 73 |the sour|ce files|
|000005a0| 20 74 6f 20 62 65 20 6c | 6f 63 61 74 65 64 20 69 | to be l|ocated i|
|000005b0| 6e 20 61 20 64 69 66 66 | 65 72 65 6e 74 20 74 72 |n a diff|erent tr|
|000005c0| 65 65 20 74 68 61 6e 20 | 74 68 65 20 6f 62 6a 65 |ee than |the obje|
|000005d0| 63 74 20 66 69 6c 65 73 | 2e 20 20 43 0a 70 72 6f |ct files|.  C.pro|
|000005e0| 67 72 61 6d 73 20 61 72 | 65 20 63 6f 6d 70 69 6c |grams ar|e compil|
|000005f0| 65 64 20 62 79 20 75 73 | 69 6e 67 20 74 68 65 20 |ed by us|ing the |
|00000600| 5c 76 65 72 62 7c 74 6f | 6f 6c 73 2f 64 75 70 73 |\verb|to|ols/dups|
|00000610| 72 63 73 7c 20 63 6f 6d | 6d 61 6e 64 20 74 6f 20 |rcs| com|mand to |
|00000620| 6d 61 6b 65 0a 73 79 6d | 62 6f 6c 69 63 20 6c 69 |make.sym|bolic li|
|00000630| 6e 6b 73 20 74 6f 20 74 | 68 65 20 63 6f 72 72 65 |nks to t|he corre|
|00000640| 73 70 6f 6e 64 69 6e 67 | 20 73 6f 75 72 63 65 20 |sponding| source |
|00000650| 74 72 65 65 2e 0a 5c 65 | 6e 64 7b 64 65 73 63 72 |tree..\e|nd{descr|
|00000660| 69 70 74 69 6f 6e 7d 0a | 0a 4f 6e 20 6f 72 64 65 |iption}.|.On orde|
|00000670| 72 20 74 6f 20 6d 6f 64 | 69 66 79 20 61 6e 20 66 |r to mod|ify an f|
|00000680| 69 6c 65 20 69 6e 20 52 | 43 53 2c 20 69 74 20 6d |ile in R|CS, it m|
|00000690| 75 73 74 20 62 65 20 63 | 68 65 63 6b 65 64 20 6f |ust be c|hecked o|
|000006a0| 75 74 20 77 69 74 68 20 | 61 20 6c 6f 63 6b 20 74 |ut with |a lock t|
|000006b0| 6f 0a 70 72 6f 64 75 63 | 65 20 61 20 77 72 69 74 |o.produc|e a writ|
|000006c0| 61 62 6c 65 20 77 6f 72 | 6b 69 6e 67 20 66 69 6c |able wor|king fil|
|000006d0| 65 2e 20 20 45 61 63 68 | 20 70 72 6f 67 72 61 6d |e.  Each| program|
|000006e0| 6d 65 72 20 63 68 65 63 | 6b 73 20 6f 75 74 20 66 |mer chec|ks out f|
|000006f0| 69 6c 65 73 20 69 6e 74 | 6f 20 61 0a 70 65 72 73 |iles int|o a.pers|
|00000700| 6f 6e 61 6c 20 60 60 70 | 6c 61 79 20 61 72 65 61 |onal ``p|lay area|
|00000710| 27 27 20 73 75 62 74 72 | 65 65 20 6f 66 20 5c 76 |'' subtr|ee of \v|
|00000720| 65 72 62 7c 63 6c 69 73 | 70 2f 68 61 63 6b 65 72 |erb|clis|p/hacker|
|00000730| 73 7c 2e 20 20 54 68 65 | 73 65 20 74 72 65 65 20 |s|.  The|se tree |
|00000740| 64 75 70 6c 69 63 61 74 | 65 0a 74 68 65 20 73 74 |duplicat|e.the st|
|00000750| 72 75 63 74 75 72 65 20 | 6f 66 20 73 6f 75 72 63 |ructure |of sourc|
|00000760| 65 20 74 72 65 65 73 2c | 20 62 75 74 20 61 72 65 |e trees,| but are|
|00000770| 20 6e 6f 72 6d 61 6c 6c | 79 20 65 6d 70 74 79 20 | normall|y empty |
|00000780| 65 78 63 65 70 74 20 66 | 6f 72 20 66 69 6c 65 73 |except f|or files|
|00000790| 20 61 63 74 69 76 65 6c | 79 0a 62 65 69 6e 67 20 | activel|y.being |
|000007a0| 77 6f 72 6b 65 64 20 6f | 6e 2e 0a 0a 53 65 65 20 |worked o|n...See |
|000007b0| 5c 76 65 72 62 7c 2f 61 | 66 73 2f 63 73 2f 70 72 |\verb|/a|fs/cs/pr|
|000007c0| 6f 6a 65 63 74 2f 63 6c | 69 73 70 2f 70 6d 61 78 |oject/cl|isp/pmax|
|000007d0| 5f 6d 61 63 68 2f 61 6c | 70 68 61 2f 74 6f 6f 6c |_mach/al|pha/tool|
|000007e0| 73 2f 7c 20 66 6f 72 0a | 76 61 72 69 6f 75 73 20 |s/| for.|various |
|000007f0| 74 6f 6f 6c 73 20 77 65 | 20 75 73 65 20 66 6f 72 |tools we| use for|
|00000800| 20 52 43 53 20 68 61 63 | 6b 69 6e 67 3a 0a 5c 62 | RCS hac|king:.\b|
|00000810| 65 67 69 6e 7b 64 65 73 | 63 72 69 70 74 69 6f 6e |egin{des|cription|
|00000820| 7d 0a 5c 69 74 65 6d 5b | 72 63 73 2e 6c 69 73 70 |}.\item[|rcs.lisp|
|00000830| 5d 20 48 65 6d 6c 6f 63 | 6b 20 28 65 64 69 74 6f |] Hemloc|k (edito|
|00000840| 72 29 20 63 6f 6d 6d 61 | 6e 64 73 20 66 6f 72 20 |r) comma|nds for |
|00000850| 52 43 53 20 66 69 6c 65 | 20 6d 61 6e 69 70 75 6c |RCS file| manipul|
|00000860| 61 74 69 6f 6e 0a 0a 5c | 69 74 65 6d 5b 72 63 73 |ation..\|item[rcs|
|00000870| 75 70 64 61 74 65 2e 63 | 5d 20 50 72 6f 67 72 61 |update.c|] Progra|
|00000880| 6d 20 74 6f 20 63 68 65 | 63 6b 20 6f 75 74 20 61 |m to che|ck out a|
|00000890| 6c 6c 20 66 69 6c 65 73 | 20 69 6e 20 61 20 74 72 |ll files| in a tr|
|000008a0| 65 65 20 74 68 61 74 20 | 68 61 76 65 20 62 65 65 |ee that |have bee|
|000008b0| 6e 0a 6d 6f 64 69 66 69 | 65 64 20 73 69 6e 63 65 |n.modifi|ed since|
|000008c0| 20 6c 61 73 74 20 63 68 | 65 63 6b 6f 75 74 2e 0a | last ch|eckout..|
|000008d0| 0a 5c 69 74 65 6d 5b 75 | 70 64 61 74 65 73 5d 20 |.\item[u|pdates] |
|000008e0| 53 68 65 6c 6c 20 73 63 | 72 69 70 74 20 74 6f 20 |Shell sc|ript to |
|000008f0| 70 72 6f 64 75 63 65 20 | 61 20 73 69 6e 67 6c 65 |produce |a single|
|00000900| 20 6c 69 73 74 69 6e 67 | 20 6f 66 20 61 6c 6c 20 | listing| of all |
|00000910| 52 43 53 20 6c 6f 67 0a | 20 65 6e 74 72 69 65 73 |RCS log.| entries|
|00000920| 20 69 6e 20 61 20 74 72 | 65 65 20 73 69 6e 63 65 | in a tr|ee since|
|00000930| 20 61 20 64 61 74 65 2e | 0a 0a 5c 69 74 65 6d 5b | a date.|..\item[|
|00000940| 73 6e 61 70 73 68 6f 74 | 2d 75 70 64 61 74 65 2e |snapshot|-update.|
|00000950| 6c 69 73 70 5d 20 4c 69 | 73 70 20 70 72 6f 67 72 |lisp] Li|sp progr|
|00000960| 61 6d 20 74 6f 20 67 65 | 6e 65 72 61 74 65 20 61 |am to ge|nerate a|
|00000970| 20 73 68 65 6c 6c 20 73 | 63 72 69 70 74 20 77 68 | shell s|cript wh|
|00000980| 69 63 68 0a 67 65 6e 65 | 72 61 74 65 73 20 61 20 |ich.gene|rates a |
|00000990| 6c 69 73 74 69 6e 67 20 | 6f 66 20 75 70 64 61 74 |listing |of updat|
|000009a0| 65 73 20 73 69 6e 63 65 | 20 61 20 70 61 72 74 69 |es since| a parti|
|000009b0| 63 75 6c 61 72 20 52 43 | 53 20 73 6e 61 70 73 68 |cular RC|S snapsh|
|000009c0| 6f 74 20 28 7b 5c 74 74 | 20 52 43 53 53 4e 41 50 |ot ({\tt| RCSSNAP|
|000009d0| 7d 29 0a 66 69 6c 65 20 | 77 61 73 20 63 72 65 61 |}).file |was crea|
|000009e0| 74 65 64 2e 0a 5c 65 6e | 64 7b 64 65 73 63 72 69 |ted..\en|d{descri|
|000009f0| 70 74 69 6f 6e 7d 0a 0a | 59 6f 75 20 63 61 6e 20 |ption}..|You can |
|00000a00| 65 61 73 69 6c 79 20 6f | 70 65 72 61 74 65 20 6f |easily o|perate o|
|00000a10| 6e 20 61 6c 6c 20 52 43 | 53 20 66 69 6c 65 73 20 |n all RC|S files |
|00000a20| 69 6e 20 61 20 73 75 62 | 74 72 65 65 20 75 73 69 |in a sub|tree usi|
|00000a30| 6e 67 3a 0a 5c 62 65 67 | 69 6e 7b 76 65 72 62 61 |ng:.\beg|in{verba|
|00000a40| 74 69 6d 7d 0a 66 69 6e | 64 20 2e 20 2d 66 6f 6c |tim}.fin|d . -fol|
|00000a50| 6c 6f 77 20 2d 6e 61 6d | 65 20 27 2a 2c 76 27 20 |low -nam|e '*,v' |
|00000a60| 2d 65 78 65 63 20 3c 73 | 6f 6d 65 20 63 6f 6d 6d |-exec <s|ome comm|
|00000a70| 61 6e 64 3e 20 7b 7d 20 | 5c 3b 0a 5c 65 6e 64 7b |and> {} |\;.\end{|
|00000a80| 76 65 72 62 61 74 69 6d | 7d 0a 0a 5c 73 75 62 73 |verbatim|}..\subs|
|00000a90| 65 63 74 69 6f 6e 7b 43 | 6f 6e 66 69 67 75 72 61 |ection{C|onfigura|
|00000aa0| 74 69 6f 6e 20 4d 61 6e | 61 67 65 6d 65 6e 74 7d |tion Man|agement}|
|00000ab0| 0a 0a 63 6f 6e 66 69 67 | 20 66 69 6c 65 73 20 61 |..config| files a|
|00000ac0| 72 65 20 75 73 65 66 75 | 6c 2c 20 65 73 70 65 63 |re usefu|l, espec|
|00000ad0| 69 61 6c 6c 79 20 69 6e | 20 63 6f 6d 62 69 6e 61 |ially in| combina|
|00000ae0| 72 69 6f 6e 20 77 69 74 | 68 20 60 60 7b 5c 74 74 |rion wit|h ``{\tt|
|00000af0| 20 73 6e 61 70 73 68 6f | 74 7d 27 27 2e 20 20 59 | snapsho|t}''.  Y|
|00000b00| 6f 75 0a 63 61 6e 20 73 | 68 61 70 73 68 6f 74 20 |ou.can s|hapshot |
|00000b10| 61 6e 79 20 70 61 72 74 | 69 63 75 6c 61 72 20 76 |any part|icular v|
|00000b20| 65 72 73 69 6f 6e 2c 20 | 67 69 76 69 6e 67 20 61 |ersion, |giving a|
|00000b30| 6e 20 52 43 53 63 6f 6e | 66 69 67 20 74 68 61 74 |n RCScon|fig that|
|00000b40| 20 64 65 73 69 67 6e 61 | 74 65 73 20 74 68 61 74 | designa|tes that|
|00000b50| 0a 63 6f 6e 66 69 67 75 | 72 61 74 69 6f 6e 2e 20 |.configu|ration. |
|00000b60| 20 59 6f 75 20 63 61 6e | 20 61 6c 73 6f 20 75 73 | You can| also us|
|00000b70| 65 20 63 6f 6e 66 69 67 | 20 66 69 6c 65 73 20 74 |e config| files t|
|00000b80| 6f 20 73 70 65 63 69 66 | 79 20 74 68 65 20 73 79 |o specif|y the sy|
|00000b90| 73 74 65 6d 20 61 73 20 | 6f 66 20 61 0a 70 61 72 |stem as |of a.par|
|00000ba0| 74 69 63 75 6c 61 72 20 | 64 61 74 65 2e 20 20 46 |ticular |date.  F|
|00000bb0| 6f 72 20 65 78 61 6d 70 | 6c 65 3a 0a 5c 62 65 67 |or examp|le:.\beg|
|00000bc0| 69 6e 7b 76 65 72 62 61 | 74 69 6d 7d 0a 3c 33 2d |in{verba|tim}.<3-|
|00000bd0| 6a 61 6e 2d 39 31 0a 5c | 65 6e 64 7b 76 65 72 62 |jan-91.\|end{verb|
|00000be0| 61 74 69 6d 7d 0a 69 6e | 20 74 68 65 20 74 68 65 |atim}.in| the the|
|00000bf0| 20 63 6f 6e 66 69 67 20 | 66 69 6c 65 20 77 69 6c | config |file wil|
|00000c00| 6c 20 63 61 75 73 65 20 | 74 68 65 20 76 65 72 73 |l cause |the vers|
|00000c10| 69 6f 6e 20 61 73 20 6f | 66 20 74 68 61 74 20 33 |ion as o|f that 3|
|00000c20| 2d 6a 61 6e 2d 39 31 20 | 74 6f 20 62 65 20 63 68 |-jan-91 |to be ch|
|00000c30| 65 63 6b 65 64 0a 6f 75 | 74 2c 20 69 6e 73 74 65 |ecked.ou|t, inste|
|00000c40| 61 64 20 6f 66 20 74 68 | 65 20 6c 61 74 65 73 74 |ad of th|e latest|
|00000c50| 20 76 65 72 73 69 6f 6e | 2e 0a 0a 5c 73 75 62 73 | version|...\subs|
|00000c60| 65 63 74 69 6f 6e 7b 52 | 43 53 20 42 72 61 6e 63 |ection{R|CS Branc|
|00000c70| 68 65 73 7d 0a 0a 42 72 | 61 6e 63 68 65 73 20 61 |hes}..Br|anches a|
|00000c80| 6e 64 20 6e 61 6d 65 64 | 20 72 65 76 69 73 69 6f |nd named| revisio|
|00000c90| 6e 73 20 61 72 65 20 75 | 73 65 64 20 74 6f 67 65 |ns are u|sed toge|
|00000ca0| 74 68 65 72 20 74 6f 20 | 61 6c 6c 6f 77 20 6d 75 |ther to |allow mu|
|00000cb0| 6c 74 69 70 6c 65 20 70 | 61 74 68 73 20 6f 66 0a |ltiple p|aths of.|
|00000cc0| 64 65 76 65 6c 6f 70 6d | 65 6e 74 20 74 6f 20 62 |developm|ent to b|
|00000cd0| 65 20 73 75 70 70 6f 72 | 74 65 64 2e 20 20 45 61 |e suppor|ted.  Ea|
|00000ce0| 63 68 20 73 65 70 61 72 | 61 74 65 20 64 65 76 65 |ch separ|ate deve|
|00000cf0| 6c 6f 70 6d 65 6e 74 20 | 68 61 73 20 61 20 62 72 |lopment |has a br|
|00000d00| 61 6e 63 68 2c 20 61 6e | 64 20 65 61 63 68 0a 62 |anch, an|d each.b|
|00000d10| 72 61 6e 63 68 20 68 61 | 73 20 61 20 6e 61 6d 65 |ranch ha|s a name|
|00000d20| 2e 20 20 54 68 69 73 20 | 70 72 6f 6a 65 63 74 20 |.  This |project |
|00000d30| 75 73 65 73 20 62 72 61 | 6e 63 68 65 73 20 69 6e |uses bra|nches in|
|00000d40| 20 74 77 6f 20 73 6f 6d | 65 77 68 61 74 20 64 69 | two som|ewhat di|
|00000d50| 66 66 65 72 65 6e 74 20 | 63 61 73 65 73 0a 6f 66 |fferent |cases.of|
|00000d60| 20 64 69 76 65 72 67 65 | 6e 74 20 64 65 76 65 6c | diverge|nt devel|
|00000d70| 6f 70 6d 65 6e 74 3a 0a | 5c 62 65 67 69 6e 7b 69 |opment:.|\begin{i|
|00000d80| 74 65 6d 69 7a 65 7d 0a | 5c 69 74 65 6d 20 46 6f |temize}.|\item Fo|
|00000d90| 72 20 73 79 73 74 65 6d | 73 20 74 68 61 74 20 77 |r system|s that w|
|00000da0| 65 20 68 61 76 65 20 69 | 6d 70 6f 72 74 65 64 20 |e have i|mported |
|00000db0| 66 72 6f 6d 20 74 68 65 | 20 6f 75 74 73 69 64 65 |from the| outside|
|00000dc0| 2c 20 77 65 20 67 65 6e | 65 72 61 6c 6c 79 20 61 |, we gen|erally a|
|00000dd0| 73 73 69 67 6e 20 61 0a | 60 60 7b 5c 74 74 20 63 |ssign a.|``{\tt c|
|00000de0| 6d 75 7d 27 27 20 62 72 | 61 6e 63 68 20 66 6f 72 |mu}'' br|anch for|
|00000df0| 20 6f 75 72 20 6c 6f 63 | 61 6c 20 6d 6f 64 69 66 | our loc|al modif|
|00000e00| 69 63 61 74 69 6f 6e 73 | 2e 20 20 57 68 65 6e 20 |ications|.  When |
|00000e10| 61 20 6e 65 77 20 72 65 | 6c 65 61 73 65 20 63 6f |a new re|lease co|
|00000e20| 6d 65 73 0a 61 6c 6f 6e | 67 2c 20 77 65 20 63 68 |mes.alon|g, we ch|
|00000e30| 65 63 6b 20 69 74 20 69 | 6e 20 6f 6e 20 74 68 65 |eck it i|n on the|
|00000e40| 20 74 72 75 6e 6b 2c 20 | 61 6e 64 20 74 68 65 6e | trunk, |and then|
|00000e50| 20 6d 65 72 67 65 20 6f | 75 72 20 62 72 61 6e 63 | merge o|ur branc|
|00000e60| 68 20 62 61 63 6b 20 69 | 6e 2e 0a 0a 5c 69 74 65 |h back i|n...\ite|
|00000e70| 6d 20 46 6f 72 20 74 68 | 65 20 65 61 72 6c 79 20 |m For th|e early |
|00000e80| 64 65 76 65 6c 6f 70 6d | 65 6e 74 20 61 6e 64 20 |developm|ent and |
|00000e90| 64 65 62 75 67 67 69 6e | 67 20 6f 66 20 6d 61 6a |debuggin|g of maj|
|00000ea0| 6f 72 20 73 79 73 74 65 | 6d 20 63 68 61 6e 67 65 |or syste|m change|
|00000eb0| 73 2c 20 77 68 65 72 65 | 0a 74 68 65 20 64 65 76 |s, where|.the dev|
|00000ec0| 65 6c 6f 70 6d 65 6e 74 | 20 61 6e 64 20 64 65 62 |elopment| and deb|
|00000ed0| 75 67 67 69 6e 67 20 69 | 73 20 65 78 70 65 63 74 |ugging i|s expect|
|00000ee0| 65 64 20 74 6f 20 74 61 | 6b 65 20 6c 6f 6e 67 20 |ed to ta|ke long |
|00000ef0| 65 6e 6f 75 67 68 20 74 | 68 61 74 20 77 65 20 77 |enough t|hat we w|
|00000f00| 6f 75 6c 64 6e 27 74 0a | 77 61 6e 74 20 74 68 65 |ouldn't.|want the|
|00000f10| 20 74 72 75 6e 6b 20 74 | 6f 20 62 65 20 69 6e 20 | trunk t|o be in |
|00000f20| 61 6e 20 69 6e 63 6f 6e | 73 69 73 74 65 6e 74 20 |an incon|sistent |
|00000f30| 73 74 61 74 65 20 66 6f | 72 20 74 68 61 74 20 6c |state fo|r that l|
|00000f40| 6f 6e 67 2e 0a 5c 65 6e | 64 7b 69 74 65 6d 69 7a |ong..\en|d{itemiz|
|00000f50| 65 7d 0a 0a 5c 73 65 63 | 74 69 6f 6e 7b 52 65 6c |e}..\sec|tion{Rel|
|00000f60| 65 61 73 65 73 7d 0a 0a | 57 65 20 6e 61 6d 65 20 |eases}..|We name |
|00000f70| 72 65 6c 65 61 73 65 73 | 20 61 63 63 6f 72 64 69 |releases| accordi|
|00000f80| 6e 67 20 74 6f 20 74 68 | 65 20 6e 6f 72 6d 61 6c |ng to th|e normal|
|00000f90| 20 61 6c 70 68 61 2c 20 | 62 65 74 61 2c 20 64 65 | alpha, |beta, de|
|00000fa0| 66 61 75 6c 74 20 63 6f | 6e 76 65 6e 74 69 6f 6e |fault co|nvention|
|00000fb0| 2e 0a 41 6c 70 68 61 20 | 72 65 6c 65 61 73 65 73 |..Alpha |releases|
|00000fc0| 20 61 72 65 20 66 72 65 | 71 75 65 6e 74 2c 20 69 | are fre|quent, i|
|00000fd0| 6e 74 65 6e 64 65 64 20 | 70 72 69 6d 61 72 69 6c |ntended |primaril|
|00000fe0| 79 20 66 6f 72 20 69 6e | 74 65 72 6e 61 6c 20 75 |y for in|ternal u|
|00000ff0| 73 65 2c 20 61 6e 64 20 | 61 72 65 20 74 68 75 73 |se, and |are thus|
|00001000| 0a 6e 6f 74 20 73 75 62 | 6a 65 63 74 20 74 6f 20 |.not sub|ject to |
|00001010| 61 73 20 68 69 67 68 20 | 68 69 67 68 20 64 6f 63 |as high |high doc|
|00001020| 75 6d 65 6e 74 61 74 69 | 6f 6e 20 61 6e 64 20 63 |umentati|on and c|
|00001030| 6f 6e 66 69 67 75 72 61 | 74 69 6f 6e 20 6d 61 6e |onfigura|tion man|
|00001040| 61 67 65 6d 65 6e 74 0a | 73 74 61 6e 64 61 72 64 |agement.|standard|
|00001050| 73 2e 20 20 41 6c 70 68 | 61 20 72 65 6c 65 61 73 |s.  Alph|a releas|
|00001060| 65 73 20 61 72 65 20 64 | 65 73 69 67 6e 61 74 65 |es are d|esignate|
|00001070| 64 20 62 79 20 74 68 65 | 20 64 61 74 65 20 6f 6e |d by the| date on|
|00001080| 20 77 68 69 63 68 20 74 | 68 65 20 73 79 73 74 65 | which t|he syste|
|00001090| 6d 20 77 61 73 0a 62 75 | 69 6c 74 3b 20 74 68 65 |m was.bu|ilt; the|
|000010a0| 20 61 6c 70 68 61 20 72 | 65 6c 65 61 73 65 73 20 | alpha r|eleases |
|000010b0| 66 6f 72 20 64 69 66 66 | 65 72 65 6e 74 20 73 79 |for diff|erent sy|
|000010c0| 73 74 65 6d 73 20 6d 61 | 79 20 6e 6f 74 20 62 65 |stems ma|y not be|
|000010d0| 20 69 6e 20 65 78 61 63 | 74 0a 63 6f 72 72 65 73 | in exac|t.corres|
|000010e0| 70 6f 6e 64 65 6e 63 65 | 2c 20 73 69 6e 63 65 20 |pondence|, since |
|000010f0| 74 68 65 79 20 61 72 65 | 20 62 75 69 6c 74 20 61 |they are| built a|
|00001100| 74 20 64 69 66 66 65 72 | 65 6e 74 20 74 69 6d 65 |t differ|ent time|
|00001110| 73 2e 0a 0a 42 65 74 61 | 20 61 6e 64 20 64 65 66 |s...Beta| and def|
|00001120| 61 75 6c 74 20 72 65 6c | 65 61 73 65 73 20 61 72 |ault rel|eases ar|
|00001130| 65 20 61 6c 77 61 79 73 | 20 62 61 73 65 64 20 6f |e always| based o|
|00001140| 6e 20 61 20 73 6e 61 70 | 73 68 6f 74 2c 20 65 6e |n a snap|shot, en|
|00001150| 73 75 72 69 6e 67 20 74 | 68 61 74 20 61 6c 6c 0a |suring t|hat all.|
|00001160| 73 79 73 74 65 6d 73 20 | 61 72 65 20 62 61 73 65 |systems |are base|
|00001170| 64 20 6f 6e 20 74 68 65 | 20 73 61 6d 65 20 73 6f |d on the| same so|
|00001180| 75 72 63 65 73 2e 20 20 | 41 20 72 65 6c 65 61 73 |urces.  |A releas|
|00001190| 65 20 6e 61 6d 65 20 69 | 73 20 61 6e 20 69 6e 74 |e name i|s an int|
|000011a0| 65 67 65 72 20 61 6e 64 | 20 61 0a 6c 65 74 74 65 |eger and| a.lette|
|000011b0| 72 2c 20 6c 69 6b 65 20 | 60 60 31 35 64 27 27 2e |r, like |``15d''.|
|000011c0| 20 20 54 68 65 20 69 6e | 74 65 67 65 72 20 69 73 |  The in|teger is|
|000011d0| 20 74 68 65 20 6e 61 6d | 65 20 6f 66 20 74 68 65 | the nam|e of the|
|000011e0| 20 73 6f 75 72 63 65 20 | 74 72 65 65 20 77 68 69 | source |tree whi|
|000011f0| 63 68 20 74 68 65 0a 73 | 79 73 74 65 6d 20 77 61 |ch the.s|ystem wa|
|00001200| 73 20 62 75 69 6c 74 20 | 66 72 6f 6d 2c 20 61 6e |s built |from, an|
|00001210| 64 20 74 68 65 20 6c 65 | 74 74 65 72 20 72 65 70 |d the le|tter rep|
|00001220| 72 65 73 65 6e 74 73 20 | 74 68 65 20 72 65 6c 65 |resents |the rele|
|00001230| 61 73 65 20 66 72 6f 6d | 20 74 68 61 74 20 74 72 |ase from| that tr|
|00001240| 65 65 3a 0a 60 60 61 27 | 27 20 69 73 20 74 68 65 |ee:.``a'|' is the|
|00001250| 20 66 69 72 73 74 20 72 | 65 6c 65 61 73 65 2c 20 | first r|elease, |
|00001260| 65 74 63 2e 20 20 47 65 | 6e 65 72 61 6c 6c 79 20 |etc.  Ge|nerally |
|00001270| 74 68 65 20 6e 75 6d 65 | 72 69 63 20 70 61 72 74 |the nume|ric part|
|00001280| 20 69 6e 63 72 65 61 73 | 65 73 20 77 68 65 6e 0a | increas|es when.|
|00001290| 74 68 65 72 65 20 61 72 | 65 20 6d 61 6a 6f 72 20 |there ar|e major |
|000012a0| 73 79 73 74 65 6d 20 63 | 68 61 6e 67 65 73 2c 20 |system c|hanges, |
|000012b0| 77 68 65 72 65 61 73 20 | 63 68 61 6e 67 65 73 20 |whereas |changes |
|000012c0| 69 6e 20 74 68 65 20 6c | 65 74 74 65 72 20 72 65 |in the l|etter re|
|000012d0| 70 72 65 73 65 6e 74 0a | 62 75 67 2d 66 69 78 65 |present.|bug-fixe|
|000012e0| 73 20 61 6e 64 20 6d 69 | 6e 6f 72 20 65 6e 68 61 |s and mi|nor enha|
|000012f0| 6e 63 65 6d 65 6e 74 73 | 2e 0a 0a 5c 73 65 63 74 |ncements|...\sect|
|00001300| 69 6f 6e 7b 53 6f 75 72 | 63 65 20 54 72 65 65 20 |ion{Sour|ce Tree |
|00001310| 53 74 72 75 63 74 75 72 | 65 7d 0a 0a 41 20 73 6f |Structur|e}..A so|
|00001320| 75 72 63 65 20 74 72 65 | 65 20 28 61 6e 64 20 74 |urce tre|e (and t|
|00001330| 68 65 20 6d 61 73 74 65 | 72 20 60 60 7b 5c 74 74 |he maste|r ``{\tt|
|00001340| 20 72 63 73 7d 27 27 20 | 74 72 65 65 29 20 68 61 | rcs}'' |tree) ha|
|00001350| 73 20 73 75 62 64 69 72 | 65 63 74 6f 72 69 65 73 |s subdir|ectories|
|00001360| 20 66 6f 72 20 65 61 63 | 68 0a 6d 61 6a 6f 72 20 | for eac|h.major |
|00001370| 73 75 62 73 79 73 74 65 | 6d 3a 0a 5c 62 65 67 69 |subsyste|m:.\begi|
|00001380| 6e 7b 64 65 73 63 72 69 | 70 74 69 6f 6e 7d 0a 5c |n{descri|ption}.\|
|00001390| 69 74 65 6d 5b 7b 5c 74 | 74 20 61 73 73 65 6d 62 |item[{\t|t assemb|
|000013a0| 6c 79 2f 7d 5d 20 48 6f | 6c 64 73 20 74 68 65 20 |ly/}] Ho|lds the |
|000013b0| 43 4d 55 20 43 4c 20 73 | 6f 75 72 63 65 2d 66 69 |CMU CL s|ource-fi|
|000013c0| 6c 65 20 61 73 73 65 6d | 62 6c 65 72 2c 20 61 6e |le assem|bler, an|
|000013d0| 64 20 68 61 73 20 6d 61 | 63 68 69 6e 65 0a 73 70 |d has ma|chine.sp|
|000013e0| 65 63 69 66 69 63 20 73 | 75 62 64 69 72 65 63 74 |ecific s|ubdirect|
|000013f0| 6f 72 69 65 73 20 68 6f | 6c 64 69 6e 67 20 61 73 |ories ho|lding as|
|00001400| 73 65 6d 62 6c 79 20 63 | 6f 64 65 20 66 6f 72 20 |sembly c|ode for |
|00001410| 74 68 61 74 20 61 72 63 | 68 69 74 65 63 74 75 72 |that arc|hitectur|
|00001420| 65 2e 0a 0a 5c 69 74 65 | 6d 5b 7b 5c 74 74 20 63 |e...\ite|m[{\tt c|
|00001430| 6c 78 2f 7d 5d 20 54 68 | 65 20 43 4c 58 20 69 6e |lx/}] Th|e CLX in|
|00001440| 74 65 72 66 61 63 65 20 | 74 6f 20 74 68 65 20 58 |terface |to the X|
|00001450| 31 31 20 77 69 6e 64 6f | 77 20 73 79 73 74 65 6d |11 windo|w system|
|00001460| 2e 0a 0a 5c 69 74 65 6d | 5b 7b 5c 74 74 20 63 6f |...\item|[{\tt co|
|00001470| 64 65 2f 7d 5d 20 54 68 | 65 20 4c 69 73 70 20 63 |de/}] Th|e Lisp c|
|00001480| 6f 64 65 20 66 6f 72 20 | 74 68 65 20 72 75 6e 74 |ode for |the runt|
|00001490| 69 6d 65 20 73 79 73 74 | 65 6d 20 61 6e 64 20 73 |ime syst|em and s|
|000014a0| 74 61 6e 64 61 72 64 20 | 43 4c 0a 75 74 69 6c 69 |tandard |CL.utili|
|000014b0| 74 69 65 73 2e 0a 0a 5c | 69 74 65 6d 5b 7b 5c 74 |ties...\|item[{\t|
|000014c0| 74 20 63 6f 6d 70 69 6c | 65 72 2f 7d 5d 20 54 68 |t compil|er/}] Th|
|000014d0| 65 20 50 79 74 68 6f 6e | 20 63 6f 6d 70 69 6c 65 |e Python| compile|
|000014e0| 72 2e 20 20 48 61 73 20 | 61 72 63 68 69 74 65 63 |r.  Has |architec|
|000014f0| 74 75 72 65 2d 73 70 65 | 63 69 66 69 63 0a 73 75 |ture-spe|cific.su|
|00001500| 62 64 69 72 65 63 74 6f | 72 69 65 73 20 77 68 69 |bdirecto|ries whi|
|00001510| 63 68 20 68 6f 6c 64 20 | 62 61 63 6b 65 6e 64 73 |ch hold |backends|
|00001520| 20 66 6f 72 20 64 69 66 | 66 65 72 65 6e 74 20 6d | for dif|ferent m|
|00001530| 61 63 68 69 6e 65 73 2e | 20 20 54 68 65 20 7b 5c |achines.|  The {\|
|00001540| 74 74 20 67 65 6e 65 72 | 69 63 7d 0a 73 75 62 64 |tt gener|ic}.subd|
|00001550| 69 72 65 63 74 6f 72 79 | 20 68 6f 6c 64 73 20 63 |irectory| holds c|
|00001560| 6f 64 65 20 74 68 61 74 | 20 69 73 20 73 68 61 72 |ode that| is shar|
|00001570| 65 64 20 61 63 72 6f 73 | 73 20 6d 6f 73 74 20 62 |ed acros|s most b|
|00001580| 61 63 6b 65 6e 64 73 2e | 0a 0a 5c 69 74 65 6d 5b |ackends.|..\item[|
|00001590| 7b 5c 74 74 20 68 65 6d | 6c 6f 63 6b 2f 7d 5d 20 |{\tt hem|lock/}] |
|000015a0| 54 68 65 20 48 65 6d 6c | 6f 63 6b 20 65 64 69 74 |The Heml|ock edit|
|000015b0| 6f 72 2e 0a 0a 5c 69 74 | 65 6d 5b 7b 5c 74 74 20 |or...\it|em[{\tt |
|000015c0| 6c 64 62 2f 7d 5d 20 54 | 68 65 20 43 20 72 75 6e |ldb/}] T|he C run|
|000015d0| 74 69 6d 65 20 73 79 73 | 74 65 6d 20 63 6f 64 65 |time sys|tem code|
|000015e0| 20 61 6e 64 20 6c 6f 77 | 2d 6c 65 76 65 6c 20 60 | and low|-level `|
|000015f0| 60 4c 69 73 70 20 44 65 | 42 75 67 67 65 72 27 27 |`Lisp De|Bugger''|
|00001600| 2e 0a 0a 5c 69 74 65 6d | 5b 7b 5c 74 74 20 70 63 |...\item|[{\tt pc|
|00001610| 6c 2f 7d 5d 20 43 4d 55 | 20 76 65 72 73 69 6f 6e |l/}] CMU| version|
|00001620| 20 6f 66 20 74 68 65 20 | 50 43 4c 20 69 6d 70 6c | of the |PCL impl|
|00001630| 65 6d 65 6e 74 61 74 69 | 6f 6e 20 6f 66 20 43 4c |ementati|on of CL|
|00001640| 4f 53 2e 0a 0a 5c 69 74 | 65 6d 5b 7b 5c 74 74 20 |OS...\it|em[{\tt |
|00001650| 74 6f 6f 6c 73 2f 7d 5d | 20 53 79 73 74 65 6d 20 |tools/}]| System |
|00001660| 62 75 69 6c 64 69 6e 67 | 20 63 6f 6d 6d 61 6e 64 |building| command|
|00001670| 20 66 69 6c 65 73 20 61 | 6e 64 20 73 6f 75 72 63 | files a|nd sourc|
|00001680| 65 20 6d 61 6e 61 67 65 | 6d 65 6e 74 20 74 6f 6f |e manage|ment too|
|00001690| 6c 73 2e 0a 5c 65 6e 64 | 7b 64 65 73 63 72 69 70 |ls..\end|{descrip|
|000016a0| 74 69 6f 6e 7d 0a 0a 0c | 0a 5c 73 65 63 74 69 6f |tion}...|.\sectio|
|000016b0| 6e 7b 50 61 63 6b 61 67 | 65 20 73 74 72 75 63 74 |n{Packag|e struct|
|000016c0| 75 72 65 7d 0a 0a 47 6f | 61 6c 73 3a 20 77 69 74 |ure}..Go|als: wit|
|000016d0| 68 20 74 68 65 20 73 69 | 6e 67 6c 65 20 65 78 63 |h the si|ngle exc|
|000016e0| 65 70 74 69 6f 6e 20 6f | 66 20 4c 49 53 50 2c 20 |eption o|f LISP, |
|000016f0| 77 65 20 77 61 6e 74 20 | 74 6f 20 62 65 20 61 62 |we want |to be ab|
|00001700| 6c 65 20 74 6f 20 65 78 | 70 6f 72 74 20 66 72 6f |le to ex|port fro|
|00001710| 6d 20 74 68 65 0a 70 61 | 63 6b 61 67 65 20 74 68 |m the.pa|ckage th|
|00001720| 61 74 20 74 68 65 20 63 | 6f 64 65 20 6c 69 76 65 |at the c|ode live|
|00001730| 73 20 69 6e 2e 0a 0a 5c | 62 65 67 69 6e 7b 64 65 |s in...\|begin{de|
|00001740| 73 63 72 69 70 74 69 6f | 6e 7d 0a 5c 69 74 65 6d |scriptio|n}.\item|
|00001750| 5b 4d 61 63 68 2c 20 43 | 4c 58 2e 2e 2e 5d 20 2d |[Mach, C|LX...] -|
|00001760| 2d 2d 20 54 68 65 73 65 | 20 49 6d 70 6c 65 6d 65 |-- These| Impleme|
|00001770| 6e 74 61 74 69 6f 6e 2d | 64 65 70 65 6e 64 65 6e |ntation-|dependen|
|00001780| 74 20 73 79 73 74 65 6d | 2d 69 6e 74 65 72 66 61 |t system|-interfa|
|00001790| 63 65 0a 70 61 63 6b 61 | 67 65 73 20 70 72 6f 76 |ce.packa|ges prov|
|000017a0| 69 64 65 20 64 69 72 65 | 63 74 20 61 63 63 65 73 |ide dire|ct acces|
|000017b0| 73 20 74 6f 20 73 70 65 | 63 69 66 69 63 20 66 65 |s to spe|cific fe|
|000017c0| 61 74 75 72 65 73 20 61 | 76 61 69 6c 61 62 6c 65 |atures a|vailable|
|000017d0| 20 69 6e 20 74 68 65 20 | 6f 70 65 72 61 74 69 6e | in the |operatin|
|000017e0| 67 0a 73 79 73 74 65 6d | 20 65 6e 76 69 72 6f 6e |g.system| environ|
|000017f0| 6d 65 6e 74 2c 20 62 75 | 74 20 68 69 64 65 20 64 |ment, bu|t hide d|
|00001800| 65 74 61 69 6c 73 20 6f | 66 20 68 6f 77 20 4f 53 |etails o|f how OS|
|00001810| 20 63 6f 6d 6d 75 6e 69 | 63 61 74 69 6f 6e 20 69 | communi|cation i|
|00001820| 73 20 64 6f 6e 65 2e 0a | 0a 5c 69 74 65 6d 5b 73 |s done..|.\item[s|
|00001830| 79 73 74 65 6d 5d 20 63 | 6f 6e 74 61 69 6e 73 20 |ystem] c|ontains |
|00001840| 63 6f 64 65 20 74 68 61 | 74 20 6d 75 73 74 20 6b |code tha|t must k|
|00001850| 6e 6f 77 20 61 62 6f 75 | 74 20 74 68 65 20 6f 70 |now abou|t the op|
|00001860| 65 72 61 74 69 6e 67 20 | 73 79 73 74 65 6d 0a 65 |erating |system.e|
|00001870| 6e 76 69 72 6f 6e 6d 65 | 6e 74 3a 20 49 2f 4f 2c |nvironme|nt: I/O,|
|00001880| 20 65 74 63 2e 20 20 48 | 69 64 65 73 20 74 68 65 | etc.  H|ides the|
|00001890| 20 6f 70 65 72 61 74 69 | 6e 67 20 73 79 73 74 65 | operati|ng syste|
|000018a0| 6d 20 65 6e 76 69 72 6f | 6e 6d 65 6e 74 2e 20 20 |m enviro|nment.  |
|000018b0| 50 72 6f 76 69 64 65 73 | 20 4f 53 0a 69 6e 74 65 |Provides| OS.inte|
|000018c0| 72 66 61 63 65 20 65 78 | 74 65 6e 73 69 6f 6e 73 |rface ex|tensions|
|000018d0| 20 73 75 63 68 20 61 73 | 20 7b 5c 74 74 20 70 72 | such as| {\tt pr|
|000018e0| 69 6e 74 2d 64 69 72 65 | 63 74 6f 72 79 7d 2c 20 |int-dire|ctory}, |
|000018f0| 65 74 63 2e 0a 0a 5c 69 | 74 65 6d 5b 6b 65 72 6e |etc...\i|tem[kern|
|00001900| 65 6c 5d 20 68 69 64 65 | 73 20 73 74 61 74 65 20 |el] hide|s state |
|00001910| 61 6e 64 20 74 79 70 65 | 73 20 75 73 65 64 20 66 |and type|s used f|
|00001920| 6f 72 20 73 79 73 74 65 | 6d 20 69 6e 74 65 67 72 |or syste|m integr|
|00001930| 61 74 69 6f 6e 3a 20 70 | 61 63 6b 61 67 65 0a 73 |ation: p|ackage.s|
|00001940| 79 73 74 65 6d 2c 20 65 | 72 72 6f 72 20 73 79 73 |ystem, e|rror sys|
|00001950| 74 65 6d 2c 20 73 74 72 | 65 61 6d 73 20 28 3f 29 |tem, str|eams (?)|
|00001960| 2c 20 72 65 61 64 65 72 | 2c 20 70 72 69 6e 74 65 |, reader|, printe|
|00001970| 72 2e 20 20 41 6c 73 6f | 2c 20 68 69 64 65 73 20 |r.  Also|, hides |
|00001980| 74 68 65 20 56 4d 2c 20 | 69 6e 0a 74 68 61 74 20 |the VM, |in.that |
|00001990| 77 65 20 64 6f 6e 27 74 | 20 65 78 70 6f 72 74 20 |we don't| export |
|000019a0| 61 6e 79 74 68 69 6e 67 | 20 74 68 61 74 20 72 65 |anything| that re|
|000019b0| 76 65 61 6c 73 20 74 68 | 65 20 56 4d 20 69 6e 74 |veals th|e VM int|
|000019c0| 65 72 66 61 63 65 2e 20 | 20 43 6f 6e 74 61 69 6e |erface. | Contain|
|000019d0| 73 20 63 6f 64 65 0a 74 | 68 61 74 20 6e 65 65 64 |s code.t|hat need|
|000019e0| 73 20 74 6f 20 75 73 65 | 20 74 68 65 20 56 4d 20 |s to use| the VM |
|000019f0| 61 6e 64 20 53 59 53 54 | 45 4d 20 69 6e 74 65 72 |and SYST|EM inter|
|00001a00| 66 61 63 65 2c 20 62 75 | 74 20 69 73 20 69 6e 64 |face, bu|t is ind|
|00001a10| 65 70 65 6e 64 65 6e 74 | 20 6f 66 20 4f 53 20 61 |ependent| of OS a|
|00001a20| 6e 64 20 56 4d 0a 64 65 | 74 61 69 6c 73 2e 20 20 |nd VM.de|tails.  |
|00001a30| 54 68 69 73 20 63 6f 64 | 65 20 73 68 6f 75 6c 64 |This cod|e should|
|00001a40| 6e 27 74 20 6e 65 65 64 | 20 74 6f 20 62 65 20 63 |n't need| to be c|
|00001a50| 68 61 6e 67 65 64 20 69 | 6e 20 61 6e 79 20 70 6f |hanged i|n any po|
|00001a60| 72 74 20 6f 66 20 43 4d | 55 20 43 4c 2c 20 62 75 |rt of CM|U CL, bu|
|00001a70| 74 0a 77 6f 6e 27 74 20 | 77 6f 72 6b 20 77 68 65 |t.won't |work whe|
|00001a80| 6e 20 70 6c 6f 70 70 65 | 64 20 69 6e 74 6f 20 61 |n ploppe|d into a|
|00001a90| 6e 20 61 72 62 69 74 72 | 61 72 79 20 43 4c 2e 20 |n arbitr|ary CL. |
|00001aa0| 20 55 73 65 73 20 53 59 | 53 54 45 4d 2c 20 56 4d | Uses SY|STEM, VM|
|00001ab0| 2c 20 45 58 54 45 4e 53 | 49 4f 4e 53 2e 20 20 57 |, EXTENS|IONS.  W|
|00001ac0| 65 0a 65 78 70 6f 72 74 | 20 22 68 69 64 64 65 6e |e.export| "hidden|
|00001ad0| 22 20 73 79 6d 62 6f 6c | 73 20 72 65 6c 61 74 65 |" symbol|s relate|
|00001ae0| 64 20 74 6f 20 69 6d 70 | 6c 65 6d 65 6e 74 61 74 |d to imp|lementat|
|00001af0| 69 6f 6e 20 6f 66 20 43 | 4c 3a 20 73 65 74 66 2d |ion of C|L: setf-|
|00001b00| 69 6e 76 65 72 73 65 73 | 2c 0a 70 6f 73 73 69 62 |inverses|,.possib|
|00001b10| 6c 79 20 73 6f 6d 65 20 | 67 6c 6f 62 61 6c 20 76 |ly some |global v|
|00001b20| 61 72 69 61 62 6c 65 73 | 2e 0a 0a 54 68 65 20 62 |ariables|...The b|
|00001b30| 6f 75 6e 64 61 72 79 20 | 62 65 74 77 65 65 6e 20 |oundary |between |
|00001b40| 4b 45 52 4e 45 4c 20 61 | 6e 64 20 56 4d 20 69 73 |KERNEL a|nd VM is|
|00001b50| 20 66 75 7a 7a 79 2c 20 | 62 75 74 20 74 68 69 73 | fuzzy, |but this|
|00001b60| 20 66 75 7a 7a 69 6e 65 | 73 73 20 72 65 66 6c 65 | fuzzine|ss refle|
|00001b70| 63 74 73 20 74 68 65 0a | 66 75 7a 7a 69 6e 65 73 |cts the.|fuzzines|
|00001b80| 73 20 69 6e 20 74 68 65 | 20 64 65 66 69 6e 69 74 |s in the| definit|
|00001b90| 69 6f 6e 20 6f 66 20 74 | 68 65 20 56 4d 2e 20 20 |ion of t|he VM.  |
|00001ba0| 57 65 20 63 61 6e 20 6d | 61 6b 65 20 74 68 65 20 |We can m|ake the |
|00001bb0| 56 4d 20 6c 61 72 67 65 | 2c 20 61 6e 64 20 62 72 |VM large|, and br|
|00001bc0| 69 6e 67 0a 65 76 65 72 | 79 74 68 69 6e 67 20 69 |ing.ever|ything i|
|00001bd0| 6e 73 69 64 65 2c 20 6f | 72 20 77 65 20 6d 61 6b |nside, o|r we mak|
|00001be0| 65 20 6d 61 6b 65 20 69 | 74 20 73 6d 61 6c 6c 2e |e make i|t small.|
|00001bf0| 20 20 4f 62 76 69 6f 75 | 73 6c 79 2c 20 77 65 20 |  Obviou|sly, we |
|00001c00| 77 61 6e 74 20 74 68 65 | 20 56 4d 20 74 6f 20 62 |want the| VM to b|
|00001c10| 65 0a 61 73 20 73 6d 61 | 6c 6c 20 61 73 20 70 6f |e.as sma|ll as po|
|00001c20| 73 73 69 62 6c 65 2c 20 | 73 75 62 6a 65 63 74 20 |ssible, |subject |
|00001c30| 74 6f 20 65 66 66 69 63 | 69 65 6e 63 79 20 63 6f |to effic|iency co|
|00001c40| 6e 73 74 72 61 69 6e 74 | 73 2e 20 20 50 72 65 74 |nstraint|s.  Pret|
|00001c50| 74 79 20 6d 75 63 68 20 | 61 6c 6c 20 6f 66 0a 74 |ty much |all of.t|
|00001c60| 68 65 20 63 6f 64 65 20 | 69 6e 20 4b 45 52 4e 45 |he code |in KERNE|
|00001c70| 4c 20 63 6f 75 6c 64 20 | 62 65 20 70 75 74 20 69 |L could |be put i|
|00001c80| 6e 20 56 4d 2e 20 20 54 | 68 65 20 69 73 73 75 65 |n VM.  T|he issue|
|00001c90| 20 69 73 20 6d 6f 72 65 | 20 77 68 61 74 20 56 4d | is more| what VM|
|00001ca0| 20 68 69 64 65 73 20 66 | 72 6f 6d 0a 4b 45 52 4e | hides f|rom.KERN|
|00001cb0| 45 4c 3a 20 56 4d 20 6b | 6e 6f 77 73 20 61 62 6f |EL: VM k|nows abo|
|00001cc0| 75 74 20 65 76 65 72 79 | 74 68 69 6e 67 2e 0a 0a |ut every|thing...|
|00001cd0| 5c 69 74 65 6d 5b 6c 69 | 73 70 5d 20 20 4f 72 69 |\item[li|sp]  Ori|
|00001ce0| 67 69 6e 61 6c 6c 79 2c | 20 74 68 69 73 20 70 61 |ginally,| this pa|
|00001cf0| 63 6b 61 67 65 20 68 61 | 64 20 61 6c 6c 20 74 68 |ckage ha|d all th|
|00001d00| 65 20 73 79 73 74 65 6d | 20 63 6f 64 65 20 69 6e |e system| code in|
|00001d10| 20 69 74 2e 20 20 54 68 | 65 0a 63 75 72 72 65 6e | it.  Th|e.curren|
|00001d20| 74 20 69 64 65 61 6c 20 | 69 73 20 74 68 61 74 20 |t ideal |is that |
|00001d30| 74 68 69 73 20 70 61 63 | 6b 61 67 65 20 73 68 6f |this pac|kage sho|
|00001d40| 75 6c 64 20 68 61 76 65 | 20 7b 5c 69 74 20 6e 6f |uld have| {\it no|
|00001d50| 7d 20 63 6f 64 65 20 69 | 6e 20 69 74 2c 20 61 6e |} code i|n it, an|
|00001d60| 64 20 6f 6e 6c 79 0a 65 | 78 69 73 74 20 74 6f 20 |d only.e|xist to |
|00001d70| 65 78 70 6f 72 74 20 74 | 68 65 20 73 74 61 6e 64 |export t|he stand|
|00001d80| 61 72 64 20 69 6e 74 65 | 72 66 61 63 65 2e 20 20 |ard inte|rface.  |
|00001d90| 4e 6f 74 65 20 74 68 61 | 74 20 74 68 65 20 6e 61 |Note tha|t the na|
|00001da0| 6d 65 20 68 61 73 20 62 | 65 65 6e 20 63 68 61 6e |me has b|een chan|
|00001db0| 67 65 64 20 62 79 0a 78 | 33 6a 31 33 20 74 6f 20 |ged by.x|3j13 to |
|00001dc0| 63 6f 6d 6d 6f 6e 2d 6c | 69 73 70 2e 0a 0a 5c 69 |common-l|isp...\i|
|00001dd0| 74 65 6d 5b 65 78 74 65 | 6e 73 69 6f 6e 73 5d 20 |tem[exte|nsions] |
|00001de0| 63 6f 6e 74 61 69 6e 73 | 20 63 6f 64 65 20 74 68 |contains| code th|
|00001df0| 61 74 20 61 6e 79 20 72 | 61 6e 64 6f 6d 20 75 73 |at any r|andom us|
|00001e00| 65 72 20 63 6f 75 6c 64 | 20 68 61 76 65 20 77 72 |er could| have wr|
|00001e10| 69 74 74 65 6e 3a 20 6c | 69 73 74 0a 6f 70 65 72 |itten: l|ist.oper|
|00001e20| 61 74 69 6f 6e 73 2c 20 | 73 79 6e 74 61 63 74 69 |ations, |syntacti|
|00001e30| 63 20 73 75 67 61 72 20 | 6d 61 63 72 6f 73 2e 20 |c sugar |macros. |
|00001e40| 20 55 73 65 73 20 6f 6e | 6c 79 20 4c 49 53 50 2c | Uses on|ly LISP,|
|00001e50| 20 73 6f 20 63 6f 64 65 | 20 69 6e 20 45 58 54 45 | so code| in EXTE|
|00001e60| 4e 53 49 4f 4e 53 20 69 | 73 0a 70 75 72 65 20 43 |NSIONS i|s.pure C|
|00001e70| 4c 2e 20 20 45 78 70 6f | 72 74 73 20 65 76 65 72 |L.  Expo|rts ever|
|00001e80| 79 74 68 69 6e 67 20 64 | 65 66 69 6e 65 64 20 77 |ything d|efined w|
|00001e90| 69 74 68 69 6e 20 74 68 | 61 74 20 69 73 20 75 73 |ithin th|at is us|
|00001ea0| 65 66 75 6c 20 65 6c 73 | 65 77 68 65 72 65 2e 20 |eful els|ewhere. |
|00001eb0| 20 54 68 69 73 0a 70 61 | 63 6b 61 67 65 20 64 6f | This.pa|ckage do|
|00001ec0| 65 73 6e 27 74 20 68 69 | 64 65 20 6d 75 63 68 2c |esn't hi|de much,|
|00001ed0| 20 73 6f 20 69 74 20 69 | 73 20 72 65 6c 61 74 69 | so it i|s relati|
|00001ee0| 76 65 6c 79 20 73 61 66 | 65 20 66 6f 72 20 75 73 |vely saf|e for us|
|00001ef0| 65 72 73 20 74 6f 20 75 | 73 65 0a 45 58 54 45 4e |ers to u|se.EXTEN|
|00001f00| 53 49 4f 4e 53 2c 20 73 | 69 6e 63 65 20 74 68 65 |SIONS, s|ince the|
|00001f10| 79 20 61 72 65 6e 27 74 | 20 67 65 74 74 69 6e 67 |y aren't| getting|
|00001f20| 20 61 6e 79 74 68 69 6e | 67 20 74 68 65 79 20 63 | anythin|g they c|
|00001f30| 6f 75 6c 64 6e 27 74 20 | 68 61 76 65 20 77 72 69 |ouldn't |have wri|
|00001f40| 74 74 65 6e 0a 74 68 65 | 6d 73 65 6c 76 65 73 2e |tten.the|mselves.|
|00001f50| 20 20 43 6f 6e 74 72 61 | 73 74 20 74 68 69 73 20 |  Contra|st this |
|00001f60| 74 6f 20 4b 45 52 4e 45 | 4c 2c 20 77 68 69 63 68 |to KERNE|L, which|
|00001f70| 20 65 78 70 6f 72 74 73 | 20 61 64 64 69 74 69 6f | exports| additio|
|00001f80| 6e 61 6c 20 6f 70 65 72 | 61 74 69 6f 6e 73 20 6f |nal oper|ations o|
|00001f90| 6e 0a 43 4c 27 73 20 70 | 72 69 6d 69 74 69 76 65 |n.CL's p|rimitive|
|00001fa0| 20 64 61 74 61 20 73 74 | 72 75 63 74 75 72 65 73 | data st|ructures|
|00001fb0| 3a 20 50 41 43 4b 41 47 | 45 2d 49 4e 54 45 52 4e |: PACKAG|E-INTERN|
|00001fc0| 41 4c 2d 53 59 4d 42 4f | 4c 2d 43 4f 55 4e 54 2c |AL-SYMBO|L-COUNT,|
|00001fd0| 20 65 74 63 2e 20 20 41 | 6c 74 68 6f 75 67 68 0a | etc.  A|lthough.|
|00001fe0| 73 6f 6d 65 20 6f 66 20 | 74 68 65 20 66 75 6e 63 |some of |the func|
|00001ff0| 74 69 6f 6e 61 6c 69 74 | 79 20 65 78 70 6f 72 74 |tionalit|y export|
|00002000| 65 64 20 66 72 6f 6d 20 | 4b 45 52 4e 45 4c 20 63 |ed from |KERNEL c|
|00002010| 6f 75 6c 64 20 68 61 76 | 65 20 62 65 65 6e 20 64 |ould hav|e been d|
|00002020| 65 66 69 6e 65 64 20 69 | 6e 20 43 4c 2c 0a 74 68 |efined i|n CL,.th|
|00002030| 65 20 6b 65 72 6e 65 6c | 20 69 6d 70 6c 65 6d 65 |e kernel| impleme|
|00002040| 6e 74 61 74 69 6f 6e 20 | 69 73 20 6d 75 63 68 20 |ntation |is much |
|00002050| 6d 6f 72 65 20 65 66 66 | 69 63 69 65 6e 74 20 62 |more eff|icient b|
|00002060| 65 63 61 75 73 65 20 69 | 74 20 6b 6e 6f 77 73 20 |ecause i|t knows |
|00002070| 61 62 6f 75 74 0a 69 6d | 70 6c 65 6d 65 6e 74 61 |about.im|plementa|
|00002080| 74 69 6f 6e 20 69 6e 74 | 65 72 6e 61 6c 73 2e 20 |tion int|ernals. |
|00002090| 20 43 75 72 72 65 6e 74 | 6c 79 20 74 68 69 73 20 | Current|ly this |
|000020a0| 70 61 63 6b 61 67 65 20 | 63 6f 6e 74 61 69 6e 73 |package |contains|
|000020b0| 20 6f 6e 6c 79 20 65 78 | 74 65 6e 73 69 6f 6e 73 | only ex|tensions|
|000020c0| 20 74 6f 0a 43 4c 2c 20 | 62 75 74 20 69 6e 20 74 | to.CL, |but in t|
|000020d0| 68 65 20 69 64 65 61 6c | 20 73 63 68 65 6d 65 20 |he ideal| scheme |
|000020e0| 6f 66 20 74 68 69 6e 67 | 73 2c 20 69 74 20 73 68 |of thing|s, it sh|
|000020f0| 6f 75 6c 64 20 63 6f 6e | 74 61 69 6e 20 74 68 65 |ould con|tain the|
|00002100| 20 69 6d 70 6c 65 6d 65 | 6e 74 61 74 69 6f 6e 73 | impleme|ntations|
|00002110| 20 6f 66 0a 61 6c 6c 20 | 43 4c 20 66 75 6e 63 74 | of.all |CL funct|
|00002120| 69 6f 6e 73 20 74 68 61 | 74 20 61 72 65 20 69 6e |ions tha|t are in|
|00002130| 20 4b 45 52 4e 45 4c 20 | 28 74 68 65 20 6c 69 62 | KERNEL |(the lib|
|00002140| 72 61 72 79 2e 29 0a 0a | 5c 69 74 65 6d 5b 56 4d |rary.)..|\item[VM|
|00002150| 5d 20 68 69 64 65 73 20 | 69 6e 66 6f 72 6d 61 74 |] hides |informat|
|00002160| 69 6f 6e 20 61 62 6f 75 | 74 20 74 68 65 20 68 61 |ion abou|t the ha|
|00002170| 72 64 77 61 72 65 20 61 | 6e 64 20 64 61 74 61 20 |rdware a|nd data |
|00002180| 73 74 72 75 63 74 75 72 | 65 0a 72 65 70 72 65 73 |structur|e.repres|
|00002190| 65 6e 74 61 74 69 6f 6e | 73 2e 20 20 43 6f 6e 74 |entation|s.  Cont|
|000021a0| 61 69 6e 73 20 61 6c 6c | 20 63 6f 64 65 20 74 68 |ains all| code th|
|000021b0| 61 74 20 6b 6e 6f 77 73 | 20 61 62 6f 75 74 20 74 |at knows| about t|
|000021c0| 68 69 73 20 73 6f 72 74 | 20 6f 66 20 74 68 69 6e |his sort| of thin|
|000021d0| 67 3a 20 70 61 72 74 73 | 0a 6f 66 20 74 68 65 20 |g: parts|.of the |
|000021e0| 63 6f 6d 70 69 6c 65 72 | 2c 20 47 43 2c 20 65 74 |compiler|, GC, et|
|000021f0| 63 2e 20 20 54 68 65 20 | 62 75 6c 6b 20 6f 66 20 |c.  The |bulk of |
|00002200| 74 68 65 20 63 6f 64 65 | 20 69 73 20 74 68 65 20 |the code| is the |
|00002210| 63 6f 6d 70 69 6c 65 72 | 20 62 61 63 6b 2d 65 6e |compiler| back-en|
|00002220| 64 2e 0a 45 78 70 6f 72 | 74 73 20 75 73 65 66 75 |d..Expor|ts usefu|
|00002230| 6c 20 74 68 69 6e 67 73 | 20 74 68 61 74 20 61 72 |l things| that ar|
|00002240| 65 20 6d 65 61 6e 69 6e | 67 66 75 6c 20 61 63 72 |e meanin|gful acr|
|00002250| 6f 73 73 20 61 6c 6c 20 | 69 6d 70 6c 65 6d 65 6e |oss all |implemen|
|00002260| 74 61 74 69 6f 6e 73 2c | 20 73 75 63 68 20 61 73 |tations,| such as|
|00002270| 0a 6f 70 65 72 61 74 69 | 6f 6e 73 20 66 6f 72 20 |.operati|ons for |
|00002280| 65 78 61 6d 69 6e 69 6e | 67 20 63 6f 6d 70 69 6c |examinin|g compil|
|00002290| 65 64 20 66 75 6e 63 74 | 69 6f 6e 73 2c 20 73 79 |ed funct|ions, sy|
|000022a0| 73 74 65 6d 20 63 6f 6e | 73 74 61 6e 74 73 2e 20 |stem con|stants. |
|000022b0| 20 55 73 65 73 20 43 4f | 4d 50 49 4c 45 52 0a 61 | Uses CO|MPILER.a|
|000022c0| 6e 64 20 77 68 61 74 65 | 76 65 72 20 65 6c 73 65 |nd whate|ver else|
|000022d0| 20 69 74 20 77 61 6e 74 | 73 2e 20 20 41 63 74 75 | it want|s.  Actu|
|000022e0| 61 6c 6c 79 2c 20 74 68 | 65 72 65 20 61 72 65 20 |ally, th|ere are |
|000022f0| 64 69 66 66 65 72 65 6e | 74 20 7b 5c 69 74 20 6d |differen|t {\it m|
|00002300| 61 63 68 69 6e 65 7d 7b | 5c 74 74 0a 2d 56 4d 7d |achine}{|\tt.-VM}|
|00002310| 20 70 61 63 6b 61 67 65 | 73 20 66 6f 72 20 65 61 | package|s for ea|
|00002320| 63 68 20 74 61 72 67 65 | 74 20 69 6d 70 6c 65 6d |ch targe|t implem|
|00002330| 65 6e 74 61 74 69 6f 6e | 2e 20 20 56 4d 20 69 73 |entation|.  VM is|
|00002340| 20 61 20 6e 69 63 6b 6e | 61 6d 65 20 66 6f 72 20 | a nickn|ame for |
|00002350| 77 68 61 74 65 76 65 72 | 0a 69 6d 70 6c 65 6d 65 |whatever|.impleme|
|00002360| 6e 74 61 74 69 6f 6e 20 | 77 65 20 61 72 65 20 63 |ntation |we are c|
|00002370| 75 72 72 65 6e 74 6c 79 | 20 74 61 72 67 65 74 69 |urrently| targeti|
|00002380| 6e 67 20 66 6f 72 2e 0a | 0a 0a 5c 69 74 65 6d 5b |ng for..|..\item[|
|00002390| 63 6f 6d 70 69 6c 65 72 | 5d 20 68 69 64 65 73 20 |compiler|] hides |
|000023a0| 74 68 65 20 61 6c 67 6f | 72 69 74 68 6d 73 20 75 |the algo|rithms u|
|000023b0| 73 65 64 20 74 6f 20 6d | 61 70 20 4c 69 73 70 20 |sed to m|ap Lisp |
|000023c0| 73 65 6d 61 6e 74 69 63 | 73 20 6f 6e 74 6f 20 74 |semantic|s onto t|
|000023d0| 68 65 0a 6f 70 65 72 61 | 74 69 6f 6e 73 20 73 75 |he.opera|tions su|
|000023e0| 70 70 6c 69 65 64 20 62 | 79 20 74 68 65 20 56 4d |pplied b|y the VM|
|000023f0| 2e 20 20 45 78 70 6f 72 | 74 73 20 74 68 65 20 6d |.  Expor|ts the m|
|00002400| 65 63 68 61 6e 69 73 6d | 73 20 75 73 65 64 20 66 |echanism|s used f|
|00002410| 6f 72 20 64 65 66 69 6e | 69 6e 67 20 74 68 65 0a |or defin|ing the.|
|00002420| 56 4d 2e 20 20 41 6c 6c | 20 74 68 65 20 56 4d 2d |VM.  All| the VM-|
|00002430| 69 6e 64 65 70 65 6e 64 | 65 6e 74 20 63 6f 64 65 |independ|ent code|
|00002440| 20 69 6e 20 74 68 65 20 | 63 6f 6d 70 69 6c 65 72 | in the |compiler|
|00002450| 2c 20 70 61 72 74 69 61 | 6c 6c 79 20 68 69 64 69 |, partia|lly hidi|
|00002460| 6e 67 20 74 68 65 20 63 | 6f 6d 70 69 6c 65 72 0a |ng the c|ompiler.|
|00002470| 69 6e 74 65 72 6d 65 64 | 69 61 74 65 20 72 65 70 |intermed|iate rep|
|00002480| 72 65 73 65 6e 74 61 74 | 69 6f 6e 73 2e 20 20 55 |resentat|ions.  U|
|00002490| 73 65 73 20 4b 45 52 4e | 45 4c 2e 0a 0a 5c 69 74 |ses KERN|EL...\it|
|000024a0| 65 6d 5b 65 76 61 6c 5d | 20 68 6f 6c 64 73 20 63 |em[eval]| holds c|
|000024b0| 6f 64 65 20 74 68 61 74 | 20 64 6f 65 73 20 64 69 |ode that| does di|
|000024c0| 72 65 63 74 20 65 78 65 | 63 75 74 69 6f 6e 20 6f |rect exe|cution o|
|000024d0| 66 20 74 68 65 20 63 6f | 6d 70 69 6c 65 72 27 73 |f the co|mpiler's|
|000024e0| 20 49 43 52 2e 20 20 55 | 73 65 73 0a 4b 45 52 4e | ICR.  U|ses.KERN|
|000024f0| 45 4c 2c 20 43 4f 4d 50 | 49 4c 45 52 2e 20 20 45 |EL, COMP|ILER.  E|
|00002500| 78 70 6f 72 74 73 20 64 | 65 62 75 67 67 65 72 20 |xports d|ebugger |
|00002510| 69 6e 74 65 72 66 61 63 | 65 20 74 6f 20 69 6e 74 |interfac|e to int|
|00002520| 65 72 70 72 65 74 65 64 | 20 63 6f 64 65 2e 0a 0a |erpreted| code...|
|00002530| 5c 69 74 65 6d 5b 64 65 | 62 75 67 2d 69 6e 74 65 |\item[de|bug-inte|
|00002540| 72 6e 61 6c 73 5d 20 70 | 72 65 73 65 6e 74 73 20 |rnals] p|resents |
|00002550| 61 20 72 65 61 73 6f 6e | 61 62 6c 65 2c 20 75 6e |a reason|able, un|
|00002560| 69 66 69 65 64 20 69 6e | 74 65 72 66 61 63 65 20 |ified in|terface |
|00002570| 74 6f 0a 6d 61 6e 69 70 | 75 6c 61 74 69 6f 6e 20 |to.manip|ulation |
|00002580| 6f 66 20 74 68 65 20 73 | 74 61 74 65 20 6f 66 20 |of the s|tate of |
|00002590| 62 6f 74 68 20 63 6f 6d | 70 69 6c 65 64 20 61 6e |both com|piled an|
|000025a0| 64 20 69 6e 74 65 72 70 | 72 65 74 65 64 20 63 6f |d interp|reted co|
|000025b0| 64 65 2e 20 20 28 63 6f | 75 6c 64 20 62 65 20 69 |de.  (co|uld be i|
|000025c0| 6e 0a 4b 45 52 4e 45 4c | 29 20 55 73 65 73 20 56 |n.KERNEL|) Uses V|
|000025d0| 4d 2c 20 49 4e 54 45 52 | 50 52 45 54 45 52 2c 20 |M, INTER|PRETER, |
|000025e0| 45 56 41 4c 2c 20 4b 45 | 52 4e 45 4c 2e 0a 0a 5c |EVAL, KE|RNEL...\|
|000025f0| 69 74 65 6d 5b 64 65 62 | 75 67 5d 20 68 6f 6c 64 |item[deb|ug] hold|
|00002600| 73 20 74 68 65 20 73 74 | 61 6e 64 61 72 64 20 64 |s the st|andard d|
|00002610| 65 62 75 67 67 65 72 2c | 20 61 6e 64 20 65 78 70 |ebugger,| and exp|
|00002620| 6f 72 74 73 20 74 68 65 | 20 64 65 62 75 67 67 65 |orts the| debugge|
|00002630| 72 20 0a 5c 65 6e 64 7b | 64 65 73 63 72 69 70 74 |r .\end{|descript|
|00002640| 69 6f 6e 7d 0a 0a 5c 63 | 68 61 70 74 65 72 7b 53 |ion}..\c|hapter{S|
|00002650| 79 73 74 65 6d 20 42 75 | 69 6c 64 69 6e 67 7d 0a |ystem Bu|ilding}.|
|00002660| 0a 49 74 27 73 20 61 63 | 74 75 61 6c 6c 79 20 72 |.It's ac|tually r|
|00002670| 61 74 68 65 72 20 65 61 | 73 79 20 74 6f 20 62 75 |ather ea|sy to bu|
|00002680| 69 6c 64 20 61 20 43 4d | 55 20 43 4c 20 63 6f 72 |ild a CM|U CL cor|
|00002690| 65 20 77 69 74 68 20 65 | 78 61 63 74 6c 79 20 77 |e with e|xactly w|
|000026a0| 68 61 74 20 79 6f 75 20 | 77 61 6e 74 20 69 6e 0a |hat you |want in.|
|000026b0| 69 74 2e 20 20 42 75 74 | 20 74 6f 20 64 6f 20 74 |it.  But| to do t|
|000026c0| 68 69 73 20 79 6f 75 20 | 6e 65 65 64 20 74 77 6f |his you |need two|
|000026d0| 20 74 68 69 6e 67 73 3a | 20 74 68 65 20 73 6f 75 | things:| the sou|
|000026e0| 72 63 65 20 61 6e 64 20 | 61 20 77 6f 72 6b 69 6e |rce and |a workin|
|000026f0| 67 20 43 4d 55 20 43 4c | 2e 0a 0a 42 61 73 69 63 |g CMU CL|...Basic|
|00002700| 61 6c 6c 79 2c 20 79 6f | 75 20 75 73 65 20 74 68 |ally, yo|u use th|
|00002710| 65 20 77 6f 72 6b 69 6e | 67 20 63 6f 70 79 20 6f |e workin|g copy o|
|00002720| 66 20 43 4d 55 20 43 4c | 20 74 6f 20 63 6f 6d 70 |f CMU CL| to comp|
|00002730| 69 6c 65 20 74 68 65 20 | 73 6f 75 72 63 65 73 2c |ile the |sources,|
|00002740| 0a 74 68 65 6e 20 72 75 | 6e 20 61 20 70 72 6f 63 |.then ru|n a proc|
|00002750| 65 73 73 20 63 61 6c 6c | 20 60 60 67 65 6e 65 73 |ess call| ``genes|
|00002760| 69 73 27 27 20 77 68 69 | 63 68 20 62 75 69 6c 64 |is'' whi|ch build|
|00002770| 73 20 61 20 60 60 6b 65 | 72 6e 65 6c 27 27 20 63 |s a ``ke|rnel'' c|
|00002780| 6f 72 65 2e 0a 59 6f 75 | 20 74 68 65 6e 20 6c 6f |ore..You| then lo|
|00002790| 61 64 20 77 68 61 74 65 | 76 65 72 20 79 6f 75 20 |ad whate|ver you |
|000027a0| 77 61 6e 74 20 69 6e 74 | 6f 20 74 68 69 73 20 6b |want int|o this k|
|000027b0| 65 72 6e 65 6c 20 63 6f | 72 65 2c 20 61 6e 64 20 |ernel co|re, and |
|000027c0| 73 61 76 65 20 69 74 2e | 0a 0a 49 6e 20 74 68 65 |save it.|..In the|
|000027d0| 20 5c 76 65 72 62 7c 74 | 6f 6f 6c 73 2f 7c 20 64 | \verb|t|ools/| d|
|000027e0| 69 72 65 63 74 6f 72 79 | 20 69 6e 20 74 68 65 20 |irectory| in the |
|000027f0| 73 6f 75 72 63 65 73 20 | 74 68 65 72 65 20 61 72 |sources |there ar|
|00002800| 65 20 73 65 76 65 72 61 | 6c 20 66 69 6c 65 73 20 |e severa|l files |
|00002810| 74 68 61 74 0a 63 6f 6d | 70 69 6c 65 20 65 76 65 |that.com|pile eve|
|00002820| 72 79 74 68 69 6e 67 2c | 20 61 6e 64 20 62 75 69 |rything,| and bui|
|00002830| 6c 64 20 63 6f 72 65 73 | 2c 20 65 74 63 2e 20 20 |ld cores|, etc.  |
|00002840| 54 68 65 20 66 69 72 73 | 74 20 73 74 65 70 20 69 |The firs|t step i|
|00002850| 73 20 74 6f 20 63 6f 6d | 70 69 6c 65 20 74 68 65 |s to com|pile the|
|00002860| 20 43 0a 73 74 61 72 74 | 75 70 20 63 6f 64 65 2e | C.start|up code.|
|00002870| 0a 0a 7b 5c 62 66 20 4e | 6f 74 65 3a 7d 20 7b 5c |..{\bf N|ote:} {\|
|00002880| 69 74 20 74 68 65 20 76 | 61 72 69 6f 75 73 20 73 |it the v|arious s|
|00002890| 63 72 69 70 74 73 20 6d | 65 6e 74 69 6f 6e 65 64 |cripts m|entioned|
|000028a0| 20 62 65 6c 6f 77 20 68 | 61 76 65 20 68 61 72 64 | below h|ave hard|
|000028b0| 2d 77 69 72 65 64 20 70 | 61 74 68 73 20 69 6e 0a |-wired p|aths in.|
|000028c0| 74 68 65 6d 20 73 65 74 | 20 75 70 20 66 6f 72 20 |them set| up for |
|000028d0| 6f 75 72 20 64 69 72 65 | 63 74 6f 72 79 20 6c 61 |our dire|ctory la|
|000028e0| 79 6f 75 74 20 68 65 72 | 65 20 61 74 20 43 4d 55 |yout her|e at CMU|
|000028f0| 2e 20 20 41 6e 79 6f 6e | 65 20 61 6e 79 77 68 65 |.  Anyon|e anywhe|
|00002900| 72 65 20 65 6c 73 65 20 | 77 69 6c 6c 0a 68 61 76 |re else |will.hav|
|00002910| 65 20 74 6f 20 65 64 69 | 74 20 74 68 65 6d 20 62 |e to edi|t them b|
|00002920| 65 66 6f 72 65 20 74 68 | 65 79 20 77 69 6c 6c 20 |efore th|ey will |
|00002930| 77 6f 72 6b 2e 7d 0a 0a | 5c 73 65 63 74 69 6f 6e |work.}..|\section|
|00002940| 7b 43 6f 6d 70 69 6c 69 | 6e 67 20 74 68 65 20 43 |{Compili|ng the C|
|00002950| 20 53 74 61 72 74 75 70 | 20 43 6f 64 65 7d 0a 0a | Startup| Code}..|
|00002960| 54 68 65 72 65 20 69 73 | 20 61 20 63 69 72 63 75 |There is| a circu|
|00002970| 6c 61 72 20 64 65 70 65 | 6e 64 61 6e 63 79 20 62 |lar depe|ndancy b|
|00002980| 65 74 77 65 65 6e 20 6c | 64 62 2f 6c 69 73 70 2e |etween l|db/lisp.|
|00002990| 68 20 61 6e 64 20 6c 64 | 62 2f 6c 64 62 2e 6d 61 |h and ld|b/ldb.ma|
|000029a0| 70 20 74 68 61 74 20 63 | 61 75 73 65 73 0a 62 6f |p that c|auses.bo|
|000029b0| 6f 74 73 74 72 61 70 70 | 69 6e 67 20 70 72 6f 62 |otstrapp|ing prob|
|000029c0| 6c 65 6d 73 2e 20 20 54 | 6f 20 74 68 65 20 65 61 |lems.  T|o the ea|
|000029d0| 73 69 65 73 74 20 77 61 | 79 20 74 6f 20 67 65 74 |siest wa|y to get|
|000029e0| 20 61 72 6f 75 6e 64 20 | 74 68 69 73 20 70 72 6f | around |this pro|
|000029f0| 62 6c 65 6d 20 69 73 20 | 74 6f 0a 6d 61 6b 65 20 |blem is |to.make |
|00002a00| 61 20 66 61 6b 65 20 6c | 64 62 2e 6d 61 70 20 66 |a fake l|db.map f|
|00002a10| 69 6c 65 20 74 68 61 74 | 20 68 61 73 20 6e 6f 74 |ile that| has not|
|00002a20| 68 69 6e 67 20 69 6e 20 | 69 74 20 62 79 20 61 20 |hing in |it by a |
|00002a30| 76 65 72 73 69 6f 6e 20 | 6e 75 6d 62 65 72 3a 0a |version |number:.|
|00002a40| 5c 62 65 67 69 6e 7b 76 | 65 72 62 61 74 69 6d 7d |\begin{v|erbatim}|
|00002a50| 0a 09 25 20 65 63 68 6f | 20 22 4d 61 70 20 66 69 |..% echo| "Map fi|
|00002a60| 6c 65 20 66 6f 72 20 6c | 64 62 20 76 65 72 73 69 |le for l|db versi|
|00002a70| 6f 6e 20 30 22 20 3e 20 | 6c 64 62 2e 6d 61 70 0a |on 0" > |ldb.map.|
|00002a80| 5c 65 6e 64 7b 76 65 72 | 62 61 74 69 6d 7d 0a 61 |\end{ver|batim}.a|
|00002a90| 6e 64 20 74 68 65 6e 20 | 72 75 6e 20 67 65 6e 65 |nd then |run gene|
|00002aa0| 73 69 73 20 77 69 74 68 | 20 4e 49 4c 20 66 6f 72 |sis with| NIL for|
|00002ab0| 20 74 68 65 20 6c 69 73 | 74 20 6f 66 20 66 69 6c | the lis|t of fil|
|00002ac0| 65 73 3a 0a 5c 62 65 67 | 69 6e 7b 76 65 72 62 61 |es:.\beg|in{verba|
|00002ad0| 74 69 6d 7d 0a 09 2a 20 | 28 6c 6f 61 64 20 22 2e |tim}..* |(load ".|
|00002ae0| 2e 2e 2f 63 6f 6d 70 69 | 6c 65 72 2f 67 65 6e 65 |../compi|ler/gene|
|00002af0| 72 69 63 2f 67 65 6e 65 | 73 69 73 22 29 0a 09 2a |ric/gene|sis")..*|
|00002b00| 20 28 6c 69 73 70 3a 3a | 67 65 6e 65 73 69 73 20 | (lisp::|genesis |
|00002b10| 6e 69 6c 20 22 2e 2e 2e | 2f 6c 64 62 2f 6c 64 62 |nil "...|/ldb/ldb|
|00002b20| 2e 6d 61 70 22 20 22 2f | 64 65 76 2f 6e 75 6c 6c |.map" "/|dev/null|
|00002b30| 22 0a 09 09 22 2e 2e 2e | 2f 6c 64 62 2f 6c 69 73 |"..."...|/ldb/lis|
|00002b40| 70 2e 6d 61 70 22 20 22 | 2e 2e 2e 2f 6c 64 62 2f |p.map" "|.../ldb/|
|00002b50| 6c 69 73 70 2e 68 22 29 | 0a 5c 65 6e 64 7b 76 65 |lisp.h")|.\end{ve|
|00002b60| 72 62 61 74 69 6d 7d 0a | 49 74 20 77 69 6c 6c 20 |rbatim}.|It will |
|00002b70| 67 65 6e 65 72 61 74 65 | 0a 61 20 77 68 6f 6c 65 |generate|.a whole|
|00002b80| 20 62 75 6e 63 68 20 6f | 66 20 77 61 72 6e 69 6e | bunch o|f warnin|
|00002b90| 67 73 20 61 62 6f 75 74 | 20 74 68 69 6e 67 73 20 |gs about| things |
|00002ba0| 62 65 69 6e 67 20 75 6e | 64 65 66 69 6e 65 64 2c |being un|defined,|
|00002bb0| 20 62 75 74 20 69 67 6e | 6f 72 65 0a 74 68 61 74 | but ign|ore.that|
|00002bc0| 2c 20 62 65 63 61 75 73 | 65 20 69 74 20 77 69 6c |, becaus|e it wil|
|00002bd0| 6c 20 61 6c 73 6f 20 67 | 65 6e 65 72 61 74 65 20 |l also g|enerate |
|00002be0| 61 20 63 6f 72 72 65 63 | 74 20 6c 69 73 70 2e 68 |a correc|t lisp.h|
|00002bf0| 2e 20 20 59 6f 75 20 63 | 61 6e 20 74 68 65 6e 0a |.  You c|an then.|
|00002c00| 63 6f 6d 70 69 6c 65 20 | 6c 64 62 20 70 72 6f 64 |compile |ldb prod|
|00002c10| 75 63 69 6e 67 20 61 20 | 63 6f 72 72 65 63 74 20 |ucing a |correct |
|00002c20| 6c 64 62 2e 6d 61 70 3a | 0a 5c 62 65 67 69 6e 7b |ldb.map:|.\begin{|
|00002c30| 76 65 72 62 61 74 69 6d | 7d 0a 09 25 20 6d 61 6b |verbatim|}..% mak|
|00002c40| 65 0a 5c 65 6e 64 7b 76 | 65 72 62 61 74 69 6d 7d |e.\end{v|erbatim}|
|00002c50| 0a 61 6e 64 20 74 68 65 | 20 75 73 65 20 5c 76 65 |.and the| use \ve|
|00002c60| 72 62 7c 74 6f 6f 6c 73 | 2f 64 6f 2d 77 6f 72 6c |rb|tools|/do-worl|
|00002c70| 64 62 75 69 6c 64 7c 20 | 61 6e 64 20 5c 76 65 72 |dbuild| |and \ver|
|00002c80| 62 7c 74 6f 6f 6c 73 2f | 6d 6b 2d 6c 69 73 70 7c |b|tools/|mk-lisp||
|00002c90| 20 74 6f 20 62 75 69 6c | 64 0a 5c 76 65 72 62 7c | to buil|d.\verb||
|00002ca0| 6b 65 72 6e 65 6c 2e 63 | 6f 72 65 7c 20 61 6e 64 |kernel.c|ore| and|
|00002cb0| 20 5c 76 65 72 62 7c 6c | 69 73 70 2e 63 6f 72 65 | \verb|l|isp.core|
|00002cc0| 7c 20 28 73 65 65 20 73 | 65 63 74 69 6f 6e 20 5c || (see s|ection \|
|00002cd0| 72 65 66 5b 62 75 69 6c | 64 69 6e 67 2d 63 6f 72 |ref[buil|ding-cor|
|00002ce0| 65 73 5d 2e 29 0a 0a 5c | 73 65 63 74 69 6f 6e 7b |es].)..\|section{|
|00002cf0| 43 6f 6d 70 69 6c 69 6e | 67 20 74 68 65 20 4c 69 |Compilin|g the Li|
|00002d00| 73 70 20 43 6f 64 65 7d | 0a 0a 54 68 65 20 5c 76 |sp Code}|..The \v|
|00002d10| 65 72 62 7c 74 6f 6f 6c | 73 7c 20 64 69 72 65 63 |erb|tool|s| direc|
|00002d20| 74 6f 72 79 20 63 6f 6e | 74 61 69 6e 73 20 76 61 |tory con|tains va|
|00002d30| 72 69 6f 75 73 20 6c 69 | 73 70 20 61 6e 64 20 43 |rious li|sp and C|
|00002d40| 2d 73 68 65 6c 6c 20 75 | 74 69 6c 69 74 69 65 73 |-shell u|tilities|
|00002d50| 20 66 6f 72 0a 62 75 69 | 6c 64 69 6e 67 20 43 4d | for.bui|lding CM|
|00002d60| 55 20 43 4c 3a 0a 5c 62 | 65 67 69 6e 7b 64 65 73 |U CL:.\b|egin{des|
|00002d70| 63 72 69 70 74 69 6f 6e | 7d 0a 5c 69 74 65 6d 5b |cription|}.\item[|
|00002d80| 63 6f 6d 70 69 6c 65 2d | 61 6c 6c 2a 5d 20 57 69 |compile-|all*] Wi|
|00002d90| 6c 6c 20 63 6f 6d 70 69 | 6c 65 20 6c 69 73 70 20 |ll compi|le lisp |
|00002da0| 66 69 6c 65 73 20 61 6e | 64 20 62 75 69 6c 64 20 |files an|d build |
|00002db0| 61 20 6b 65 72 6e 65 6c | 20 63 6f 72 65 2e 20 20 |a kernel| core.  |
|00002dc0| 49 74 20 68 61 73 0a 6e | 75 6d 65 72 6f 75 73 20 |It has.n|umerous |
|00002dd0| 63 6f 6d 6d 61 6e 64 2d | 6c 69 6e 65 20 6f 70 74 |command-|line opt|
|00002de0| 69 6f 6e 73 20 74 6f 20 | 63 6f 6e 74 72 6f 6c 20 |ions to |control |
|00002df0| 77 68 61 74 20 74 6f 20 | 63 6f 6d 70 69 6c 65 20 |what to |compile |
|00002e00| 61 6e 64 20 68 6f 77 2e | 20 20 54 72 79 20 2d 68 |and how.|  Try -h|
|00002e10| 65 6c 70 20 74 6f 0a 73 | 65 65 20 61 20 64 65 73 |elp to.s|ee a des|
|00002e20| 63 72 69 70 74 69 6f 6e | 2e 20 20 49 74 20 72 75 |cription|.  It ru|
|00002e30| 6e 73 20 61 20 73 65 70 | 61 72 61 74 65 20 4c 69 |ns a sep|arate Li|
|00002e40| 73 70 20 70 72 6f 63 65 | 73 73 20 74 6f 20 63 6f |sp proce|ss to co|
|00002e50| 6d 70 69 6c 65 20 65 61 | 63 68 0a 73 75 62 73 79 |mpile ea|ch.subsy|
|00002e60| 73 74 65 6d 2e 20 20 45 | 72 72 6f 72 20 6f 75 74 |stem.  E|rror out|
|00002e70| 70 75 74 20 69 73 20 67 | 65 6e 65 72 61 74 65 64 |put is g|enerated|
|00002e80| 20 69 6e 20 66 69 6c 65 | 73 20 77 69 74 68 20 60 | in file|s with `|
|00002e90| 60 7b 5c 74 74 20 2e 6c | 6f 67 7d 27 27 20 65 78 |`{\tt .l|og}'' ex|
|00002ea0| 74 65 6e 73 69 6f 6e 20 | 69 6e 0a 74 68 65 20 72 |tension |in.the r|
|00002eb0| 6f 6f 74 20 6f 66 20 74 | 68 65 20 62 75 69 6c 64 |oot of t|he build|
|00002ec0| 20 61 72 65 61 2e 0a 0a | 5c 69 74 65 6d 5b 73 65 | area...|\item[se|
|00002ed0| 74 75 70 2e 6c 69 73 70 | 5d 20 53 6f 6d 65 20 6c |tup.lisp|] Some l|
|00002ee0| 69 73 70 20 75 74 69 6c | 69 74 69 65 73 20 75 73 |isp util|ities us|
|00002ef0| 65 64 20 66 6f 72 20 63 | 6f 6d 70 69 6c 69 6e 67 |ed for c|ompiling|
|00002f00| 20 63 68 61 6e 67 65 64 | 20 66 69 6c 65 73 20 69 | changed| files i|
|00002f10| 6e 20 62 61 74 63 68 0a | 6d 6f 64 65 20 61 6e 64 |n batch.|mode and|
|00002f20| 20 63 6f 6c 6c 65 63 74 | 69 6e 67 20 74 68 65 20 | collect|ing the |
|00002f30| 65 72 72 6f 72 20 6f 75 | 74 70 75 74 20 53 6f 72 |error ou|tput Sor|
|00002f40| 74 20 6f 66 20 61 20 63 | 72 75 64 65 20 64 65 66 |t of a c|rude def|
|00002f50| 73 79 73 74 65 6d 2e 20 | 20 4c 6f 61 64 73 20 69 |system. | Loads i|
|00002f60| 6e 74 6f 20 74 68 65 0a | 60 60 75 73 65 72 27 27 |nto the.|``user''|
|00002f70| 20 70 61 63 6b 61 67 65 | 2e 20 20 53 65 65 20 7b | package|.  See {|
|00002f80| 5c 74 74 20 77 69 74 68 | 2d 63 6f 6d 70 69 6c 65 |\tt with|-compile|
|00002f90| 72 2d 6c 6f 67 2d 66 69 | 6c 65 7d 20 61 6e 64 20 |r-log-fi|le} and |
|00002fa0| 7b 5c 74 74 20 63 6f 6d | 66 7d 2e 0a 0a 5c 69 74 |{\tt com|f}...\it|
|00002fb0| 65 6d 5b 7b 5c 69 74 20 | 66 6f 6f 7d 63 6f 6d 2e |em[{\it |foo}com.|
|00002fc0| 6c 69 73 70 5d 20 45 61 | 63 68 20 73 79 73 74 65 |lisp] Ea|ch syste|
|00002fd0| 6d 20 68 61 73 20 61 20 | 60 60 5c 76 65 72 62 7c |m has a |``\verb||
|00002fe0| 2e 6c 69 73 70 7c 27 27 | 20 66 69 6c 65 20 69 6e |.lisp|''| file in|
|00002ff0| 0a 5c 76 65 72 62 7c 74 | 6f 6f 6c 73 2f 7c 20 77 |.\verb|t|ools/| w|
|00003000| 68 69 63 68 20 63 6f 6d | 70 69 6c 65 73 20 74 68 |hich com|piles th|
|00003010| 61 74 20 73 79 73 74 65 | 6d 2e 0a 5c 65 6e 64 7b |at syste|m..\end{|
|00003020| 64 65 73 63 72 69 70 74 | 69 6f 6e 7d 0a 0a 5c 73 |descript|ion}..\s|
|00003030| 65 63 74 69 6f 6e 7b 42 | 75 69 6c 64 69 6e 67 20 |ection{B|uilding |
|00003040| 43 6f 72 65 20 49 6d 61 | 67 65 73 7d 0a 5c 6c 61 |Core Ima|ges}.\la|
|00003050| 62 65 6c 7b 62 75 69 6c | 64 69 6e 67 2d 63 6f 72 |bel{buil|ding-cor|
|00003060| 65 73 7d 0a 42 6f 74 68 | 20 74 68 65 20 6b 65 72 |es}.Both| the ker|
|00003070| 6e 65 6c 20 61 6e 64 20 | 66 69 6e 61 6c 20 63 6f |nel and |final co|
|00003080| 72 65 20 62 75 69 6c 64 | 20 61 72 65 20 6e 6f 72 |re build| are nor|
|00003090| 6d 61 6c 6c 79 20 64 6f | 6e 65 20 75 73 69 6e 67 |mally do|ne using|
|000030a0| 20 73 68 65 6c 6c 20 73 | 63 72 69 70 74 0a 64 72 | shell s|cript.dr|
|000030b0| 69 76 65 72 73 3a 0a 5c | 62 65 67 69 6e 7b 64 65 |ivers:.\|begin{de|
|000030c0| 73 63 72 69 70 74 69 6f | 6e 7d 0a 5c 69 74 65 6d |scriptio|n}.\item|
|000030d0| 5b 64 6f 2d 77 6f 72 6c | 64 62 75 69 6c 64 2a 5d |[do-worl|dbuild*]|
|000030e0| 20 42 75 69 6c 64 73 20 | 61 20 6b 65 72 6e 65 6c | Builds |a kernel|
|000030f0| 20 63 6f 72 65 20 66 6f | 72 20 74 68 65 20 63 75 | core fo|r the cu|
|00003100| 72 72 65 6e 74 20 6d 61 | 63 68 69 6e 65 2e 20 20 |rrent ma|chine.  |
|00003110| 54 68 65 0a 76 65 72 73 | 69 6f 6e 20 74 6f 20 62 |The.vers|ion to b|
|00003120| 75 69 6c 64 20 69 73 20 | 69 6e 64 69 63 61 74 65 |uild is |indicate|
|00003130| 64 20 62 79 20 61 6e 20 | 6f 70 74 69 6f 6e 61 6c |d by an |optional|
|00003140| 20 61 72 67 75 6d 65 6e | 74 2c 20 77 68 69 63 68 | argumen|t, which|
|00003150| 20 64 65 66 61 75 6c 74 | 73 20 74 6f 0a 60 60 61 | default|s to.``a|
|00003160| 6c 70 68 61 27 27 2e 20 | 20 54 68 65 20 5c 76 65 |lpha''. | The \ve|
|00003170| 72 62 7c 6b 65 72 6e 65 | 6c 2e 63 6f 72 65 7c 20 |rb|kerne|l.core| |
|00003180| 66 69 6c 65 20 69 73 20 | 77 72 69 74 74 65 6e 20 |file is |written |
|00003190| 65 69 74 68 65 72 20 69 | 6e 20 74 68 65 20 5c 76 |either i|n the \v|
|000031a0| 65 72 62 7c 6c 64 62 2f | 7c 0a 64 69 72 65 63 74 |erb|ldb/||.direct|
|000031b0| 6f 72 79 20 69 6e 20 74 | 68 65 20 62 75 69 6c 64 |ory in t|he build|
|000031c0| 20 61 72 65 61 2c 20 6f | 72 20 69 6e 20 5c 76 65 | area, o|r in \ve|
|000031d0| 72 62 7c 2f 75 73 72 2f | 74 6d 70 2f 7c 2e 20 20 |rb|/usr/|tmp/|.  |
|000031e0| 54 68 65 20 64 69 72 65 | 63 74 6f 72 79 20 77 68 |The dire|ctory wh|
|000031f0| 69 63 68 0a 61 6c 72 65 | 61 64 79 20 63 6f 6e 74 |ich.alre|ady cont|
|00003200| 61 69 6e 73 20 5c 76 65 | 72 62 7c 6b 65 72 6e 65 |ains \ve|rb|kerne|
|00003210| 6c 2e 63 6f 72 65 7c 20 | 69 73 20 63 68 6f 73 65 |l.core| |is chose|
|00003220| 6e 2e 20 20 59 6f 75 20 | 63 61 6e 20 63 72 65 61 |n.  You |can crea|
|00003230| 74 65 20 61 20 64 75 6d | 6d 79 20 76 65 72 73 69 |te a dum|my versi|
|00003240| 6f 6e 0a 77 69 74 68 20 | 65 2e 67 2e 20 60 60 74 |on.with |e.g. ``t|
|00003250| 6f 75 63 68 27 27 20 74 | 6f 20 73 65 6c 65 63 74 |ouch'' t|o select|
|00003260| 20 74 68 65 20 69 6e 69 | 74 69 61 6c 20 62 75 69 | the ini|tial bui|
|00003270| 6c 64 20 6c 6f 63 61 74 | 69 6f 6e 2e 0a 0a 5c 69 |ld locat|ion...\i|
|00003280| 74 65 6d 5b 6d 6b 2d 6c | 69 73 70 2a 5d 20 42 75 |tem[mk-l|isp*] Bu|
|00003290| 69 6c 64 73 20 61 20 66 | 75 6c 6c 20 63 6f 72 65 |ilds a f|ull core|
|000032a0| 2c 20 77 69 74 68 20 63 | 6f 6e 64 69 74 69 6f 6e |, with c|ondition|
|000032b0| 61 6c 20 6c 6f 61 64 69 | 6e 67 20 6f 66 20 73 75 |al loadi|ng of su|
|000032c0| 62 73 79 73 74 65 6d 73 | 2e 0a 54 68 65 20 76 65 |bsystems|..The ve|
|000032d0| 72 73 69 6f 6e 20 69 73 | 20 74 68 65 20 66 69 72 |rsion is| the fir|
|000032e0| 73 74 20 61 72 67 75 6d | 65 6e 74 2c 20 77 68 69 |st argum|ent, whi|
|000032f0| 63 68 20 64 65 66 61 75 | 6c 74 73 20 74 6f 20 60 |ch defau|lts to `|
|00003300| 60 61 6c 70 68 61 27 27 | 2e 20 20 41 6e 79 20 61 |`alpha''|.  Any a|
|00003310| 64 64 69 74 69 6f 6e 61 | 6c 0a 61 72 67 75 6d 65 |dditiona|l.argume|
|00003320| 6e 74 73 20 61 72 65 20 | 61 64 64 65 64 20 74 6f |nts are |added to|
|00003330| 20 74 68 65 20 5c 76 65 | 72 62 7c 2a 66 65 61 74 | the \ve|rb|*feat|
|00003340| 75 72 65 73 2a 7c 20 6c | 69 73 74 2c 20 77 68 69 |ures*| l|ist, whi|
|00003350| 63 68 20 63 6f 6e 74 72 | 6f 6c 73 20 73 79 73 74 |ch contr|ols syst|
|00003360| 65 6d 0a 6c 6f 61 64 69 | 6e 67 20 28 61 6d 6f 6e |em.loadi|ng (amon|
|00003370| 67 20 6f 74 68 65 72 20 | 74 68 69 6e 67 73 2e 29 |g other |things.)|
|00003380| 20 20 54 68 65 20 5c 76 | 65 72 62 7c 6c 69 73 70 |  The \v|erb|lisp|
|00003390| 2e 63 6f 72 65 7c 20 66 | 69 6c 65 20 69 73 20 77 |.core| f|ile is w|
|000033a0| 72 69 74 74 65 6e 20 69 | 6e 20 74 68 65 0a 63 75 |ritten i|n the.cu|
|000033b0| 72 72 65 6e 74 20 77 6f | 72 6b 69 6e 67 20 64 69 |rrent wo|rking di|
|000033c0| 72 65 63 74 6f 72 79 2e | 0a 5c 65 6e 64 7b 64 65 |rectory.|.\end{de|
|000033d0| 73 63 72 69 70 74 69 6f | 6e 7d 0a 0a 54 68 65 73 |scriptio|n}..Thes|
|000033e0| 65 20 73 63 72 69 70 74 | 73 20 6c 6f 61 64 20 4c |e script|s load L|
|000033f0| 69 73 70 20 63 6f 6d 6d | 61 6e 64 20 66 69 6c 65 |isp comm|and file|
|00003400| 73 2e 20 20 57 68 65 6e | 20 5c 76 65 72 62 7c 74 |s.  When| \verb|t|
|00003410| 6f 6f 6c 73 2f 77 6f 72 | 6c 64 62 75 69 6c 64 2e |ools/wor|ldbuild.|
|00003420| 6c 69 73 70 7c 20 69 73 | 0a 6c 6f 61 64 65 64 2c |lisp| is|.loaded,|
|00003430| 20 69 74 20 63 61 6c 6c | 73 20 67 65 6e 65 73 69 | it call|s genesi|
|00003440| 73 20 77 69 74 68 20 74 | 68 65 20 63 6f 72 72 65 |s with t|he corre|
|00003450| 63 74 20 61 72 67 75 6d | 65 6e 74 73 20 74 6f 20 |ct argum|ents to |
|00003460| 62 75 69 6c 64 20 61 20 | 6b 65 72 6e 65 6c 20 63 |build a |kernel c|
|00003470| 6f 72 65 2e 0a 53 69 6d | 69 6c 61 72 6c 79 2c 20 |ore..Sim|ilarly, |
|00003480| 5c 76 65 72 62 7c 77 6f | 72 6c 64 6c 6f 61 64 2e |\verb|wo|rldload.|
|00003490| 6c 69 73 70 7c 0a 62 75 | 69 6c 64 73 20 61 20 66 |lisp|.bu|ilds a f|
|000034a0| 75 6c 6c 20 63 6f 72 65 | 2e 20 20 41 64 64 69 6e |ull core|.  Addin|
|000034b0| 67 20 63 65 72 74 61 69 | 6e 20 73 79 6d 62 6f 6c |g certai|n symbol|
|000034c0| 73 20 74 6f 20 5c 76 65 | 72 62 7c 2a 66 65 61 74 |s to \ve|rb|*feat|
|000034d0| 75 72 65 73 2a 7c 20 62 | 65 66 6f 72 65 0a 6c 6f |ures*| b|efore.lo|
|000034e0| 61 64 69 6e 67 20 77 6f | 72 6c 64 6c 6f 61 64 2e |ading wo|rldload.|
|000034f0| 6c 69 73 70 20 73 75 70 | 70 72 65 73 73 65 73 20 |lisp sup|presses |
|00003500| 6c 6f 61 64 69 6e 67 20 | 6f 66 20 64 69 66 66 65 |loading |of diffe|
|00003510| 72 65 6e 74 20 70 61 72 | 74 73 20 6f 66 20 74 68 |rent par|ts of th|
|00003520| 65 0a 73 79 73 74 65 6d | 2e 20 20 54 68 65 73 65 |e.system|.  These|
|00003530| 20 73 79 6d 62 6f 6c 73 | 20 61 72 65 3a 0a 5c 62 | symbols| are:.\b|
|00003540| 65 67 69 6e 7b 64 65 73 | 63 72 69 70 74 69 6f 6e |egin{des|cription|
|00003550| 7d 0a 5c 69 74 65 6d 5b | 3a 6e 6f 2d 63 6f 6d 70 |}.\item[|:no-comp|
|00003560| 69 6c 65 72 5d 20 64 6f | 6e 27 74 20 6c 6f 61 64 |iler] do|n't load|
|00003570| 20 74 68 65 20 63 6f 6d | 70 69 6c 65 72 2e 0a 5c | the com|piler..\|
|00003580| 69 74 65 6d 5b 3a 6e 6f | 2d 63 6c 78 5d 20 64 6f |item[:no|-clx] do|
|00003590| 6e 27 74 20 6c 6f 61 64 | 20 43 4c 58 2e 0a 5c 69 |n't load| CLX..\i|
|000035a0| 74 65 6d 5b 3a 6e 6f 2d | 68 65 6d 6c 6f 63 6b 5d |tem[:no-|hemlock]|
|000035b0| 20 64 6f 6e 27 74 20 6c | 6f 61 64 20 68 65 6d 6c | don't l|oad heml|
|000035c0| 6f 63 6b 2e 0a 5c 69 74 | 65 6d 5b 3a 6e 6f 2d 70 |ock..\it|em[:no-p|
|000035d0| 63 6c 5d 20 64 6f 6e 27 | 74 20 6c 6f 61 64 20 50 |cl] don'|t load P|
|000035e0| 43 4c 2e 0a 5c 65 6e 64 | 7b 64 65 73 63 72 69 70 |CL..\end|{descrip|
|000035f0| 74 69 6f 6e 7d 0a 0a 4e | 6f 74 65 3a 20 69 66 20 |tion}..N|ote: if |
|00003600| 79 6f 75 20 64 6f 6e 27 | 74 20 6c 6f 61 64 20 74 |you don'|t load t|
|00003610| 68 65 20 63 6f 6d 70 69 | 6c 65 72 2c 20 79 6f 75 |he compi|ler, you|
|00003620| 20 63 61 6e 27 74 20 28 | 73 75 63 63 65 73 73 66 | can't (|successf|
|00003630| 75 6c 6c 79 29 20 6c 6f | 61 64 20 74 68 65 0a 70 |ully) lo|ad the.p|
|00003640| 72 65 74 74 79 2d 70 72 | 69 6e 74 65 72 20 6f 72 |retty-pr|inter or|
|00003650| 20 70 63 6c 2e 20 20 41 | 6e 64 20 69 66 20 79 6f | pcl.  A|nd if yo|
|00003660| 75 20 63 6f 6d 70 69 6c | 65 64 20 68 65 6d 6c 6f |u compil|ed hemlo|
|00003670| 63 6b 20 77 69 74 68 20 | 43 4c 58 20 6c 6f 61 64 |ck with |CLX load|
|00003680| 65 64 2c 20 79 6f 75 20 | 63 61 6e 27 74 0a 6c 6f |ed, you |can't.lo|
|00003690| 61 64 20 69 74 20 77 69 | 74 68 6f 75 74 20 43 4c |ad it wi|thout CL|
|000036a0| 58 20 61 6c 73 6f 20 62 | 65 69 6e 67 20 6c 6f 61 |X also b|eing loa|
|000036b0| 64 65 64 2e 0a          |                         |ded..   |        |
+--------+-------------------------+-------------------------+--------+--------+