/ NetNews Usenet Archive 1992 #26 / NN_1992_26.iso / spool / comp / lang / lisp / 2812

< prev

next >

MacOS 8.1

Win98

DOS

browse contents

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 50 61 74 68 3a 20 73 70 | 61 72 6b 79 21 75 75 6e |Path: sp|arky!uun|
|00000010| 65 74 21 68 65 6c 61 2e | 69 74 69 2e 6f 72 67 21 |et!hela.|iti.org!|
|00000020| 75 73 63 21 69 73 69 2e | 65 64 75 21 64 6f 6e 63 |usc!isi.|edu!donc|
|00000030| 0a 46 72 6f 6d 3a 20 64 | 6f 6e 63 40 69 73 69 2e |.From: d|onc@isi.|
|00000040| 65 64 75 20 28 44 6f 6e | 20 43 6f 68 65 6e 29 0a |edu (Don| Cohen).|
|00000050| 4e 65 77 73 67 72 6f 75 | 70 73 3a 20 63 6f 6d 70 |Newsgrou|ps: comp|
|00000060| 2e 6c 61 6e 67 2e 6c 69 | 73 70 0a 53 75 62 6a 65 |.lang.li|sp.Subje|
|00000070| 63 74 3a 20 52 65 3a 20 | 4c 69 73 70 20 57 45 42 |ct: Re: |Lisp WEB|
|00000080| 0a 4d 65 73 73 61 67 65 | 2d 49 44 3a 20 3c 32 32 |.Message|-ID: <22|
|00000090| 38 33 39 40 76 65 6e 65 | 72 61 2e 69 73 69 2e 65 |839@vene|ra.isi.e|
|000000a0| 64 75 3e 0a 44 61 74 65 | 3a 20 35 20 4e 6f 76 20 |du>.Date|: 5 Nov |
|000000b0| 39 32 20 31 37 3a 35 35 | 3a 31 32 20 47 4d 54 0a |92 17:55|:12 GMT.|
|000000c0| 52 65 66 65 72 65 6e 63 | 65 73 3a 20 3c 31 64 37 |Referenc|es: <1d7|
|000000d0| 76 63 63 49 4e 4e 68 33 | 64 40 6d 61 6e 75 65 6c |vccINNh3|d@manuel|
|000000e0| 2e 61 6e 75 2e 65 64 75 | 2e 61 75 3e 0a 53 65 6e |.anu.edu|.au>.Sen|
|000000f0| 64 65 72 3a 20 6e 65 77 | 73 40 69 73 69 2e 65 64 |der: new|s@isi.ed|
|00000100| 75 0a 52 65 70 6c 79 2d | 54 6f 3a 20 64 6f 6e 63 |u.Reply-|To: donc|
|00000110| 40 69 73 69 2e 65 64 75 | 20 28 44 6f 6e 20 43 6f |@isi.edu| (Don Co|
|00000120| 68 65 6e 29 0a 44 69 73 | 74 72 69 62 75 74 69 6f |hen).Dis|tributio|
|00000130| 6e 3a 20 77 6f 72 6c 64 | 0a 4f 72 67 61 6e 69 7a |n: world|.Organiz|
|00000140| 61 74 69 6f 6e 3a 20 55 | 53 43 20 49 6e 66 6f 72 |ation: U|SC Infor|
|00000150| 6d 61 74 69 6f 6e 20 53 | 63 69 65 6e 63 65 73 20 |mation S|ciences |
|00000160| 49 6e 73 74 69 74 75 74 | 65 0a 4c 69 6e 65 73 3a |Institut|e.Lines:|
|00000170| 20 31 31 33 0a 4b 65 79 | 77 6f 72 64 73 3a 20 4c | 113.Key|words: L|
|00000180| 69 73 70 2c 20 61 6e 6e | 6f 74 61 74 69 6e 67 20 |isp, ann|otating |
|00000190| 70 72 6f 67 72 61 6d 6d | 65 73 2c 20 57 45 42 2c |programm|es, WEB,|
|000001a0| 20 54 65 58 0a 0a 3e 20 | 57 68 61 74 20 64 6f 20 | TeX..> |What do |
|000001b0| 4c 69 73 70 20 70 72 6f | 67 72 61 6d 6d 65 72 73 |Lisp pro|grammers|
|000001c0| 20 64 6f 20 69 66 20 74 | 68 65 79 20 77 61 6e 74 | do if t|hey want|
|000001d0| 20 74 6f 20 61 6e 6e 6f | 74 61 74 65 20 61 6e 64 | to anno|tate and|
|000001e0| 20 70 75 62 6c 69 73 68 | 20 74 68 65 69 72 0a 3e | publish| their.>|
|000001f0| 20 63 6f 64 65 73 3f 20 | 2e 2e 2e 0a 0a 41 73 20 | codes? |.....As |
|00000200| 66 61 72 20 61 73 20 49 | 20 63 61 6e 20 74 65 6c |far as I| can tel|
|00000210| 6c 2c 20 6d 6f 73 74 20 | 6c 69 73 70 20 70 72 6f |l, most |lisp pro|
|00000220| 67 72 61 6d 6d 65 72 73 | 20 64 6f 6e 27 74 20 75 |grammers| don't u|
|00000230| 73 65 20 61 6e 79 74 68 | 69 6e 67 20 6c 69 6b 65 |se anyth|ing like|
|00000240| 0a 57 45 42 2e 20 20 41 | 66 74 65 72 20 49 20 72 |.WEB.  A|fter I r|
|00000250| 65 61 64 20 61 62 6f 75 | 74 20 6c 69 74 65 72 61 |ead abou|t litera|
|00000260| 74 65 20 70 72 6f 67 72 | 61 6d 6d 69 6e 67 20 28 |te progr|amming (|
|00000270| 69 6e 20 43 41 43 4d 20 | 70 72 6f 67 72 61 6d 6d |in CACM |programm|
|00000280| 69 6e 67 0a 70 65 61 72 | 6c 73 3f 29 20 49 20 73 |ing.pear|ls?) I s|
|00000290| 74 61 72 74 65 64 20 75 | 73 69 6e 67 20 61 20 76 |tarted u|sing a v|
|000002a0| 65 72 79 20 73 69 6d 70 | 6c 65 20 61 70 70 72 6f |ery simp|le appro|
|000002b0| 78 69 6d 61 74 69 6f 6e | 20 66 6f 72 20 6c 69 73 |ximation| for lis|
|000002c0| 70 20 63 6f 64 65 2e 0a | 54 68 69 73 20 69 73 20 |p code..|This is |
|000002d0| 64 65 73 63 72 69 62 65 | 64 20 62 65 6c 6f 77 2e |describe|d below.|
|000002e0| 20 20 49 27 64 20 62 65 | 20 69 6e 74 65 72 65 73 |  I'd be| interes|
|000002f0| 74 65 64 20 69 6e 20 68 | 65 61 72 69 6e 67 20 77 |ted in h|earing w|
|00000300| 68 61 74 20 6f 74 68 65 | 72 0a 70 65 6f 70 6c 65 |hat othe|r.people|
|00000310| 20 6f 75 74 20 74 68 65 | 72 65 20 74 68 69 6e 6b | out the|re think|
|00000320| 20 6f 66 20 69 74 2e 20 | 20 49 27 6c 6c 20 62 65 | of it. | I'll be|
|00000330| 20 68 61 70 70 79 20 74 | 6f 20 64 69 73 63 75 73 | happy t|o discus|
|00000340| 73 20 74 68 69 73 20 61 | 6e 64 0a 61 6c 74 65 72 |s this a|nd.alter|
|00000350| 6e 61 74 69 76 65 20 73 | 6f 6c 75 74 69 6f 6e 73 |native s|olutions|
|00000360| 2e 0a 0a 42 61 73 69 63 | 61 6c 6c 79 20 49 20 6d |...Basic|ally I m|
|00000370| 61 69 6e 74 61 69 6e 20 | 22 74 68 65 22 20 73 6f |aintain |"the" so|
|00000380| 75 72 63 65 20 61 73 20 | 61 20 6c 69 73 70 20 66 |urce as |a lisp f|
|00000390| 69 6c 65 2c 20 69 2e 65 | 2e 2c 20 69 74 20 63 61 |ile, i.e|., it ca|
|000003a0| 6e 20 62 65 0a 6c 6f 61 | 64 65 64 20 69 6e 74 6f |n be.loa|ded into|
|000003b0| 20 6c 69 73 70 20 77 69 | 74 68 6f 75 74 20 63 68 | lisp wi|thout ch|
|000003c0| 61 6e 67 65 2e 20 20 28 | 49 20 74 65 6e 64 20 74 |ange.  (|I tend t|
|000003d0| 6f 20 72 65 61 64 20 66 | 69 6c 65 73 20 69 6e 74 |o read f|iles int|
|000003e0| 6f 20 6c 69 73 70 20 61 | 0a 6c 6f 74 20 6d 6f 72 |o lisp a|.lot mor|
|000003f0| 65 20 6f 66 74 65 6e 20 | 74 68 61 6e 20 6c 61 74 |e often |than lat|
|00000400| 65 78 2e 29 20 20 54 68 | 65 20 64 6f 63 75 6d 65 |ex.)  Th|e docume|
|00000410| 6e 74 61 74 69 6f 6e 20 | 69 73 20 61 6c 6c 20 69 |ntation |is all i|
|00000420| 6e 73 69 64 65 20 23 7c | 2e 2e 2e 7c 23 2e 0a 49 |nside #||...|#..I|
|00000430| 6e 20 6f 72 64 65 72 20 | 74 6f 20 63 6f 6d 70 69 |n order |to compi|
|00000440| 6c 65 20 69 74 20 61 73 | 20 61 20 6c 61 74 65 78 |le it as| a latex|
|00000450| 20 66 69 6c 65 20 74 68 | 65 72 65 20 69 73 20 61 | file th|ere is a|
|00000460| 20 76 65 72 79 20 73 6d | 61 6c 6c 20 61 6d 6f 75 | very sm|all amou|
|00000470| 6e 74 20 6f 66 0a 70 72 | 65 70 72 6f 63 65 73 73 |nt of.pr|eprocess|
|00000480| 69 6e 67 20 6e 65 65 64 | 65 64 2e 20 20 42 61 73 |ing need|ed.  Bas|
|00000490| 69 63 61 6c 6c 79 20 79 | 6f 75 20 6a 75 73 74 20 |ically y|ou just |
|000004a0| 68 61 76 65 20 74 6f 20 | 64 65 6c 65 74 65 20 61 |have to |delete a|
|000004b0| 6c 6c 0a 6f 63 63 75 72 | 72 65 6e 63 65 73 20 6f |ll.occur|rences o|
|000004c0| 66 20 6c 69 73 70 20 62 | 61 6c 61 6e 63 65 64 20 |f lisp b|alanced |
|000004d0| 63 6f 6d 6d 65 6e 74 20 | 64 65 6c 69 6d 69 74 65 |comment |delimite|
|000004e0| 72 73 20 28 23 7c 20 61 | 6e 64 20 7c 23 29 2e 20 |rs (#| a|nd |#). |
|000004f0| 20 49 20 61 6c 73 6f 0a | 72 65 70 6c 61 63 65 20 | I also.|replace |
|00000500| 74 61 62 73 20 77 69 74 | 68 20 73 70 61 63 65 73 |tabs wit|h spaces|
|00000510| 2c 20 73 69 6e 63 65 20 | 49 20 75 73 65 20 74 61 |, since |I use ta|
|00000520| 62 73 20 69 6e 20 74 68 | 65 20 6c 69 73 70 20 73 |bs in th|e lisp s|
|00000530| 6f 75 72 63 65 20 61 6e | 64 0a 6c 61 74 65 78 20 |ource an|d.latex |
|00000540| 64 6f 65 73 6e 27 74 20 | 73 65 65 6d 20 74 6f 20 |doesn't |seem to |
|00000550| 75 6e 64 65 72 73 74 61 | 6e 64 20 74 68 65 6d 2e |understa|nd them.|
|00000560| 20 20 28 49 20 73 74 69 | 6c 6c 20 68 61 76 65 20 |  (I sti|ll have |
|00000570| 6d 6f 64 65 20 6c 69 6e | 65 73 20 69 6e 20 6d 79 |mode lin|es in my|
|00000580| 0a 73 6f 75 72 63 65 2c | 20 73 6f 20 49 20 61 6c |.source,| so I al|
|00000590| 73 6f 20 67 65 74 20 72 | 69 64 20 6f 66 20 74 68 |so get r|id of th|
|000005a0| 6f 73 65 2e 29 0a 0a 48 | 65 72 65 27 73 20 61 20 |ose.)..H|ere's a |
|000005b0| 73 68 65 6c 6c 20 73 63 | 72 69 70 74 3a 0a 23 20 |shell sc|ript:.# |
|000005c0| 66 69 6c 65 20 6c 69 73 | 70 2d 74 65 78 3a 0a 23 |file lis|p-tex:.#|
|000005d0| 20 6c 69 73 70 2d 74 65 | 78 20 66 6f 6f 20 72 65 | lisp-te|x foo re|
|000005e0| 61 64 73 20 66 6f 6f 2e | 6c 69 73 70 20 61 6e 64 |ads foo.|lisp and|
|000005f0| 20 77 72 69 74 65 73 20 | 66 6f 6f 2e 74 65 78 0a | writes |foo.tex.|
|00000600| 23 20 72 65 6d 6f 76 65 | 73 20 31 73 74 20 6c 69 |# remove|s 1st li|
|00000610| 6e 65 20 28 6d 6f 64 65 | 20 6c 69 6e 65 29 2c 20 |ne (mode| line), |
|00000620| 64 65 6c 65 74 65 73 20 | 61 6c 6c 20 23 7c 27 73 |deletes |all #|'s|
|00000630| 20 61 6e 64 20 7c 23 27 | 73 2c 0a 23 20 65 78 70 | and |#'|s,.# exp|
|00000640| 61 6e 64 73 20 74 61 62 | 73 20 28 66 6f 72 20 74 |ands tab|s (for t|
|00000650| 65 78 29 0a 23 0a 23 20 | 65 63 68 6f 20 61 64 64 |ex).#.# |echo add|
|00000660| 73 20 61 20 63 72 20 2d | 20 73 65 64 20 74 68 72 |s a cr -| sed thr|
|00000670| 6f 77 73 20 6f 75 74 20 | 61 6e 79 74 68 69 6e 67 |ows out |anything|
|00000680| 20 61 66 74 65 72 20 74 | 68 65 20 6c 61 73 74 20 | after t|he last |
|00000690| 63 72 0a 23 0a 28 74 61 | 69 6c 20 2b 32 20 24 31 |cr.#.(ta|il +2 $1|
|000006a0| 2e 6c 69 73 70 3b 20 65 | 63 68 6f 20 22 22 29 20 |.lisp; e|cho "") |
|000006b0| 7c 20 73 65 64 20 27 73 | 2f 23 7c 2f 2f 67 5c 0a || sed 's|/#|//g\.|
|000006c0| 73 2f 7c 23 2f 2f 67 27 | 20 7c 20 65 78 70 61 6e |s/|#//g'| | expan|
|000006d0| 64 20 3e 20 24 31 2e 74 | 65 78 0a 0a 54 68 65 20 |d > $1.t|ex..The |
|000006e0| 72 65 73 75 6c 74 20 69 | 73 20 6d 65 61 6e 74 20 |result i|s meant |
|000006f0| 74 6f 20 62 65 20 69 6e | 63 6c 75 64 65 64 20 69 |to be in|cluded i|
|00000700| 6e 20 61 20 6c 61 72 67 | 65 72 20 64 6f 63 75 6d |n a larg|er docum|
|00000710| 65 6e 74 2c 20 77 68 69 | 63 68 20 64 65 66 69 6e |ent, whi|ch defin|
|00000720| 65 73 0a 28 61 6d 6f 6e | 67 20 6f 74 68 65 72 20 |es.(amon|g other |
|00000730| 74 68 69 6e 67 73 29 20 | 74 68 65 20 63 6f 6d 6d |things) |the comm|
|00000740| 65 6e 74 20 61 6e 64 20 | 63 6f 64 65 20 6d 61 63 |ent and |code mac|
|00000750| 72 6f 73 2e 20 20 43 6f | 6d 6d 65 6e 74 20 69 73 |ros.  Co|mment is|
|00000760| 20 75 73 65 66 75 6c 0a | 66 6f 72 20 69 6e 63 6c | useful.|for incl|
|00000770| 75 64 69 6e 67 20 73 74 | 75 66 66 20 69 6e 20 74 |uding st|uff in t|
|00000780| 68 65 20 73 6f 75 72 63 | 65 20 74 68 61 74 20 69 |he sourc|e that i|
|00000790| 73 20 6e 6f 74 20 69 6e | 63 6c 75 64 65 64 20 69 |s not in|cluded i|
|000007a0| 6e 20 74 68 65 20 6c 61 | 74 65 78 0a 6f 75 74 70 |n the la|tex.outp|
|000007b0| 75 74 2e 20 20 28 49 73 | 20 74 68 61 74 20 73 61 |ut.  (Is| that sa|
|000007c0| 63 72 69 6c 65 67 65 3f | 20 20 49 20 64 6f 6e 27 |crilege?|  I don'|
|000007d0| 74 20 64 6f 20 69 74 20 | 76 65 72 79 20 6f 66 74 |t do it |very oft|
|000007e0| 65 6e 2e 29 20 20 43 6f | 64 65 20 69 73 20 75 73 |en.)  Co|de is us|
|000007f0| 65 64 0a 66 6f 72 20 66 | 6f 72 6d 61 74 74 69 6e |ed.for f|ormattin|
|00000800| 67 20 63 6f 64 65 2e 20 | 20 54 79 70 69 63 61 6c |g code. | Typical|
|00000810| 6c 79 20 73 65 76 65 72 | 61 6c 20 73 75 63 68 20 |ly sever|al such |
|00000820| 66 69 6c 65 73 20 77 69 | 6c 6c 20 62 65 20 69 6e |files wi|ll be in|
|00000830| 63 6c 75 64 65 64 20 61 | 73 0a 63 68 61 70 74 65 |cluded a|s.chapte|
|00000840| 72 73 20 6f 66 20 74 68 | 65 20 73 61 6d 65 20 6c |rs of th|e same l|
|00000850| 61 74 65 78 20 64 6f 63 | 75 6d 65 6e 74 2e 20 20 |atex doc|ument.  |
|00000860| 48 65 72 65 20 61 72 65 | 20 74 68 65 20 6d 61 63 |Here are| the mac|
|00000870| 72 6f 20 64 65 66 69 6e | 69 74 69 6f 6e 73 20 49 |ro defin|itions I|
|00000880| 0a 63 75 72 72 65 6e 74 | 6c 79 20 75 73 65 3a 0a |.current|ly use:.|
|00000890| 0a 5c 6e 65 77 63 6f 6d | 6d 61 6e 64 7b 5c 63 6f |.\newcom|mand{\co|
|000008a0| 6d 6d 65 6e 74 7d 5b 31 | 5d 7b 7d 0a 0a 25 20 2d |mment}[1|]{}..% -|
|000008b0| 2d 2d 20 61 6c 6c 20 74 | 68 69 73 20 69 73 20 74 |-- all t|his is t|
|000008c0| 72 69 63 6b 79 20 73 74 | 75 66 66 20 66 6f 72 20 |ricky st|uff for |
|000008d0| 74 68 65 20 63 6f 64 65 | 20 63 6f 6d 6d 61 6e 64 |the code| command|
|000008e0| 20 2d 2d 2d 0a 5c 64 65 | 66 5c 75 6e 63 61 74 63 | ---.\de|f\uncatc|
|000008f0| 6f 64 65 73 70 65 63 69 | 61 6c 73 7b 5c 64 65 66 |odespeci|als{\def|
|00000900| 5c 64 6f 23 23 31 7b 5c | 63 61 74 63 6f 64 65 60 |\do##1{\|catcode`|
|00000910| 23 23 31 3d 31 32 20 7d | 20 5c 64 6f 73 70 65 63 |##1=12 }| \dospec|
|00000920| 69 61 6c 73 7d 0a 5c 64 | 65 66 5c 73 65 74 75 70 |ials}.\d|ef\setup|
|00000930| 76 65 72 62 61 74 69 6d | 7b 5c 74 74 20 5c 73 70 |verbatim|{\tt \sp|
|00000940| 61 63 65 73 6b 69 70 3d | 30 70 74 09 25 20 4d 61 |aceskip=|0pt.% Ma|
|00000950| 6b 65 20 73 75 72 65 20 | 77 65 20 67 65 74 20 66 |ke sure |we get f|
|00000960| 69 78 65 64 20 74 74 20 | 73 70 61 63 69 6e 67 0a |ixed tt |spacing.|
|00000970| 20 20 20 20 5c 6f 62 65 | 79 6c 69 6e 65 73 20 5c |    \obe|ylines \|
|00000980| 75 6e 63 61 74 63 6f 64 | 65 73 70 65 63 69 61 6c |uncatcod|especial|
|00000990| 73 0a 20 20 20 20 5c 6f | 62 65 79 73 70 61 63 65 |s.    \o|beyspace|
|000009a0| 73 20 5c 76 65 72 62 61 | 74 69 6d 64 65 66 73 7d |s \verba|timdefs}|
|000009b0| 0a 25 20 54 68 69 73 20 | 6d 61 63 72 6f 20 74 75 |.% This |macro tu|
|000009c0| 72 6e 73 20 6f 6e 20 76 | 65 72 62 61 74 69 6d 20 |rns on v|erbatim |
|000009d0| 6d 6f 64 65 20 75 6e 74 | 69 6c 20 5c 65 6e 64 76 |mode unt|il \endv|
|000009e0| 65 72 62 61 74 69 6d 20 | 69 73 20 73 65 65 6e 2e |erbatim |is seen.|
|000009f0| 0a 5c 64 65 66 5c 78 76 | 65 72 62 61 74 69 6d 7b |.\def\xv|erbatim{|
|00000a00| 5c 62 65 67 69 6e 67 72 | 6f 75 70 20 5c 73 65 74 |\begingr|oup \set|
|00000a10| 75 70 76 65 72 62 61 74 | 69 6d 20 5c 63 61 74 63 |upverbat|im \catc|
|00000a20| 6f 64 65 60 5c 7b 3d 31 | 5c 63 61 74 63 6f 64 65 |ode`\{=1|\catcode|
|00000a30| 60 5c 7d 3d 32 0a 20 20 | 5c 70 61 72 73 6b 69 70 |`\}=2.  |\parskip|
|00000a40| 3d 30 70 74 20 70 6c 75 | 73 20 2e 30 35 5c 62 61 |=0pt plu|s .05\ba|
|00000a50| 73 65 6c 69 6e 65 73 6b | 69 70 20 5c 70 61 72 69 |selinesk|ip \pari|
|00000a60| 6e 64 65 6e 74 3d 30 70 | 74 0a 20 20 20 5c 63 61 |ndent=0p|t.   \ca|
|00000a70| 74 63 6f 64 65 60 5c 20 | 3d 31 33 20 5c 63 61 74 |tcode`\ |=13 \cat|
|00000a80| 63 6f 64 65 60 5c 5e 5e | 4d 3d 31 33 20 20 5c 63 |code`\^^|M=13  \c|
|00000a90| 61 74 63 6f 64 65 60 5c | 5c 3d 30 7d 0a 7b 5c 63 |atcode`\|\=0}.{\c|
|00000aa0| 61 74 63 6f 64 65 60 5c | 5e 5e 4d 3d 31 33 7b 5c |atcode`\|^^M=13{\|
|00000ab0| 63 61 74 63 6f 64 65 60 | 5c 20 3d 31 33 5c 67 64 |catcode`|\ =13\gd|
|00000ac0| 65 66 5c 76 65 72 62 61 | 74 69 6d 64 65 66 73 7b |ef\verba|timdefs{|
|00000ad0| 5c 64 65 66 5e 5e 4d 7b | 5c 20 5c 70 61 72 7d 5c |\def^^M{|\ \par}\|
|00000ae0| 6c 65 74 20 3d 5c 20 7d | 7d 0a 20 20 5c 67 64 65 |let =\ }|}.  \gde|
|00000af0| 66 5c 76 65 72 62 61 74 | 69 6d 67 6f 62 62 6c 65 |f\verbat|imgobble|
|00000b00| 23 31 5e 5e 4d 7b 7d 7d | 0a 25 20 54 68 69 73 20 |#1^^M{}}|.% This |
|00000b10| 64 65 66 69 6e 65 73 20 | 5c 78 65 6e 64 76 65 72 |defines |\xendver|
|00000b20| 62 61 74 69 6d 20 74 6f | 20 65 6e 64 20 74 68 65 |batim to| end the|
|00000b30| 20 67 72 6f 75 70 20 77 | 68 69 63 68 20 62 65 67 | group w|hich beg|
|00000b40| 69 6e 73 20 77 69 74 68 | 20 5c 78 76 65 72 62 61 |ins with| \xverba|
|00000b50| 74 69 6d 0a 5c 6c 65 74 | 5c 78 65 6e 64 76 65 72 |tim.\let|\xendver|
|00000b60| 62 61 74 69 6d 3d 5c 65 | 6e 64 67 72 6f 75 70 0a |batim=\e|ndgroup.|
|00000b70| 5c 6e 65 77 63 6f 6d 6d | 61 6e 64 7b 5c 63 6f 64 |\newcomm|and{\cod|
|00000b80| 65 7d 5b 30 5d 7b 5c 78 | 76 65 72 62 61 74 69 6d |e}[0]{\x|verbatim|
|00000b90| 5c 66 6f 6f 74 6e 6f 74 | 65 73 69 7a 65 5c 74 74 |\footnot|esize\tt|
|00000ba0| 5c 68 65 6c 70 63 6f 64 | 65 7d 0a 5c 64 65 66 5c |\helpcod|e}.\def\|
|00000bb0| 68 65 6c 70 63 6f 64 65 | 23 31 7b 23 31 5c 78 65 |helpcode|#1{#1\xe|
|00000bc0| 6e 64 76 65 72 62 61 74 | 69 6d 7d 0a 0a 49 20 67 |ndverbat|im}..I g|
|00000bd0| 6f 74 20 73 6f 6d 65 6f | 6e 65 20 65 6c 73 65 20 |ot someo|ne else |
|00000be0| 74 6f 20 77 72 69 74 65 | 20 5c 63 6f 64 65 20 2d |to write| \code -|
|00000bf0| 20 49 27 6d 20 6e 6f 74 | 20 61 20 74 65 78 20 68 | I'm not| a tex h|
|00000c00| 61 63 6b 65 72 2e 20 20 | 49 27 76 65 20 61 64 6a |acker.  |I've adj|
|00000c10| 75 73 74 65 64 0a 69 74 | 20 73 6f 20 74 68 61 74 |usted.it| so that|
|00000c20| 20 6f 6e 20 6d 79 20 6e | 6f 72 6d 61 6c 20 73 69 | on my n|ormal si|
|00000c30| 7a 65 20 70 61 67 65 20 | 49 20 63 61 6e 20 67 65 |ze page |I can ge|
|00000c40| 74 20 38 30 20 63 6f 6c | 75 6d 6e 73 20 6f 66 20 |t 80 col|umns of |
|00000c50| 63 6f 64 65 2e 20 20 49 | 27 6d 20 6e 6f 74 0a 61 |code.  I|'m not.a|
|00000c60| 6c 6c 20 74 68 61 74 20 | 69 6e 74 65 72 65 73 74 |ll that |interest|
|00000c70| 65 64 20 69 6e 20 66 6f | 72 6d 61 74 74 69 6e 67 |ed in fo|rmatting|
|00000c80| 20 74 68 65 20 63 6f 64 | 65 20 62 65 79 6f 6e 64 | the cod|e beyond|
|00000c90| 20 74 68 65 20 75 73 75 | 61 6c 20 69 6e 64 65 6e | the usu|al inden|
|00000ca0| 74 61 74 69 6f 6e 2e 0a | 54 68 65 20 63 6f 64 65 |tation..|The code|
|00000cb0| 20 6d 61 63 72 6f 20 64 | 6f 65 73 20 70 65 72 6d | macro d|oes perm|
|00000cc0| 69 74 20 6c 61 74 65 78 | 20 63 6f 6d 6d 61 6e 64 |it latex| command|
|00000cd0| 73 20 69 6e 73 69 64 65 | 20 69 74 2c 20 77 68 69 |s inside| it, whi|
|00000ce0| 63 68 20 69 73 20 73 6f | 6d 65 74 69 6d 65 73 0a |ch is so|metimes.|
|00000cf0| 6e 69 63 65 2c 20 62 75 | 74 20 6f 6e 20 74 68 65 |nice, bu|t on the|
|00000d00| 20 6f 74 68 65 72 20 68 | 61 6e 64 20 69 74 20 6d | other h|and it m|
|00000d10| 65 61 6e 73 20 79 6f 75 | 20 68 61 76 65 20 74 6f |eans you| have to|
|00000d20| 20 77 61 74 63 68 20 6f | 75 74 20 66 6f 72 20 62 | watch o|ut for b|
|00000d30| 61 63 6b 73 6c 61 73 68 | 65 73 0a 69 6e 20 79 6f |ackslash|es.in yo|
|00000d40| 75 72 20 63 6f 64 65 2e | 20 20 28 41 6c 73 6f 20 |ur code.|  (Also |
|00000d50| 62 72 61 63 65 73 2e 29 | 20 20 46 6f 72 74 75 6e |braces.)|  Fortun|
|00000d60| 61 74 65 6c 79 20 74 68 | 65 73 65 20 64 6f 6e 27 |ately th|ese don'|
|00000d70| 74 20 61 70 70 65 61 72 | 20 76 65 72 79 20 6f 66 |t appear| very of|
|00000d80| 74 65 6e 20 0a 69 6e 20 | 6c 69 73 70 20 63 6f 64 |ten .in |lisp cod|
|00000d90| 65 2e 0a 0a 54 68 65 20 | 69 73 73 75 65 20 6f 66 |e...The |issue of|
|00000da0| 20 70 72 65 73 65 6e 74 | 69 6e 67 20 74 68 69 6e | present|ing thin|
|00000db0| 67 73 20 69 6e 20 61 20 | 64 69 66 66 65 72 65 6e |gs in a |differen|
|00000dc0| 74 20 6f 72 64 65 72 20 | 74 6f 20 74 68 65 20 72 |t order |to the r|
|00000dd0| 65 61 64 65 72 20 61 6e | 64 0a 74 68 65 20 63 6f |eader an|d.the co|
|00000de0| 6d 70 69 6c 65 72 20 73 | 65 65 6d 73 20 6c 65 73 |mpiler s|eems les|
|00000df0| 73 20 73 65 72 69 6f 75 | 73 20 69 6e 20 6c 69 73 |s seriou|s in lis|
|00000e00| 70 20 74 68 61 6e 20 69 | 6e 20 6f 74 68 65 72 20 |p than i|n other |
|00000e10| 6c 61 6e 67 75 61 67 65 | 73 2e 0a 48 6f 77 65 76 |language|s..Howev|
|00000e20| 65 72 20 49 20 68 61 76 | 65 20 6f 6e 20 6f 63 63 |er I hav|e on occ|
|00000e30| 61 73 69 6f 6e 20 77 61 | 6e 74 65 64 20 74 6f 20 |asion wa|nted to |
|00000e40| 64 6f 20 74 68 61 74 2e | 20 20 49 20 64 6f 6e 27 |do that.|  I don'|
|00000e50| 74 20 68 61 76 65 20 61 | 20 67 6f 6f 64 0a 73 6f |t have a| good.so|
|00000e60| 6c 75 74 69 6f 6e 2e 20 | 20 49 20 67 75 65 73 73 |lution. | I guess|
|00000e70| 20 79 6f 75 20 63 6f 75 | 6c 64 20 61 6c 77 61 79 | you cou|ld alway|
|00000e80| 73 20 64 65 66 69 6e 65 | 20 73 6f 6d 65 20 61 72 |s define| some ar|
|00000e90| 65 61 20 6f 66 20 74 68 | 65 20 74 65 78 74 20 61 |ea of th|e text a|
|00000ea0| 73 20 61 0a 6c 61 74 65 | 78 20 6d 61 63 72 6f 20 |s a.late|x macro |
|00000eb0| 61 6e 64 20 74 68 65 6e | 20 70 75 74 20 61 20 63 |and then| put a c|
|00000ec0| 61 6c 6c 20 74 6f 20 69 | 74 20 77 68 65 72 65 20 |all to i|t where |
|00000ed0| 79 6f 75 20 77 61 6e 74 | 20 69 74 20 74 6f 20 61 |you want| it to a|
|00000ee0| 70 70 65 61 72 20 69 6e | 0a 74 68 65 20 64 6f 63 |ppear in|.the doc|
|00000ef0| 75 6d 65 6e 74 61 74 69 | 6f 6e 2e 20 20 49 20 68 |umentati|on.  I h|
|00000f00| 61 76 65 20 6e 6f 74 20 | 61 63 74 75 61 6c 6c 79 |ave not |actually|
|00000f10| 20 64 6f 6e 65 20 74 68 | 61 74 2e 20 20 49 27 76 | done th|at.  I'v|
|00000f20| 65 20 61 6c 73 6f 20 66 | 6f 75 6e 64 20 69 74 0a |e also f|ound it.|
|00000f30| 76 65 72 79 20 68 65 6c | 70 66 75 6c 20 74 6f 20 |very hel|pful to |
|00000f40| 74 65 6c 6c 20 6d 79 20 | 65 64 69 74 6f 72 20 28 |tell my |editor (|
|00000f50| 67 6e 75 20 65 6d 61 63 | 73 29 20 74 6f 20 74 72 |gnu emac|s) to tr|
|00000f60| 65 61 74 20 62 72 61 63 | 65 73 20 61 73 20 6d 61 |eat brac|es as ma|
|00000f70| 74 63 68 69 6e 67 0a 64 | 65 6c 69 6d 69 74 65 72 |tching.d|elimiter|
|00000f80| 73 20 69 6e 20 6c 69 73 | 70 20 6d 6f 64 65 2e 20 |s in lis|p mode. |
|00000f90| 20 28 49 20 67 65 6e 65 | 72 61 6c 6c 79 20 65 64 | (I gene|rally ed|
|00000fa0| 69 74 20 74 68 65 73 65 | 20 66 69 6c 65 73 20 69 |it these| files i|
|00000fb0| 6e 20 6c 69 73 70 20 6d | 6f 64 65 2e 29 0a 0a 48 |n lisp m|ode.)..H|
|00000fc0| 65 72 65 27 73 20 77 68 | 61 74 20 6d 79 20 73 6f |ere's wh|at my so|
|00000fd0| 75 72 63 65 20 66 69 6c | 65 73 20 6c 6f 6f 6b 20 |urce fil|es look |
|00000fe0| 6c 69 6b 65 3a 0a 3b 3b | 3b 20 2d 2a 2d 20 4d 6f |like:.;;|; -*- Mo|
|00000ff0| 64 65 3a 20 4c 49 53 50 | 3b 20 50 61 63 6b 61 67 |de: LISP|; Packag|
|00001000| 65 3a 20 28 46 4f 4f 29 | 3b 20 53 79 6e 74 61 78 |e: (FOO)|; Syntax|
|00001010| 3a 20 43 6f 6d 6d 6f 6e | 2d 4c 69 73 70 20 2d 2a |: Common|-Lisp -*|
|00001020| 2d 0a 0a 23 7c 0a 5c 63 | 6f 6d 6d 65 6e 74 7b 0a |-..#|.\c|omment{.|
|00001030| 54 68 69 73 20 69 73 20 | 61 20 6c 69 73 70 20 73 |This is |a lisp s|
|00001040| 6f 75 72 63 65 20 66 69 | 6c 65 20 77 68 69 63 68 |ource fi|le which|
|00001050| 20 69 73 20 74 72 61 6e | 73 6c 61 74 65 64 20 69 | is tran|slated i|
|00001060| 6e 74 6f 20 73 6f 75 72 | 63 65 20 66 6f 72 20 61 |nto sour|ce for a|
|00001070| 0a 64 6f 63 75 6d 65 6e | 74 20 70 72 65 70 61 72 |.documen|t prepar|
|00001080| 61 74 69 6f 6e 20 73 79 | 73 74 65 6d 20 62 79 20 |ation sy|stem by |
|00001090| 2e 2e 2e 20 5b 73 74 61 | 6e 64 61 72 64 20 65 78 |... [sta|ndard ex|
|000010a0| 70 6c 61 6e 61 74 69 6f | 6e 5d 0a 7d 0a 0a 54 68 |planatio|n].}..Th|
|000010b0| 69 73 20 69 73 20 74 68 | 65 20 6c 61 74 65 78 20 |is is th|e latex |
|000010c0| 64 6f 63 75 6d 65 6e 74 | 61 74 69 6f 6e 2e 0a 48 |document|ation..H|
|000010d0| 65 72 65 27 73 20 73 6f | 6d 65 20 63 6f 64 65 3a |ere's so|me code:|
|000010e0| 0a 0a 5c 63 6f 64 65 7b | 7c 23 0a 28 69 6e 2d 70 |..\code{||#.(in-p|
|000010f0| 61 63 6b 61 67 65 20 22 | 46 4f 4f 22 29 0a 28 64 |ackage "|FOO").(d|
|00001100| 65 66 75 6e 20 66 6f 6f | 20 28 78 29 0a 20 20 28 |efun foo| (x).  (|
|00001110| 6c 69 73 74 20 31 20 78 | 29 29 0a 23 7c 7d 0a 0a |list 1 x|)).#|}..|
|00001120| 48 65 72 65 27 73 20 73 | 6f 6d 65 20 6d 6f 72 65 |Here's s|ome more|
|00001130| 20 64 6f 63 75 6d 65 6e | 74 61 74 69 6f 6e 2e 0a | documen|tation..|
|00001140| 48 65 72 65 27 73 20 73 | 6f 6d 65 20 6d 6f 72 65 |Here's s|ome more|
|00001150| 20 63 6f 64 65 3a 0a 0a | 5c 63 6f 64 65 7b 7c 23 | code:..|\code{|#|
|00001160| 0a 28 64 65 66 75 6e 20 | 62 61 72 20 28 78 29 0a |.(defun |bar (x).|
|00001170| 20 20 28 6c 69 73 74 20 | 32 20 78 29 29 0a 23 7c |  (list |2 x)).#||
|00001180| 7d 0a 0a 54 68 6f 73 65 | 20 6c 69 6e 65 73 20 73 |}..Those| lines s|
|00001190| 65 70 61 72 61 74 69 6e | 67 20 74 68 65 20 63 6f |eparatin|g the co|
|000011a0| 64 65 20 66 72 6f 6d 20 | 64 6f 63 75 6d 65 6e 74 |de from |document|
|000011b0| 61 74 69 6f 6e 20 61 72 | 65 20 61 20 6c 69 74 74 |ation ar|e a litt|
|000011c0| 6c 65 0a 70 61 69 6e 66 | 75 6c 20 74 6f 20 6d 61 |le.painf|ul to ma|
|000011d0| 69 6e 74 61 69 6e 20 2d | 20 69 74 20 77 6f 75 6c |intain -| it woul|
|000011e0| 64 20 63 65 72 74 61 69 | 6e 6c 79 20 62 65 20 65 |d certai|nly be e|
|000011f0| 61 73 69 65 72 20 69 66 | 20 74 68 65 79 20 77 65 |asier if| they we|
|00001200| 72 65 0a 73 69 6e 67 6c | 65 20 63 68 61 72 61 63 |re.singl|e charac|
|00001210| 74 65 72 73 20 28 6e 6f | 20 63 68 61 6e 63 65 20 |ters (no| chance |
|00001220| 6f 66 20 61 63 63 69 64 | 65 6e 74 61 6c 6c 79 20 |of accid|entally |
|00001230| 63 6f 72 72 75 70 74 69 | 6e 67 20 74 68 65 6d 29 |corrupti|ng them)|
|00001240| 2e 0a 48 6f 77 65 76 65 | 72 20 74 68 61 74 20 77 |..Howeve|r that w|
|00001250| 6f 75 6c 64 20 6d 61 6b | 65 20 74 68 65 20 72 65 |ould mak|e the re|
|00001260| 73 75 6c 74 20 68 61 72 | 64 65 72 20 74 6f 20 6c |sult har|der to l|
|00001270| 6f 61 64 20 69 6e 74 6f | 20 6c 69 73 70 2e 0a 28 |oad into| lisp..(|
|00001280| 49 20 6b 6e 6f 77 2c 20 | 49 20 63 6f 75 6c 64 20 |I know, |I could |
|00001290| 75 73 65 20 72 65 61 64 | 20 6d 61 63 72 6f 73 2c |use read| macros,|
|000012a0| 20 62 75 74 20 74 68 61 | 74 20 77 6f 75 6c 64 20 | but tha|t would |
|000012b0| 62 65 20 61 6e 6f 74 68 | 65 72 20 0a 72 65 71 75 |be anoth|er .requ|
|000012c0| 69 72 65 6d 65 6e 74 20 | 69 6d 70 6f 73 65 64 20 |irement |imposed |
|000012d0| 6f 6e 20 74 68 65 20 6c | 69 73 70 20 65 6e 76 69 |on the l|isp envi|
|000012e0| 72 6f 6e 6d 65 6e 74 2e | 20 20 54 68 69 73 20 77 |ronment.|  This w|
|000012f0| 61 79 20 74 68 65 20 66 | 69 6c 65 0a 63 61 6e 20 |ay the f|ile.can |
|00001300| 62 65 20 72 65 61 64 20 | 69 6e 74 6f 20 61 6e 79 |be read |into any|
|00001310| 20 73 74 61 6e 64 61 72 | 64 20 6c 69 73 70 20 65 | standar|d lisp e|
|00001320| 6e 76 69 72 6f 6e 6d 65 | 6e 74 2e 29 20 20 4f 6e |nvironme|nt.)  On|
|00001330| 20 74 68 65 20 6f 74 68 | 65 72 0a 68 61 6e 64 2c | the oth|er.hand,|
|00001340| 20 69 74 27 73 20 6f 63 | 63 61 73 69 6f 6e 61 6c | it's oc|casional|
|00001350| 6c 79 20 75 73 65 66 75 | 6c 20 74 6f 20 65 78 63 |ly usefu|l to exc|
|00001360| 6c 75 64 65 20 73 6f 6d | 65 20 6f 66 20 74 68 65 |lude som|e of the|
|00001370| 20 63 6f 64 65 20 66 72 | 6f 6d 0a 74 68 65 20 64 | code fr|om.the d|
|00001380| 6f 63 75 6d 65 6e 74 61 | 74 69 6f 6e 2c 20 61 6e |ocumenta|tion, an|
|00001390| 64 20 74 68 61 74 20 63 | 61 6e 20 62 65 20 64 6f |d that c|an be do|
|000013a0| 6e 65 20 62 79 20 75 73 | 69 6e 67 20 74 68 65 20 |ne by us|ing the |
|000013b0| 77 6f 72 64 20 63 6f 6d | 6d 65 6e 74 0a 69 6e 73 |word com|ment.ins|
|000013c0| 74 65 61 64 20 6f 66 20 | 63 6f 64 65 2e 20 20 28 |tead of |code.  (|
|000013d0| 49 20 6b 6e 6f 77 2c 20 | 74 68 61 74 20 63 6f 75 |I know, |that cou|
|000013e0| 6c 64 20 62 65 20 61 6e | 6f 74 68 65 72 20 73 69 |ld be an|other si|
|000013f0| 6e 67 6c 65 20 63 68 61 | 72 61 63 74 65 72 2e 29 |ngle cha|racter.)|
|00001400| 0a 54 68 65 20 6f 6e 6c | 79 20 6f 74 68 65 72 20 |.The onl|y other |
|00001410| 74 68 69 6e 67 20 69 73 | 20 74 68 61 74 20 79 6f |thing is| that yo|
|00001420| 75 20 68 61 76 65 20 74 | 6f 20 65 6e 64 20 74 68 |u have t|o end th|
|00001430| 65 20 66 69 6c 65 20 77 | 69 74 68 20 61 6e 20 65 |e file w|ith an e|
|00001440| 6e 64 20 0a 6f 66 20 63 | 6f 6d 6d 65 6e 74 20 64 |nd .of c|omment d|
|00001450| 65 6c 69 6d 69 74 65 72 | 2c 20 6c 69 6b 65 20 73 |elimiter|, like s|
|00001460| 6f 3a 0a 23 7c 0a       |                         |o:.#|.  |        |
+--------+-------------------------+-------------------------+--------+--------+