home *** CD-ROM | disk | FTP | other *** search
open in: 
MacOS 8.1
|
Win98
|
DOS
browse contents |
view JSON data
|
view as text
This file was processed as: LaTeX Document
(document/latex).
| Confidence | Program | Detection | Match Type | Support
|
|---|
| 100%
| dexvert
| LaTeX Document (document/latex)
| magic
| Supported |
| 1%
| dexvert
| Text File (text/txt)
| fallback
| Supported |
| 100%
| file
| LaTeX 2e document text
| default
| |
| 99%
| file
| LaTeX document text
| default
| |
| 98%
| file
| LaTeX document, ASCII text
| default
| |
| 100%
| TrID
| LaTeX 2e document (with rem)
| default
| |
| 100%
| checkBytes
| Printable ASCII
| default
| |
| 100%
| perlTextCheck
| Likely Text (Perl)
| default
| |
| 100%
| siegfried
| fmt/280 LaTeX (Master document)
| default
| |
| 100%
| detectItEasy
| Format: plain text[LF]
| default (weak)
| |
| 100%
| xdgMime
| text/x-matlab
| default (weak)
|
|
hex view+--------+-------------------------+-------------------------+--------+--------+
|00000000| 25 0a 25 20 4e 75 77 65 | 62 3a 20 41 20 53 69 6d |%.% Nuwe|b: A Sim|
|00000010| 70 6c 65 20 4c 69 74 65 | 72 61 74 65 20 50 72 6f |ple Lite|rate Pro|
|00000020| 67 72 61 6d 6d 69 6e 67 | 20 54 6f 6f 6c 0a 25 0a |gramming| Tool.%.|
|00000030| 0a 0a 5c 64 6f 63 75 6d | 65 6e 74 63 6c 61 73 73 |..\docum|entclass|
|00000040| 7b 72 65 70 6f 72 74 7d | 0a 5c 75 73 65 70 61 63 |{report}|.\usepac|
|00000050| 6b 61 67 65 7b 61 34 77 | 69 64 65 2c 6e 75 77 65 |kage{a4w|ide,nuwe|
|00000060| 62 2c 6c 61 74 65 78 73 | 79 6d 2c 6d 66 6c 6f 67 |b,latexs|ym,mflog|
|00000070| 6f 2c 6e 65 77 6c 66 6f | 6e 74 2c 73 68 6f 72 74 |o,newlfo|nt,short|
|00000080| 76 72 62 2c 76 65 72 73 | 69 6f 6e 7d 0a 0a 5c 4d |vrb,vers|ion}..\M|
|00000090| 61 6b 65 53 68 6f 72 74 | 56 65 72 62 7b 5c 7c 7d |akeShort|Verb{\|}|
|000000a0| 0a 0a 5c 70 72 6f 76 69 | 64 65 63 6f 6d 6d 61 6e |..\provi|decomman|
|000000b0| 64 7b 5c 68 69 64 65 63 | 6f 64 65 7d 7b 66 61 6c |d{\hidec|ode}{fal|
|000000c0| 73 65 7d 0a 5c 69 66 74 | 68 65 6e 65 6c 73 65 7b |se}.\ift|henelse{|
|000000d0| 5c 65 71 75 61 6c 7b 5c | 68 69 64 65 63 6f 64 65 |\equal{\|hidecode|
|000000e0| 7d 7b 74 72 75 65 7d 7d | 25 0a 20 20 20 20 7b 5c |}{true}}|%. {\|
|000000f0| 65 78 63 6c 75 64 65 76 | 65 72 73 69 6f 6e 7b 63 |excludev|ersion{c|
|00000100| 6f 64 65 7d 7d 7b 5c 69 | 6e 63 6c 75 64 65 76 65 |ode}}{\i|ncludeve|
|00000110| 72 73 69 6f 6e 7b 63 6f | 64 65 7d 7d 0a 0a 5c 6e |rsion{co|de}}..\n|
|00000120| 65 77 63 6f 6d 6d 61 6e | 64 7b 5c 48 54 4d 4c 7d |ewcomman|d{\HTML}|
|00000130| 7b 5c 74 65 78 74 73 63 | 7b 48 54 4d 4c 7d 7d 0a |{\textsc|{HTML}}.|
|00000140| 0a 0a 5c 62 65 67 69 6e | 7b 64 6f 63 75 6d 65 6e |..\begin|{documen|
|00000150| 74 7d 0a 5c 70 61 67 65 | 6e 75 6d 62 65 72 69 6e |t}.\page|numberin|
|00000160| 67 7b 72 6f 6d 61 6e 7d | 0a 0a 5c 74 69 74 6c 65 |g{roman}|..\title|
|00000170| 7b 4e 75 77 65 62 20 5c | 5c 20 41 20 53 69 6d 70 |{Nuweb \|\ A Simp|
|00000180| 6c 65 20 4c 69 74 65 72 | 61 74 65 20 50 72 6f 67 |le Liter|ate Prog|
|00000190| 72 61 6d 6d 69 6e 67 20 | 54 6f 6f 6c 20 5c 5c 20 |ramming |Tool \\ |
|000001a0| 76 65 72 73 69 6f 6e 20 | 30 2e 39 30 7d 0a 5c 64 |version |0.90}.\d|
|000001b0| 61 74 65 7b 31 35 74 68 | 20 4d 61 79 20 31 39 39 |ate{15th| May 199|
|000001c0| 37 7d 0a 5c 61 75 74 68 | 6f 72 7b 50 72 65 73 74 |7}.\auth|or{Prest|
|000001d0| 6f 6e 20 42 72 69 67 67 | 73 5c 74 68 61 6e 6b 73 |on Brigg|s\thanks|
|000001e0| 7b 54 68 69 73 20 77 6f | 72 6b 20 68 61 73 20 62 |{This wo|rk has b|
|000001f0| 65 65 6e 20 73 75 70 70 | 6f 72 74 65 64 20 62 79 |een supp|orted by|
|00000200| 20 41 52 50 41 2c 0a 74 | 68 72 6f 75 67 68 20 4f | ARPA,.t|hrough O|
|00000210| 4e 52 20 67 72 61 6e 74 | 20 4e 30 30 30 31 34 2d |NR grant| N00014-|
|00000220| 39 31 2d 4a 2d 31 39 38 | 39 2e 7d 0a 5c 5c 20 5c |91-J-198|9.}.\\ \|
|00000230| 73 6c 20 70 72 65 73 74 | 6f 6e 40 40 63 73 2e 72 |sl prest|on@@cs.r|
|00000240| 69 63 65 2e 65 64 75 0a | 5c 5c 20 5c 48 54 4d 4c |ice.edu.|\\ \HTML|
|00000250| 5c 20 73 63 72 61 70 20 | 67 65 6e 65 72 61 74 6f |\ scrap |generato|
|00000260| 72 20 62 79 20 4a 6f 68 | 6e 20 44 2e 20 52 61 6d |r by Joh|n D. Ram|
|00000270| 73 64 65 6c 6c 0a 5c 5c | 20 5c 73 6c 20 72 61 6d |sdell.\\| \sl ram|
|00000280| 73 64 65 6c 6c 40 40 6d | 69 74 72 65 2e 6f 72 67 |sdell@@m|itre.org|
|00000290| 0a 5c 5c 20 52 65 76 69 | 73 65 64 20 62 79 20 52 |.\\ Revi|sed by R|
|000002a0| 65 75 62 65 6e 20 54 68 | 6f 6d 61 73 0a 5c 5c 20 |euben Th|omas.\\ |
|000002b0| 5c 73 6c 20 52 65 75 62 | 65 6e 2e 54 68 6f 6d 61 |\sl Reub|en.Thoma|
|000002c0| 73 40 40 63 6c 2e 63 61 | 6d 2e 61 63 2e 75 6b 7d |s@@cl.ca|m.ac.uk}|
|000002d0| 0a 5c 6d 61 6b 65 74 69 | 74 6c 65 0a 0a 5c 74 61 |.\maketi|tle..\ta|
|000002e0| 62 6c 65 6f 66 63 6f 6e | 74 65 6e 74 73 0a 5c 70 |bleofcon|tents.\p|
|000002f0| 61 67 65 6e 75 6d 62 65 | 72 69 6e 67 7b 61 72 61 |agenumbe|ring{ara|
|00000300| 62 69 63 7d 0a 0a 0a 0a | 5c 63 68 61 70 74 65 72 |bic}....|\chapter|
|00000310| 7b 49 6e 74 72 6f 64 75 | 63 74 69 6f 6e 7d 0a 0a |{Introdu|ction}..|
|00000320| 49 6e 20 31 39 38 34 2c | 20 4b 6e 75 74 68 20 69 |In 1984,| Knuth i|
|00000330| 6e 74 72 6f 64 75 63 65 | 64 20 74 68 65 20 69 64 |ntroduce|d the id|
|00000340| 65 61 20 6f 66 20 5c 65 | 6d 70 68 7b 6c 69 74 65 |ea of \e|mph{lite|
|00000350| 72 61 74 65 20 70 72 6f | 67 72 61 6d 6d 69 6e 67 |rate pro|gramming|
|00000360| 7d 20 61 6e 64 0a 64 65 | 73 63 72 69 62 65 64 20 |} and.de|scribed |
|00000370| 61 20 70 61 69 72 20 6f | 66 20 74 6f 6f 6c 73 20 |a pair o|f tools |
|00000380| 74 6f 20 73 75 70 70 6f | 72 74 20 74 68 65 20 70 |to suppo|rt the p|
|00000390| 72 61 63 74 69 63 65 7e | 5c 63 69 74 65 7b 6b 6e |ractice~|\cite{kn|
|000003a0| 75 74 68 3a 38 34 7d 2e | 20 48 69 73 0a 61 70 70 |uth:84}.| His.app|
|000003b0| 72 6f 61 63 68 20 77 61 | 73 20 74 6f 20 63 6f 6d |roach wa|s to com|
|000003c0| 62 69 6e 65 20 50 61 73 | 63 61 6c 20 63 6f 64 65 |bine Pas|cal code|
|000003d0| 20 77 69 74 68 20 5c 54 | 65 58 5c 20 64 6f 63 75 | with \T|eX\ docu|
|000003e0| 6d 65 6e 74 61 74 69 6f | 6e 20 74 6f 20 70 72 6f |mentatio|n to pro|
|000003f0| 64 75 63 65 20 61 20 6e | 65 77 0a 6c 61 6e 67 75 |duce a n|ew.langu|
|00000400| 61 67 65 2c 20 7c 57 45 | 42 7c 2c 20 74 68 61 74 |age, |WE|B|, that|
|00000410| 20 6f 66 66 65 72 65 64 | 20 70 72 6f 67 72 61 6d | offered| program|
|00000420| 6d 65 72 73 20 61 20 73 | 75 70 65 72 69 6f 72 20 |mers a s|uperior |
|00000430| 61 70 70 72 6f 61 63 68 | 20 74 6f 0a 70 72 6f 67 |approach| to.prog|
|00000440| 72 61 6d 6d 69 6e 67 2e | 20 48 65 20 77 72 6f 74 |ramming.| He wrot|
|00000450| 65 20 73 65 76 65 72 61 | 6c 20 70 72 6f 67 72 61 |e severa|l progra|
|00000460| 6d 73 20 69 6e 20 7c 57 | 45 42 7c 2c 20 69 6e 63 |ms in |W|EB|, inc|
|00000470| 6c 75 64 69 6e 67 20 7c | 77 65 61 76 65 7c 0a 61 |luding ||weave|.a|
|00000480| 6e 64 20 7c 74 61 6e 67 | 6c 65 7c 2c 20 74 68 65 |nd |tang|le|, the|
|00000490| 20 70 72 6f 67 72 61 6d | 73 20 75 73 65 64 20 74 | program|s used t|
|000004a0| 6f 20 73 75 70 70 6f 72 | 74 20 6c 69 74 65 72 61 |o suppor|t litera|
|000004b0| 74 65 20 70 72 6f 67 72 | 61 6d 6d 69 6e 67 2e 20 |te progr|amming. |
|000004c0| 54 68 65 0a 69 64 65 61 | 20 77 61 73 20 74 68 61 |The.idea| was tha|
|000004d0| 74 20 61 20 70 72 6f 67 | 72 61 6d 6d 65 72 20 77 |t a prog|rammer w|
|000004e0| 72 6f 74 65 20 6f 6e 65 | 20 64 6f 63 75 6d 65 6e |rote one| documen|
|000004f0| 74 2c 20 74 68 65 20 77 | 65 62 20 66 69 6c 65 2c |t, the w|eb file,|
|00000500| 20 74 68 61 74 20 63 6f | 6d 62 69 6e 65 64 0a 64 | that co|mbined.d|
|00000510| 6f 63 75 6d 65 6e 74 61 | 74 69 6f 6e 20 28 77 72 |ocumenta|tion (wr|
|00000520| 69 74 74 65 6e 20 69 6e | 20 5c 54 65 58 7e 5c 63 |itten in| \TeX~\c|
|00000530| 69 74 65 7b 74 65 78 62 | 6f 6f 6b 7d 29 20 77 69 |ite{texb|ook}) wi|
|00000540| 74 68 20 63 6f 64 65 20 | 28 77 72 69 74 74 65 6e |th code |(written|
|00000550| 20 69 6e 20 50 61 73 63 | 61 6c 29 2e 0a 0a 52 75 | in Pasc|al)...Ru|
|00000560| 6e 6e 69 6e 67 20 7c 74 | 61 6e 67 6c 65 7c 20 6f |nning |t|angle| o|
|00000570| 6e 20 74 68 65 20 77 65 | 62 20 66 69 6c 65 20 77 |n the we|b file w|
|00000580| 6f 75 6c 64 20 70 72 6f | 64 75 63 65 20 61 20 63 |ould pro|duce a c|
|00000590| 6f 6d 70 6c 65 74 65 20 | 50 61 73 63 61 6c 0a 70 |omplete |Pascal.p|
|000005a0| 72 6f 67 72 61 6d 2c 20 | 72 65 61 64 79 20 66 6f |rogram, |ready fo|
|000005b0| 72 20 63 6f 6d 70 69 6c | 61 74 69 6f 6e 20 62 79 |r compil|ation by|
|000005c0| 20 61 6e 20 6f 72 64 69 | 6e 61 72 79 20 50 61 73 | an ordi|nary Pas|
|000005d0| 63 61 6c 20 63 6f 6d 70 | 69 6c 65 72 2e 20 54 68 |cal comp|iler. Th|
|000005e0| 65 20 70 72 69 6d 61 72 | 79 0a 66 75 6e 63 74 69 |e primar|y.functi|
|000005f0| 6f 6e 20 6f 66 20 7c 74 | 61 6e 67 6c 65 7c 20 69 |on of |t|angle| i|
|00000600| 73 20 74 6f 20 61 6c 6c | 6f 77 20 74 68 65 20 70 |s to all|ow the p|
|00000610| 72 6f 67 72 61 6d 6d 65 | 72 20 74 6f 20 70 72 65 |rogramme|r to pre|
|00000620| 73 65 6e 74 20 65 6c 65 | 6d 65 6e 74 73 20 6f 66 |sent ele|ments of|
|00000630| 0a 74 68 65 20 70 72 6f | 67 72 61 6d 20 69 6e 20 |.the pro|gram in |
|00000640| 61 6e 79 20 64 65 73 69 | 72 65 64 20 6f 72 64 65 |any desi|red orde|
|00000650| 72 2c 20 72 65 67 61 72 | 64 6c 65 73 73 20 6f 66 |r, regar|dless of|
|00000660| 20 74 68 65 20 72 65 73 | 74 72 69 63 74 69 6f 6e | the res|triction|
|00000670| 73 20 69 6d 70 6f 73 65 | 64 20 62 79 0a 74 68 65 |s impose|d by.the|
|00000680| 20 70 72 6f 67 72 61 6d | 6d 69 6e 67 20 6c 61 6e | program|ming lan|
|00000690| 67 75 61 67 65 2e 20 54 | 68 75 73 2c 20 74 68 65 |guage. T|hus, the|
|000006a0| 20 70 72 6f 67 72 61 6d | 6d 65 72 20 69 73 20 66 | program|mer is f|
|000006b0| 72 65 65 20 74 6f 20 70 | 72 65 73 65 6e 74 20 68 |ree to p|resent h|
|000006c0| 69 73 20 70 72 6f 67 72 | 61 6d 0a 69 6e 20 61 20 |is progr|am.in a |
|000006d0| 74 6f 70 2d 64 6f 77 6e | 20 66 61 73 68 69 6f 6e |top-down| fashion|
|000006e0| 2c 20 62 6f 74 74 6f 6d | 2d 75 70 20 66 61 73 68 |, bottom|-up fash|
|000006f0| 69 6f 6e 2c 20 6f 72 20 | 77 68 61 74 65 76 65 72 |ion, or |whatever|
|00000700| 20 73 65 65 6d 73 20 62 | 65 73 74 20 69 6e 20 74 | seems b|est in t|
|00000710| 65 72 6d 73 20 6f 66 0a | 70 72 6f 6d 6f 74 69 6e |erms of.|promotin|
|00000720| 67 20 75 6e 64 65 72 73 | 74 61 6e 64 69 6e 67 20 |g unders|tanding |
|00000730| 61 6e 64 20 6d 61 69 6e | 74 65 6e 61 6e 63 65 2e |and main|tenance.|
|00000740| 0a 0a 52 75 6e 6e 69 6e | 67 20 7c 77 65 61 76 65 |..Runnin|g |weave|
|00000750| 7c 20 6f 6e 20 74 68 65 | 20 77 65 62 20 66 69 6c || on the| web fil|
|00000760| 65 20 77 6f 75 6c 64 20 | 70 72 6f 64 75 63 65 20 |e would |produce |
|00000770| 61 20 5c 54 65 58 5c 20 | 66 69 6c 65 2c 20 72 65 |a \TeX\ |file, re|
|00000780| 61 64 79 20 74 6f 20 62 | 65 0a 70 72 6f 63 65 73 |ady to b|e.proces|
|00000790| 73 65 64 20 62 79 20 5c | 54 65 58 5c 40 40 2e 20 |sed by \|TeX\@@. |
|000007a0| 54 68 65 20 72 65 73 75 | 6c 74 69 6e 67 20 64 6f |The resu|lting do|
|000007b0| 63 75 6d 65 6e 74 20 69 | 6e 63 6c 75 64 65 64 20 |cument i|ncluded |
|000007c0| 61 20 76 61 72 69 65 74 | 79 20 6f 66 0a 61 75 74 |a variet|y of.aut|
|000007d0| 6f 6d 61 74 69 63 61 6c | 6c 79 20 67 65 6e 65 72 |omatical|ly gener|
|000007e0| 61 74 65 64 20 69 6e 64 | 69 63 65 73 20 61 6e 64 |ated ind|ices and|
|000007f0| 20 63 72 6f 73 73 2d 72 | 65 66 65 72 65 6e 63 65 | cross-r|eference|
|00000800| 73 20 74 68 61 74 20 6d | 61 64 65 20 69 74 20 6d |s that m|ade it m|
|00000810| 75 63 68 20 65 61 73 69 | 65 72 0a 74 6f 20 6e 61 |uch easi|er.to na|
|00000820| 76 69 67 61 74 65 20 74 | 68 65 20 63 6f 64 65 2e |vigate t|he code.|
|00000830| 20 41 64 64 69 74 69 6f | 6e 61 6c 6c 79 2c 20 61 | Additio|nally, a|
|00000840| 6c 6c 20 6f 66 20 74 68 | 65 20 63 6f 64 65 20 73 |ll of th|e code s|
|00000850| 65 63 74 69 6f 6e 73 20 | 77 65 72 65 0a 61 75 74 |ections |were.aut|
|00000860| 6f 6d 61 74 69 63 61 6c | 6c 79 20 70 72 65 74 74 |omatical|ly prett|
|00000870| 79 20 70 72 69 6e 74 65 | 64 2c 20 72 65 73 75 6c |y printe|d, resul|
|00000880| 74 69 6e 67 20 69 6e 20 | 61 20 71 75 69 74 65 20 |ting in |a quite |
|00000890| 69 6d 70 72 65 73 73 69 | 76 65 20 64 6f 63 75 6d |impressi|ve docum|
|000008a0| 65 6e 74 2e 0a 0a 4b 6e | 75 74 68 20 61 6c 73 6f |ent...Kn|uth also|
|000008b0| 20 77 72 6f 74 65 20 74 | 68 65 20 70 72 6f 67 72 | wrote t|he progr|
|000008c0| 61 6d 73 20 66 6f 72 20 | 5c 54 65 58 5c 20 61 6e |ams for |\TeX\ an|
|000008d0| 64 20 5c 4d 46 5c 20 65 | 6e 74 69 72 65 6c 79 20 |d \MF\ e|ntirely |
|000008e0| 69 6e 20 7c 57 45 42 7c | 2c 0a 65 76 65 6e 74 75 |in |WEB||,.eventu|
|000008f0| 61 6c 6c 79 20 70 75 62 | 6c 69 73 68 69 6e 67 20 |ally pub|lishing |
|00000900| 74 68 65 6d 20 69 6e 20 | 62 6f 6f 6b 20 66 6f 72 |them in |book for|
|00000910| 6d 7e 5c 63 69 74 65 7b | 74 65 78 3a 70 72 6f 67 |m~\cite{|tex:prog|
|00000920| 72 61 6d 2c 6d 65 74 61 | 66 6f 6e 74 3a 70 72 6f |ram,meta|font:pro|
|00000930| 67 72 61 6d 7d 2e 0a 54 | 68 65 73 65 20 61 72 65 |gram}..T|hese are|
|00000940| 20 70 72 6f 62 61 62 6c | 79 20 74 68 65 20 6c 61 | probabl|y the la|
|00000950| 72 67 65 73 74 20 70 72 | 6f 67 72 61 6d 73 20 65 |rgest pr|ograms e|
|00000960| 76 65 72 20 70 75 62 6c | 69 73 68 65 64 20 69 6e |ver publ|ished in|
|00000970| 20 61 20 72 65 61 64 61 | 62 6c 65 20 66 6f 72 6d | a reada|ble form|
|00000980| 2e 0a 0a 49 6e 73 70 69 | 72 65 64 20 62 79 20 4b |...Inspi|red by K|
|00000990| 6e 75 74 68 27 73 20 65 | 78 61 6d 70 6c 65 2c 20 |nuth's e|xample, |
|000009a0| 6d 61 6e 79 20 70 65 6f | 70 6c 65 20 68 61 76 65 |many peo|ple have|
|000009b0| 20 65 78 70 65 72 69 6d | 65 6e 74 65 64 20 77 69 | experim|ented wi|
|000009c0| 74 68 20 7c 57 45 42 7c | 5c 40 40 2e 0a 53 6f 6d |th |WEB||\@@..Som|
|000009d0| 65 20 70 65 6f 70 6c 65 | 20 68 61 76 65 20 65 76 |e people| have ev|
|000009e0| 65 6e 20 62 75 69 6c 74 | 20 5c 6d 62 6f 78 7b 5c |en built| \mbox{\|
|000009f0| 74 65 78 74 74 74 7b 57 | 45 42 7d 2d 6c 69 6b 65 |texttt{W|EB}-like|
|00000a00| 7d 20 74 6f 6f 6c 73 20 | 66 6f 72 20 74 68 65 69 |} tools |for thei|
|00000a10| 72 20 6f 77 6e 0a 66 61 | 76 6f 72 69 74 65 20 63 |r own.fa|vorite c|
|00000a20| 6f 6d 62 69 6e 61 74 69 | 6f 6e 73 20 6f 66 20 70 |ombinati|ons of p|
|00000a30| 72 6f 67 72 61 6d 6d 69 | 6e 67 20 6c 61 6e 67 75 |rogrammi|ng langu|
|00000a40| 61 67 65 20 61 6e 64 20 | 74 79 70 65 73 65 74 74 |age and |typesett|
|00000a50| 69 6e 67 20 6c 61 6e 67 | 75 61 67 65 2e 20 46 6f |ing lang|uage. Fo|
|00000a60| 72 0a 65 78 61 6d 70 6c | 65 2c 20 7c 43 57 45 42 |r.exampl|e, |CWEB|
|00000a70| 7c 2c 20 4b 6e 75 74 68 | 27 73 20 63 75 72 72 65 ||, Knuth|'s curre|
|00000a80| 6e 74 20 73 79 73 74 65 | 6d 20 6f 66 20 63 68 6f |nt syste|m of cho|
|00000a90| 69 63 65 2c 20 77 6f 72 | 6b 73 20 77 69 74 68 20 |ice, wor|ks with |
|00000aa0| 61 20 63 6f 6d 62 69 6e | 61 74 69 6f 6e 0a 6f 66 |a combin|ation.of|
|00000ab0| 20 43 20 28 6f 72 20 43 | 2b 2b 29 20 61 6e 64 20 | C (or C|++) and |
|00000ac0| 5c 54 65 58 7e 5c 63 69 | 74 65 7b 6c 65 76 79 3a |\TeX~\ci|te{levy:|
|00000ad0| 39 30 7d 2e 20 41 6e 6f | 74 68 65 72 20 73 79 73 |90}. Ano|ther sys|
|00000ae0| 74 65 6d 2c 20 46 75 6e | 6e 65 6c 57 65 62 2c 20 |tem, Fun|nelWeb, |
|00000af0| 69 73 0a 69 6e 64 65 70 | 65 6e 64 65 6e 74 20 6f |is.indep|endent o|
|00000b00| 66 20 61 6e 79 20 70 72 | 6f 67 72 61 6d 6d 69 6e |f any pr|ogrammin|
|00000b10| 67 20 6c 61 6e 67 75 61 | 67 65 20 61 6e 64 20 6f |g langua|ge and o|
|00000b20| 6e 6c 79 20 6d 69 6c 64 | 6c 79 20 64 65 70 65 6e |nly mild|ly depen|
|00000b30| 64 65 6e 74 20 6f 6e 0a | 5c 54 65 58 7e 5c 63 69 |dent on.|\TeX~\ci|
|00000b40| 74 65 7b 66 75 6e 6e 65 | 6c 77 65 62 7d 2e 20 49 |te{funne|lweb}. I|
|00000b50| 6e 73 70 69 72 65 64 20 | 62 79 20 74 68 65 20 76 |nspired |by the v|
|00000b60| 65 72 73 61 74 69 6c 69 | 74 79 20 6f 66 20 46 75 |ersatili|ty of Fu|
|00000b70| 6e 6e 65 6c 57 65 62 20 | 61 6e 64 20 62 79 20 74 |nnelWeb |and by t|
|00000b80| 68 65 0a 64 61 75 6e 74 | 69 6e 67 20 73 69 7a 65 |he.daunt|ing size|
|00000b90| 20 6f 66 20 69 74 73 20 | 64 6f 63 75 6d 65 6e 74 | of its |document|
|00000ba0| 61 74 69 6f 6e 2c 20 49 | 20 64 65 63 69 64 65 64 |ation, I| decided|
|00000bb0| 20 74 6f 20 77 72 69 74 | 65 20 6d 79 20 6f 77 6e | to writ|e my own|
|00000bc0| 2c 20 76 65 72 79 20 73 | 69 6d 70 6c 65 2c 0a 74 |, very s|imple,.t|
|00000bd0| 6f 6f 6c 20 66 6f 72 20 | 6c 69 74 65 72 61 74 65 |ool for |literate|
|00000be0| 20 70 72 6f 67 72 61 6d | 6d 69 6e 67 2e 25 0a 5c | program|ming.%.\|
|00000bf0| 66 6f 6f 74 6e 6f 74 65 | 7b 54 68 65 72 65 20 69 |footnote|{There i|
|00000c00| 73 20 61 6e 6f 74 68 65 | 72 20 73 79 73 74 65 6d |s anothe|r system|
|00000c10| 20 73 69 6d 69 6c 61 72 | 20 74 6f 20 6d 69 6e 65 | similar| to mine|
|00000c20| 2c 20 77 72 69 74 74 65 | 6e 20 62 79 20 4e 6f 72 |, writte|n by Nor|
|00000c30| 6d 61 6e 20 52 61 6d 73 | 65 79 2c 0a 63 61 6c 6c |man Rams|ey,.call|
|00000c40| 65 64 20 6e 6f 77 65 62 | 7e 5c 63 69 74 65 7b 6e |ed noweb|~\cite{n|
|00000c50| 6f 77 65 62 7d 2e 20 49 | 74 20 70 65 72 68 61 70 |oweb}. I|t perhap|
|00000c60| 73 20 73 75 66 66 65 72 | 73 20 66 72 6f 6d 20 62 |s suffer|s from b|
|00000c70| 65 69 6e 67 20 6f 76 65 | 72 6c 79 0a 55 6e 69 78 |eing ove|rly.Unix|
|00000c80| 2d 64 65 70 65 6e 64 65 | 6e 74 20 61 6e 64 20 72 |-depende|nt and r|
|00000c90| 65 71 75 69 72 69 6e 67 | 20 73 65 76 65 72 61 6c |equiring| several|
|00000ca0| 20 70 72 6f 67 72 61 6d | 73 20 74 6f 20 75 73 65 | program|s to use|
|00000cb0| 2e 20 4f 6e 20 74 68 65 | 20 6f 74 68 65 72 20 68 |. On the| other h|
|00000cc0| 61 6e 64 2c 20 69 74 73 | 0a 63 6f 6d 6d 61 6e 64 |and, its|.command|
|00000cd0| 20 73 79 6e 74 61 78 20 | 69 73 20 76 65 72 79 20 | syntax |is very |
|00000ce0| 6e 69 63 65 2e 20 49 6e | 20 61 6e 79 20 63 61 73 |nice. In| any cas|
|00000cf0| 65 2c 20 6e 75 77 65 62 | 20 63 65 72 74 61 69 6e |e, nuweb| certain|
|00000d00| 6c 79 20 6f 77 65 73 20 | 69 74 73 20 6e 61 6d 65 |ly owes |its name|
|00000d10| 20 61 6e 64 20 61 0a 6e | 75 6d 62 65 72 20 6f 66 | and a.n|umber of|
|00000d20| 20 66 65 61 74 75 72 65 | 73 20 74 6f 20 68 69 73 | feature|s to his|
|00000d30| 20 69 6e 73 70 69 72 61 | 74 69 6f 6e 2e 7d 0a 0a | inspira|tion.}..|
|00000d40| 0a 0a 5c 73 65 63 74 69 | 6f 6e 7b 4e 75 77 65 62 |..\secti|on{Nuweb|
|00000d50| 7d 0a 0a 4e 75 77 65 62 | 20 77 6f 72 6b 73 20 77 |}..Nuweb| works w|
|00000d60| 69 74 68 20 61 6e 79 20 | 70 72 6f 67 72 61 6d 6d |ith any |programm|
|00000d70| 69 6e 67 20 6c 61 6e 67 | 75 61 67 65 20 61 6e 64 |ing lang|uage and|
|00000d80| 20 5c 4c 61 54 65 58 65 | 7e 5c 63 69 74 65 7b 6c | \LaTeXe|~\cite{l|
|00000d90| 61 74 65 78 7d 2e 20 28 | 45 61 72 6c 69 65 72 0a |atex}. (|Earlier.|
|00000da0| 76 65 72 73 69 6f 6e 73 | 20 6f 66 20 6e 75 77 65 |versions| of nuwe|
|00000db0| 62 20 77 6f 72 6b 20 77 | 69 74 68 20 5c 4c 61 54 |b work w|ith \LaT|
|00000dc0| 65 58 32 2e 30 39 2e 29 | 20 49 20 77 61 6e 74 65 |eX2.09.)| I wante|
|00000dd0| 64 20 74 6f 20 75 73 65 | 20 5c 4c 61 54 65 58 5c |d to use| \LaTeX\|
|00000de0| 20 62 65 63 61 75 73 65 | 20 69 74 0a 73 75 70 70 | because| it.supp|
|00000df0| 6f 72 74 73 20 61 20 6d | 75 6c 74 69 2d 6c 65 76 |orts a m|ulti-lev|
|00000e00| 65 6c 20 73 65 63 74 69 | 6f 6e 69 6e 67 20 73 63 |el secti|oning sc|
|00000e10| 68 65 6d 65 20 61 6e 64 | 20 68 61 73 20 66 61 63 |heme and| has fac|
|00000e20| 69 6c 69 74 69 65 73 20 | 66 6f 72 20 64 72 61 77 |ilities |for draw|
|00000e30| 69 6e 67 0a 66 69 67 75 | 72 65 73 2e 20 49 20 77 |ing.figu|res. I w|
|00000e40| 61 6e 74 65 64 20 74 6f | 20 62 65 20 61 62 6c 65 |anted to| be able|
|00000e50| 20 74 6f 20 77 6f 72 6b | 20 77 69 74 68 20 61 72 | to work| with ar|
|00000e60| 62 69 74 72 61 72 79 20 | 70 72 6f 67 72 61 6d 6d |bitrary |programm|
|00000e70| 69 6e 67 20 6c 61 6e 67 | 75 61 67 65 73 0a 62 65 |ing lang|uages.be|
|00000e80| 63 61 75 73 65 20 6d 79 | 20 66 72 69 65 6e 64 73 |cause my| friends|
|00000e90| 20 61 6e 64 20 49 20 77 | 72 69 74 65 20 70 72 6f | and I w|rite pro|
|00000ea0| 67 72 61 6d 73 20 69 6e | 20 6d 61 6e 79 20 6c 61 |grams in| many la|
|00000eb0| 6e 67 75 61 67 65 73 20 | 28 61 6e 64 20 73 6f 6d |nguages |(and som|
|00000ec0| 65 74 69 6d 65 73 0a 63 | 6f 6d 62 69 6e 61 74 69 |etimes.c|ombinati|
|00000ed0| 6f 6e 73 20 6f 66 20 73 | 65 76 65 72 61 6c 20 6c |ons of s|everal l|
|00000ee0| 61 6e 67 75 61 67 65 73 | 29 2c 20 73 75 63 68 20 |anguages|), such |
|00000ef0| 61 73 20 43 2c 20 46 6f | 72 74 72 61 6e 2c 20 43 |as C, Fo|rtran, C|
|00000f00| 2b 2b 2c 20 79 61 63 63 | 2c 20 6c 65 78 2c 0a 53 |++, yacc|, lex,.S|
|00000f10| 63 68 65 6d 65 2c 20 61 | 73 73 65 6d 62 6c 79 2c |cheme, a|ssembly,|
|00000f20| 20 50 6f 73 74 73 63 72 | 69 70 74 2c 20 61 6e 64 | Postscr|ipt, and|
|00000f30| 20 73 6f 20 66 6f 72 74 | 68 2e 20 54 68 65 20 6e | so fort|h. The n|
|00000f40| 65 65 64 20 74 6f 20 73 | 75 70 70 6f 72 74 20 61 |eed to s|upport a|
|00000f50| 72 62 69 74 72 61 72 79 | 0a 70 72 6f 67 72 61 6d |rbitrary|.program|
|00000f60| 6d 69 6e 67 20 6c 61 6e | 67 75 61 67 65 73 20 68 |ming lan|guages h|
|00000f70| 61 73 20 6d 61 6e 79 20 | 63 6f 6e 73 65 71 75 65 |as many |conseque|
|00000f80| 6e 63 65 73 3a 0a 5c 62 | 65 67 69 6e 7b 64 65 73 |nces:.\b|egin{des|
|00000f90| 63 72 69 70 74 69 6f 6e | 7d 0a 5c 69 74 65 6d 5b |cription|}.\item[|
|00000fa0| 4e 6f 20 70 72 65 74 74 | 79 20 70 72 69 6e 74 69 |No prett|y printi|
|00000fb0| 6e 67 5d 20 42 6f 74 68 | 20 7c 57 45 42 7c 20 61 |ng] Both| |WEB| a|
|00000fc0| 6e 64 20 7c 43 57 45 42 | 7c 20 61 72 65 20 61 62 |nd |CWEB|| are ab|
|00000fd0| 6c 65 20 74 6f 0a 20 20 | 70 72 65 74 74 79 20 70 |le to. |pretty p|
|00000fe0| 72 69 6e 74 20 74 68 65 | 20 63 6f 64 65 20 73 65 |rint the| code se|
|00000ff0| 63 74 69 6f 6e 73 20 6f | 66 20 74 68 65 69 72 20 |ctions o|f their |
|00001000| 64 6f 63 75 6d 65 6e 74 | 73 20 62 65 63 61 75 73 |document|s becaus|
|00001010| 65 20 74 68 65 79 0a 20 | 20 75 6e 64 65 72 73 74 |e they. | underst|
|00001020| 61 6e 64 20 74 68 65 20 | 6c 61 6e 67 75 61 67 65 |and the |language|
|00001030| 20 77 65 6c 6c 20 65 6e | 6f 75 67 68 20 74 6f 20 | well en|ough to |
|00001040| 70 61 72 73 65 20 69 74 | 2e 20 53 69 6e 63 65 20 |parse it|. Since |
|00001050| 77 65 20 77 61 6e 74 20 | 74 6f 20 75 73 65 0a 20 |we want |to use. |
|00001060| 20 5c 65 6d 70 68 7b 61 | 6e 79 7d 20 6c 61 6e 67 | \emph{a|ny} lang|
|00001070| 75 61 67 65 2c 20 77 65 | 27 76 65 20 67 6f 74 20 |uage, we|'ve got |
|00001080| 74 6f 20 61 62 61 6e 64 | 6f 6e 20 74 68 69 73 20 |to aband|on this |
|00001090| 66 65 61 74 75 72 65 2e | 0a 5c 69 74 65 6d 5b 4d |feature.|.\item[M|
|000010a0| 61 6e 75 61 6c 20 69 6e | 64 65 78 69 6e 67 20 6f |anual in|dexing o|
|000010b0| 66 20 69 64 65 6e 74 69 | 66 69 65 72 73 5d 20 42 |f identi|fiers] B|
|000010c0| 65 63 61 75 73 65 20 7c | 57 45 42 7c 20 6b 6e 6f |ecause ||WEB| kno|
|000010d0| 77 73 20 61 62 6f 75 74 | 20 50 61 73 63 61 6c 2c |ws about| Pascal,|
|000010e0| 0a 20 20 69 74 20 69 73 | 20 61 62 6c 65 20 74 6f |. it is| able to|
|000010f0| 20 63 6f 6e 73 74 72 75 | 63 74 20 61 6e 20 69 6e | constru|ct an in|
|00001100| 64 65 78 20 6f 66 20 61 | 6c 6c 20 74 68 65 20 69 |dex of a|ll the i|
|00001110| 64 65 6e 74 69 66 69 65 | 72 73 20 6f 63 63 75 72 |dentifie|rs occur|
|00001120| 72 69 6e 67 20 69 6e 0a | 20 20 74 68 65 20 63 6f |ring in.| the co|
|00001130| 64 65 20 73 65 63 74 69 | 6f 6e 73 20 28 66 69 6c |de secti|ons (fil|
|00001140| 74 65 72 69 6e 67 20 6f | 75 74 20 6b 65 79 77 6f |tering o|ut keywo|
|00001150| 72 64 73 20 61 6e 64 20 | 74 68 65 20 73 74 61 6e |rds and |the stan|
|00001160| 64 61 72 64 20 74 79 70 | 65 0a 20 20 69 64 65 6e |dard typ|e. iden|
|00001170| 74 69 66 69 65 72 73 29 | 2e 20 55 6e 66 6f 72 74 |tifiers)|. Unfort|
|00001180| 75 6e 61 74 65 6c 79 2c | 20 74 68 69 73 20 69 73 |unately,| this is|
|00001190| 6e 27 74 20 61 73 20 65 | 61 73 79 20 69 6e 20 6f |n't as e|asy in o|
|000011a0| 75 72 20 63 61 73 65 2e | 20 57 65 20 64 6f 6e 27 |ur case.| We don'|
|000011b0| 74 0a 20 20 6b 6e 6f 77 | 20 77 68 61 74 20 61 6e |t. know| what an|
|000011c0| 20 69 64 65 6e 74 69 66 | 69 65 72 20 6c 6f 6f 6b | identif|ier look|
|000011d0| 73 20 6c 69 6b 65 20 69 | 6e 20 65 61 63 68 20 6c |s like i|n each l|
|000011e0| 61 6e 67 75 61 67 65 20 | 61 6e 64 20 77 65 20 63 |anguage |and we c|
|000011f0| 65 72 74 61 69 6e 6c 79 | 0a 20 20 64 6f 6e 27 74 |ertainly|. don't|
|00001200| 20 6b 6e 6f 77 20 61 6c | 6c 20 74 68 65 20 6b 65 | know al|l the ke|
|00001210| 79 77 6f 72 64 73 2e 20 | 28 4f 6e 20 74 68 65 20 |ywords. |(On the |
|00001220| 6f 74 68 65 72 20 68 61 | 6e 64 2c 20 73 65 65 20 |other ha|nd, see |
|00001230| 74 68 65 20 65 6e 64 20 | 6f 66 0a 20 20 73 65 63 |the end |of. sec|
|00001240| 74 69 6f 6e 7e 5c 72 65 | 66 7b 77 72 69 74 69 6e |tion~\re|f{writin|
|00001250| 67 6e 75 77 65 62 7d 2e | 29 0a 5c 65 6e 64 7b 64 |gnuweb}.|).\end{d|
|00001260| 65 73 63 72 69 70 74 69 | 6f 6e 7d 0a 4f 66 20 63 |escripti|on}.Of c|
|00001270| 6f 75 72 73 65 2c 20 77 | 65 27 76 65 20 67 6f 74 |ourse, w|e've got|
|00001280| 20 74 6f 20 68 61 76 65 | 20 73 6f 6d 65 20 63 6f | to have| some co|
|00001290| 6d 70 65 6e 73 61 74 69 | 6f 6e 20 66 6f 72 20 6f |mpensati|on for o|
|000012a0| 75 72 20 6c 6f 73 73 65 | 73 20 6f 72 20 74 68 65 |ur losse|s or the|
|000012b0| 20 77 68 6f 6c 65 0a 69 | 64 65 61 20 77 6f 75 6c | whole.i|dea woul|
|000012c0| 64 20 62 65 20 61 20 77 | 61 73 74 65 2e 20 48 65 |d be a w|aste. He|
|000012d0| 72 65 20 61 72 65 20 74 | 68 65 20 61 64 76 61 6e |re are t|he advan|
|000012e0| 74 61 67 65 73 20 49 20 | 63 61 6e 20 73 65 65 3a |tages I |can see:|
|000012f0| 0a 5c 62 65 67 69 6e 7b | 64 65 73 63 72 69 70 74 |.\begin{|descript|
|00001300| 69 6f 6e 7d 0a 5c 69 74 | 65 6d 5b 53 69 6d 70 6c |ion}.\it|em[Simpl|
|00001310| 69 63 69 74 79 5d 20 54 | 68 65 20 6d 61 6a 6f 72 |icity] T|he major|
|00001320| 69 74 79 20 6f 66 20 74 | 68 65 20 63 6f 6d 6d 61 |ity of t|he comma|
|00001330| 6e 64 73 20 69 6e 20 7c | 57 45 42 7c 20 61 72 65 |nds in ||WEB| are|
|00001340| 0a 20 20 63 6f 6e 63 65 | 72 6e 65 64 20 77 69 74 |. conce|rned wit|
|00001350| 68 20 63 6f 6e 74 72 6f | 6c 20 6f 66 20 74 68 65 |h contro|l of the|
|00001360| 20 61 75 74 6f 6d 61 74 | 69 63 20 70 72 65 74 74 | automat|ic prett|
|00001370| 79 20 70 72 69 6e 74 69 | 6e 67 2e 20 53 69 6e 63 |y printi|ng. Sinc|
|00001380| 65 20 77 65 0a 20 20 64 | 6f 6e 27 74 20 70 72 65 |e we. d|on't pre|
|00001390| 74 74 79 20 70 72 69 6e | 74 2c 20 6d 61 6e 79 20 |tty prin|t, many |
|000013a0| 63 6f 6d 6d 61 6e 64 73 | 20 61 72 65 20 65 6c 69 |commands| are eli|
|000013b0| 6d 69 6e 61 74 65 64 2e | 20 41 20 66 75 72 74 68 |minated.| A furth|
|000013c0| 65 72 20 73 65 74 20 6f | 66 0a 20 20 63 6f 6d 6d |er set o|f. comm|
|000013d0| 61 6e 64 73 20 69 73 20 | 73 75 62 73 75 6d 65 64 |ands is |subsumed|
|000013e0| 20 62 79 20 5c 4c 61 54 | 65 58 5c 20 61 6e 64 20 | by \LaT|eX\ and |
|000013f0| 6d 61 79 20 61 6c 73 6f | 20 62 65 20 65 6c 69 6d |may also| be elim|
|00001400| 69 6e 61 74 65 64 2e 20 | 41 73 20 61 0a 20 20 72 |inated. |As a. r|
|00001410| 65 73 75 6c 74 2c 20 6f | 75 72 20 73 65 74 20 6f |esult, o|ur set o|
|00001420| 66 20 63 6f 6d 6d 61 6e | 64 73 20 69 73 20 72 65 |f comman|ds is re|
|00001430| 64 75 63 65 64 20 74 6f | 20 6f 6e 6c 79 20 66 6f |duced to| only fo|
|00001440| 75 72 20 6d 65 6d 62 65 | 72 73 2e 20 54 68 69 73 |ur membe|rs. This|
|00001450| 0a 20 20 73 69 6d 70 6c | 69 63 69 74 79 20 69 73 |. simpl|icity is|
|00001460| 20 61 6c 73 6f 20 72 65 | 66 6c 65 63 74 65 64 20 | also re|flected |
|00001470| 69 6e 20 74 68 65 20 73 | 69 7a 65 20 6f 66 20 74 |in the s|ize of t|
|00001480| 68 69 73 20 74 6f 6f 6c | 2c 20 77 68 69 63 68 20 |his tool|, which |
|00001490| 69 73 20 71 75 69 74 65 | 20 61 20 62 69 74 0a 20 |is quite| a bit. |
|000014a0| 20 73 6d 61 6c 6c 65 72 | 20 74 68 61 6e 20 74 68 | smaller| than th|
|000014b0| 65 20 74 6f 6f 6c 73 20 | 75 73 65 64 20 77 69 74 |e tools |used wit|
|000014c0| 68 20 6f 74 68 65 72 20 | 61 70 70 72 6f 61 63 68 |h other |approach|
|000014d0| 65 73 2e 0a 5c 69 74 65 | 6d 5b 4e 6f 20 70 72 65 |es..\ite|m[No pre|
|000014e0| 74 74 79 20 70 72 69 6e | 74 69 6e 67 5d 20 45 76 |tty prin|ting] Ev|
|000014f0| 65 72 79 6f 6e 65 20 64 | 69 73 61 67 72 65 65 73 |eryone d|isagrees|
|00001500| 20 61 62 6f 75 74 20 68 | 6f 77 20 74 68 65 69 72 | about h|ow their|
|00001510| 20 63 6f 64 65 0a 20 20 | 73 68 6f 75 6c 64 20 6c | code. |should l|
|00001520| 6f 6f 6b 2c 20 73 6f 20 | 61 75 74 6f 6d 61 74 69 |ook, so |automati|
|00001530| 63 20 66 6f 72 6d 61 74 | 74 69 6e 67 20 61 6e 6e |c format|ting ann|
|00001540| 6f 79 73 20 6d 61 6e 79 | 20 70 65 6f 70 6c 65 2e |oys many| people.|
|00001550| 20 4f 6e 65 20 61 70 70 | 72 6f 61 63 68 0a 20 20 | One app|roach. |
|00001560| 69 73 20 74 6f 20 70 72 | 6f 76 69 64 65 20 77 61 |is to pr|ovide wa|
|00001570| 79 73 20 74 6f 20 63 6f | 6e 74 72 6f 6c 20 74 68 |ys to co|ntrol th|
|00001580| 65 20 66 6f 72 6d 61 74 | 74 69 6e 67 2e 20 4f 75 |e format|ting. Ou|
|00001590| 72 20 61 70 70 72 6f 61 | 63 68 20 69 73 0a 20 20 |r approa|ch is. |
|000015a0| 73 69 6d 70 6c 65 72 2d | 2d 2d 77 65 20 70 65 72 |simpler-|--we per|
|000015b0| 66 6f 72 6d 20 6e 6f 20 | 61 75 74 6f 6d 61 74 69 |form no |automati|
|000015c0| 63 20 66 6f 72 6d 61 74 | 74 69 6e 67 20 61 6e 64 |c format|ting and|
|000015d0| 20 74 68 65 72 65 66 6f | 72 65 20 61 6c 6c 6f 77 | therefo|re allow|
|000015e0| 20 74 68 65 0a 20 20 70 | 72 6f 67 72 61 6d 6d 65 | the. p|rogramme|
|000015f0| 72 20 63 6f 6d 70 6c 65 | 74 65 20 63 6f 6e 74 72 |r comple|te contr|
|00001600| 6f 6c 20 6f 66 20 63 6f | 64 65 20 6c 61 79 6f 75 |ol of co|de layou|
|00001610| 74 2e 0a 5c 69 74 65 6d | 5b 43 6f 6e 74 72 6f 6c |t..\item|[Control|
|00001620| 5d 20 57 65 20 61 6c 73 | 6f 20 6f 66 66 65 72 20 |] We als|o offer |
|00001630| 74 68 65 20 70 72 6f 67 | 72 61 6d 6d 65 72 20 63 |the prog|rammer c|
|00001640| 6f 6d 70 6c 65 74 65 20 | 63 6f 6e 74 72 6f 6c 20 |omplete |control |
|00001650| 6f 66 20 74 68 65 0a 20 | 20 6c 61 79 6f 75 74 20 |of the. | layout |
|00001660| 6f 66 20 68 69 73 20 70 | 72 6f 67 72 61 6d 20 66 |of his p|rogram f|
|00001670| 69 6c 65 73 20 28 74 68 | 65 20 66 69 6c 65 73 20 |iles (th|e files |
|00001680| 67 65 6e 65 72 61 74 65 | 64 20 64 75 72 69 6e 67 |generate|d during|
|00001690| 20 74 61 6e 67 6c 69 6e | 67 29 2e 20 4f 66 0a 20 | tanglin|g). Of. |
|000016a0| 20 63 6f 75 72 73 65 2c | 20 74 68 69 73 20 69 73 | course,| this is|
|000016b0| 20 65 73 73 65 6e 74 69 | 61 6c 20 66 6f 72 20 6c | essenti|al for l|
|000016c0| 61 6e 67 75 61 67 65 73 | 20 74 68 61 74 20 61 72 |anguages| that ar|
|000016d0| 65 20 73 65 6e 73 69 74 | 69 76 65 20 74 6f 20 6c |e sensit|ive to l|
|000016e0| 61 79 6f 75 74 3b 0a 20 | 20 62 75 74 20 69 74 20 |ayout;. | but it |
|000016f0| 69 73 20 61 6c 73 6f 20 | 69 6d 70 6f 72 74 61 6e |is also |importan|
|00001700| 74 20 69 6e 20 6d 61 6e | 79 20 70 72 61 63 74 69 |t in man|y practi|
|00001710| 63 61 6c 20 73 69 74 75 | 61 74 69 6f 6e 73 2c 20 |cal situ|ations, |
|00001720| 73 75 63 68 20 61 73 0a | 20 20 64 65 62 75 67 67 |such as.| debugg|
|00001730| 69 6e 67 2e 0a 5c 69 74 | 65 6d 5b 53 70 65 65 64 |ing..\it|em[Speed|
|00001740| 5d 20 53 69 6e 63 65 20 | 6e 75 77 65 62 20 64 6f |] Since |nuweb do|
|00001750| 65 73 6e 27 74 20 64 6f | 20 74 6f 6f 20 6d 75 63 |esn't do| too muc|
|00001760| 68 2c 20 74 68 65 20 6e | 75 77 65 62 20 74 6f 6f |h, the n|uweb too|
|00001770| 6c 20 72 75 6e 73 0a 20 | 20 71 75 69 63 6b 6c 79 |l runs. | quickly|
|00001780| 2e 20 49 20 63 6f 6d 62 | 69 6e 65 20 74 68 65 20 |. I comb|ine the |
|00001790| 66 75 6e 63 74 69 6f 6e | 73 20 6f 66 20 7c 74 61 |function|s of |ta|
|000017a0| 6e 67 6c 65 7c 20 61 6e | 64 20 7c 77 65 61 76 65 |ngle| an|d |weave|
|000017b0| 7c 20 69 6e 74 6f 0a 20 | 20 61 20 73 69 6e 67 6c || into. | a singl|
|000017c0| 65 20 70 72 6f 67 72 61 | 6d 20 74 68 61 74 20 70 |e progra|m that p|
|000017d0| 65 72 66 6f 72 6d 73 20 | 62 6f 74 68 20 66 75 6e |erforms |both fun|
|000017e0| 63 74 69 6f 6e 73 20 61 | 74 20 6f 6e 63 65 2e 0a |ctions a|t once..|
|000017f0| 5c 69 74 65 6d 5b 50 61 | 67 65 20 6e 75 6d 62 65 |\item[Pa|ge numbe|
|00001800| 72 73 5d 20 49 6e 73 70 | 69 72 65 64 20 62 79 20 |rs] Insp|ired by |
|00001810| 74 68 65 20 65 78 61 6d | 70 6c 65 20 6f 66 20 6e |the exam|ple of n|
|00001820| 6f 77 65 62 2c 20 6e 75 | 77 65 62 20 72 65 66 65 |oweb, nu|web refe|
|00001830| 72 73 20 74 6f 0a 20 20 | 61 6c 6c 20 73 63 72 61 |rs to. |all scra|
|00001840| 70 73 20 62 79 20 70 61 | 67 65 20 6e 75 6d 62 65 |ps by pa|ge numbe|
|00001850| 72 20 74 6f 20 73 69 6d | 70 6c 69 66 79 20 6e 61 |r to sim|plify na|
|00001860| 76 69 67 61 74 69 6f 6e | 2e 20 49 66 20 74 68 65 |vigation|. If the|
|00001870| 72 65 20 61 72 65 0a 20 | 20 6d 75 6c 74 69 70 6c |re are. | multipl|
|00001880| 65 20 73 63 72 61 70 73 | 20 6f 6e 20 61 20 70 61 |e scraps| on a pa|
|00001890| 67 65 20 28 73 61 79 20 | 70 61 67 65 7e 31 37 29 |ge (say |page~17)|
|000018a0| 2c 20 74 68 65 79 20 61 | 72 65 20 64 69 73 74 69 |, they a|re disti|
|000018b0| 6e 67 75 69 73 68 65 64 | 20 62 79 0a 20 20 6c 6f |nguished| by. lo|
|000018c0| 77 65 72 2d 63 61 73 65 | 20 6c 65 74 74 65 72 73 |wer-case| letters|
|000018d0| 3a 20 31 37 61 2c 20 31 | 37 62 2c 20 61 6e 64 20 |: 17a, 1|7b, and |
|000018e0| 73 6f 20 66 6f 72 74 68 | 29 2e 0a 5c 69 74 65 6d |so forth|)..\item|
|000018f0| 5b 4d 75 6c 74 69 70 6c | 65 20 66 69 6c 65 20 6f |[Multipl|e file o|
|00001900| 75 74 70 75 74 5d 20 54 | 68 65 20 70 72 6f 67 72 |utput] T|he progr|
|00001910| 61 6d 6d 65 72 20 6d 61 | 79 20 73 70 65 63 69 66 |ammer ma|y specif|
|00001920| 79 20 6d 6f 72 65 20 74 | 68 61 6e 20 6f 6e 65 0a |y more t|han one.|
|00001930| 20 20 70 72 6f 67 72 61 | 6d 20 66 69 6c 65 20 69 | progra|m file i|
|00001940| 6e 20 61 20 73 69 6e 67 | 6c 65 20 6e 75 77 65 62 |n a sing|le nuweb|
|00001950| 20 66 69 6c 65 2e 20 54 | 68 69 73 20 69 73 20 72 | file. T|his is r|
|00001960| 65 71 75 69 72 65 64 20 | 77 68 65 6e 20 63 6f 6e |equired |when con|
|00001970| 73 74 72 75 63 74 69 6e | 67 0a 20 20 70 72 6f 67 |structin|g. prog|
|00001980| 72 61 6d 73 20 69 6e 20 | 61 20 63 6f 6d 62 69 6e |rams in |a combin|
|00001990| 61 74 69 6f 6e 20 6f 66 | 20 6c 61 6e 67 75 61 67 |ation of| languag|
|000019a0| 65 73 20 28 73 61 79 2c | 20 46 6f 72 74 72 61 6e |es (say,| Fortran|
|000019b0| 20 61 6e 64 20 43 29 5c | 40 40 2e 20 49 74 27 73 | and C)\|@@. It's|
|000019c0| 20 61 6c 73 6f 0a 20 20 | 61 6e 20 61 64 76 61 6e | also. |an advan|
|000019d0| 74 61 67 65 20 77 68 65 | 6e 20 63 6f 6e 73 74 72 |tage whe|n constr|
|000019e0| 75 63 74 69 6e 67 20 76 | 65 72 79 20 6c 61 72 67 |ucting v|ery larg|
|000019f0| 65 20 70 72 6f 67 72 61 | 6d 73 20 74 68 61 74 20 |e progra|ms that |
|00001a00| 77 6f 75 6c 64 20 72 65 | 71 75 69 72 65 0a 20 20 |would re|quire. |
|00001a10| 61 20 6c 6f 74 20 6f 66 | 20 63 6f 6d 70 69 6c 65 |a lot of| compile|
|00001a20| 20 74 69 6d 65 2e 0a 5c | 65 6e 64 7b 64 65 73 63 | time..\|end{desc|
|00001a30| 72 69 70 74 69 6f 6e 7d | 0a 0a 5c 6c 61 62 65 6c |ription}|..\label|
|00001a40| 7b 64 75 6d 6d 79 7d 0a | 41 20 66 75 72 74 68 65 |{dummy}.|A furthe|
|00001a50| 72 20 72 65 64 75 63 74 | 69 6f 6e 20 69 6e 20 63 |r reduct|ion in c|
|00001a60| 6f 6d 70 69 6c 61 74 69 | 6f 6e 20 74 69 6d 65 20 |ompilati|on time |
|00001a70| 69 73 20 61 63 68 69 65 | 76 65 64 20 62 79 20 66 |is achie|ved by f|
|00001a80| 69 72 73 74 20 77 72 69 | 74 69 6e 67 20 65 61 63 |irst wri|ting eac|
|00001a90| 68 0a 70 72 6f 67 72 61 | 6d 20 66 69 6c 65 20 74 |h.progra|m file t|
|00001aa0| 6f 20 61 20 74 65 6d 70 | 6f 72 61 72 79 20 6c 6f |o a temp|orary lo|
|00001ab0| 63 61 74 69 6f 6e 2c 20 | 74 68 65 6e 20 63 6f 6d |cation, |then com|
|00001ac0| 70 61 72 69 6e 67 20 74 | 68 65 20 74 65 6d 70 6f |paring t|he tempo|
|00001ad0| 72 61 72 79 20 66 69 6c | 65 20 77 69 74 68 0a 74 |rary fil|e with.t|
|00001ae0| 68 65 20 6f 6c 64 20 76 | 65 72 73 69 6f 6e 20 6f |he old v|ersion o|
|00001af0| 66 20 74 68 65 20 66 69 | 6c 65 2e 20 49 66 20 74 |f the fi|le. If t|
|00001b00| 68 65 72 65 20 69 73 20 | 6e 6f 20 64 69 66 66 65 |here is |no diffe|
|00001b10| 72 65 6e 63 65 2c 20 74 | 68 65 20 74 65 6d 70 6f |rence, t|he tempo|
|00001b20| 72 61 72 79 20 66 69 6c | 65 0a 63 61 6e 20 62 65 |rary fil|e.can be|
|00001b30| 20 64 65 6c 65 74 65 64 | 2e 20 49 66 20 74 68 65 | deleted|. If the|
|00001b40| 20 66 69 6c 65 73 20 64 | 69 66 66 65 72 2c 20 74 | files d|iffer, t|
|00001b50| 68 65 20 6f 6c 64 20 76 | 65 72 73 69 6f 6e 20 69 |he old v|ersion i|
|00001b60| 73 20 64 65 6c 65 74 65 | 64 20 61 6e 64 20 74 68 |s delete|d and th|
|00001b70| 65 0a 74 65 6d 70 6f 72 | 61 72 79 20 66 69 6c 65 |e.tempor|ary file|
|00001b80| 20 72 65 6e 61 6d 65 64 | 2e 20 54 68 69 73 20 61 | renamed|. This a|
|00001b90| 70 70 72 6f 61 63 68 20 | 77 6f 72 6b 73 20 77 65 |pproach |works we|
|00001ba0| 6c 6c 20 69 6e 20 63 6f | 6d 62 69 6e 61 74 69 6f |ll in co|mbinatio|
|00001bb0| 6e 20 77 69 74 68 0a 7c | 6d 61 6b 65 7c 20 28 6f |n with.||make| (o|
|00001bc0| 72 20 73 69 6d 69 6c 61 | 72 20 74 6f 6f 6c 73 29 |r simila|r tools)|
|00001bd0| 2c 20 73 69 6e 63 65 20 | 7c 6d 61 6b 65 7c 20 77 |, since ||make| w|
|00001be0| 69 6c 6c 20 61 76 6f 69 | 64 20 72 65 63 6f 6d 70 |ill avoi|d recomp|
|00001bf0| 69 6c 69 6e 67 0a 75 6e | 74 6f 75 63 68 65 64 20 |iling.un|touched |
|00001c00| 70 72 6f 67 72 61 6d 20 | 66 69 6c 65 73 2e 20 48 |program |files. H|
|00001c10| 6f 77 65 76 65 72 2c 20 | 74 68 69 73 20 64 6f 65 |owever, |this doe|
|00001c20| 73 20 6d 65 61 6e 20 74 | 68 61 74 20 79 6f 75 20 |s mean t|hat you |
|00001c30| 6d 75 73 74 20 72 75 6e | 20 6e 75 77 65 62 0a 6d |must run| nuweb.m|
|00001c40| 61 6e 75 61 6c 6c 79 20 | 77 68 65 6e 65 76 65 72 |anually |whenever|
|00001c50| 20 79 6f 75 20 65 64 69 | 74 20 79 6f 75 72 20 77 | you edi|t your w|
|00001c60| 65 62 20 66 69 6c 65 20 | 28 6f 72 20 72 75 6e 20 |eb file |(or run |
|00001c70| 69 74 20 61 75 74 6f 6d | 61 74 69 63 61 6c 6c 79 |it autom|atically|
|00001c80| 20 65 76 65 72 79 20 74 | 69 6d 65 0a 79 6f 75 20 | every t|ime.you |
|00001c90| 75 73 65 20 7c 6d 61 6b | 65 7c 29 2e 20 41 20 73 |use |mak|e|). A s|
|00001ca0| 6f 6c 75 74 69 6f 6e 20 | 69 73 20 74 6f 20 70 72 |olution |is to pr|
|00001cb0| 6f 64 75 63 65 20 61 20 | 64 75 6d 6d 79 20 70 72 |oduce a |dummy pr|
|00001cc0| 6f 67 72 61 6d 20 66 69 | 6c 65 2c 20 73 61 79 0a |ogram fi|le, say.|
|00001cd0| 7c 64 75 6d 6d 79 7c 2c | 20 61 6e 64 20 61 64 64 ||dummy|,| and add|
|00001ce0| 20 61 20 72 75 6c 65 20 | 74 6f 20 74 68 65 20 6d | a rule |to the m|
|00001cf0| 61 6b 65 66 69 6c 65 20 | 6c 69 6b 65 3a 0a 5c 62 |akefile |like:.\b|
|00001d00| 65 67 69 6e 7b 76 65 72 | 62 61 74 69 6d 7d 0a 64 |egin{ver|batim}.d|
|00001d10| 75 6d 6d 79 3a 20 77 65 | 62 2e 77 0a 20 20 20 20 |ummy: we|b.w. |
|00001d20| 20 20 20 20 72 6d 20 64 | 75 6d 6d 79 0a 20 20 20 | rm d|ummy. |
|00001d30| 20 20 20 20 20 6e 75 77 | 65 62 20 77 65 62 2e 77 | nuw|eb web.w|
|00001d40| 0a 5c 65 6e 64 7b 76 65 | 72 62 61 74 69 6d 7d 0a |.\end{ve|rbatim}.|
|00001d50| 49 66 20 7c 64 75 6d 6d | 79 7c 20 69 73 20 6d 61 |If |dumm|y| is ma|
|00001d60| 64 65 20 61 20 64 65 70 | 65 6e 64 65 6e 74 20 6f |de a dep|endent o|
|00001d70| 66 20 7c 2e 49 4e 49 54 | 7c 20 6f 72 20 73 6f 6d |f |.INIT|| or som|
|00001d80| 65 20 6f 74 68 65 72 20 | 74 61 72 67 65 74 20 74 |e other |target t|
|00001d90| 68 61 74 0a 69 73 20 6d | 61 64 65 20 65 76 65 72 |hat.is m|ade ever|
|00001da0| 79 20 74 69 6d 65 20 74 | 68 61 74 20 7c 6d 61 6b |y time t|hat |mak|
|00001db0| 65 7c 20 69 73 20 72 75 | 6e 2c 20 74 68 65 6e 20 |e| is ru|n, then |
|00001dc0| 74 68 65 20 77 65 62 20 | 66 69 6c 65 20 77 69 6c |the web |file wil|
|00001dd0| 6c 0a 61 75 74 6f 6d 61 | 74 69 63 61 6c 6c 79 20 |l.automa|tically |
|00001de0| 62 65 20 72 65 70 72 6f | 63 65 73 73 65 64 20 77 |be repro|cessed w|
|00001df0| 68 65 6e 65 76 65 72 20 | 69 74 20 69 73 20 63 68 |henever |it is ch|
|00001e00| 61 6e 67 65 64 2e 20 54 | 68 65 20 63 6f 6d 6d 61 |anged. T|he comma|
|00001e10| 6e 64 0a 7c 72 6d 20 64 | 75 6d 6d 79 7c 20 69 73 |nd.|rm d|ummy| is|
|00001e20| 20 6e 65 65 64 65 64 20 | 74 6f 20 6d 61 6b 65 20 | needed |to make |
|00001e30| 73 75 72 65 20 74 68 61 | 74 20 74 68 65 20 66 69 |sure tha|t the fi|
|00001e40| 6c 65 20 69 73 20 72 65 | 77 72 69 74 74 65 6e 20 |le is re|written |
|00001e50| 65 76 65 72 79 20 74 69 | 6d 65 0a 74 68 65 20 77 |every ti|me.the w|
|00001e60| 65 62 20 69 73 20 70 72 | 6f 63 65 73 73 65 64 2e |eb is pr|ocessed.|
|00001e70| 0a 0a 49 66 20 79 6f 75 | 20 74 61 6b 65 20 61 20 |..If you| take a |
|00001e80| 6d 6f 72 65 20 6d 6f 64 | 75 6c 61 72 20 61 70 70 |more mod|ular app|
|00001e90| 72 6f 61 63 68 2c 20 61 | 6e 64 20 6f 6e 6c 79 20 |roach, a|nd only |
|00001ea0| 67 65 6e 65 72 61 74 65 | 20 6f 6e 65 20 70 72 6f |generate| one pro|
|00001eb0| 67 72 61 6d 20 66 69 6c | 65 20 66 72 6f 6d 0a 65 |gram fil|e from.e|
|00001ec0| 61 63 68 20 77 65 62 20 | 66 69 6c 65 2c 20 69 74 |ach web |file, it|
|00001ed0| 20 69 73 20 62 65 74 74 | 65 72 20 74 6f 20 69 6e | is bett|er to in|
|00001ee0| 74 72 6f 64 75 63 65 20 | 61 6e 20 69 6d 70 6c 69 |troduce |an impli|
|00001ef0| 63 69 74 20 72 75 6c 65 | 20 66 6f 72 20 6d 61 6b |cit rule| for mak|
|00001f00| 69 6e 67 20 70 72 6f 67 | 72 61 6d 0a 66 69 6c 65 |ing prog|ram.file|
|00001f10| 73 20 66 72 6f 6d 20 77 | 65 62 20 66 69 6c 65 73 |s from w|eb files|
|00001f20| 20 73 75 63 68 20 61 73 | 3a 0a 5c 62 65 67 69 6e | such as|:.\begin|
|00001f30| 7b 76 65 72 62 61 74 69 | 6d 7d 0a 2e 77 2e 63 3a |{verbati|m}..w.c:|
|00001f40| 0a 09 6e 75 77 65 62 20 | 2d 74 63 20 24 3c 0a 5c |..nuweb |-tc $<.\|
|00001f50| 65 6e 64 7b 76 65 72 62 | 61 74 69 6d 7d 0a 4e 6f |end{verb|atim}.No|
|00001f60| 74 65 20 74 68 65 20 75 | 73 65 20 6f 66 20 74 68 |te the u|se of th|
|00001f70| 65 20 74 68 65 20 7c 2d | 74 7c 20 66 6c 61 67 20 |e the |-|t| flag |
|00001f80| 74 6f 20 73 74 6f 70 20 | 74 68 65 20 64 6f 63 75 |to stop |the docu|
|00001f90| 6d 65 6e 74 61 74 69 6f | 6e 20 66 69 6c 65 20 62 |mentatio|n file b|
|00001fa0| 65 69 6e 67 0a 67 65 6e | 65 72 61 74 65 64 2c 20 |eing.gen|erated, |
|00001fb0| 61 6e 64 20 74 68 65 20 | 7c 2d 63 7c 20 66 6c 61 |and the ||-c| fla|
|00001fc0| 67 20 28 74 68 65 72 65 | 27 73 20 6e 6f 20 70 6f |g (there|'s no po|
|00001fd0| 69 6e 74 20 63 6f 6d 70 | 61 72 69 6e 67 20 74 68 |int comp|aring th|
|00001fe0| 65 20 6e 65 77 20 76 65 | 72 73 69 6f 6e 0a 6f 66 |e new ve|rsion.of|
|00001ff0| 20 74 68 65 20 43 20 66 | 69 6c 65 20 77 69 74 68 | the C f|ile with|
|00002000| 20 74 68 65 20 6f 6c 64 | 2c 20 61 73 20 77 65 20 | the old|, as we |
|00002010| 61 6c 72 65 61 64 79 20 | 6b 6e 6f 77 20 69 74 20 |already |know it |
|00002020| 6e 65 65 64 73 20 74 6f | 20 62 65 20 72 65 6d 61 |needs to| be rema|
|00002030| 64 65 29 2e 0a 0a 5c 73 | 75 62 73 65 63 74 69 6f |de)...\s|ubsectio|
|00002040| 6e 7b 4e 75 77 65 62 20 | 61 6e 64 20 5c 48 54 4d |n{Nuweb |and \HTM|
|00002050| 4c 7d 0a 0a 49 6e 20 61 | 64 64 69 74 69 6f 6e 20 |L}..In a|ddition |
|00002060| 74 6f 20 70 72 6f 64 75 | 63 69 6e 67 20 5c 4c 61 |to produ|cing \La|
|00002070| 54 65 58 5c 20 73 6f 75 | 72 63 65 2c 20 6e 75 77 |TeX\ sou|rce, nuw|
|00002080| 65 62 20 63 61 6e 20 62 | 65 20 75 73 65 64 20 74 |eb can b|e used t|
|00002090| 6f 20 67 65 6e 65 72 61 | 74 65 0a 48 79 70 65 72 |o genera|te.Hyper|
|000020a0| 54 65 78 74 20 4d 61 72 | 6b 75 70 20 4c 61 6e 67 |Text Mar|kup Lang|
|000020b0| 75 61 67 65 20 28 5c 48 | 54 4d 4c 29 2c 20 74 68 |uage (\H|TML), th|
|000020c0| 65 20 6d 61 72 6b 75 70 | 20 6c 61 6e 67 75 61 67 |e markup| languag|
|000020d0| 65 20 75 73 65 64 20 62 | 79 20 74 68 65 20 57 6f |e used b|y the Wo|
|000020e0| 72 6c 64 20 57 69 64 65 | 0a 57 65 62 2e 20 20 54 |rld Wide|.Web. T|
|000020f0| 68 69 73 20 63 61 6e 20 | 62 65 20 64 6f 6e 65 20 |his can |be done |
|00002100| 65 69 74 68 65 72 20 66 | 72 6f 6d 20 5c 4c 61 54 |either f|rom \LaT|
|00002110| 65 58 5c 20 6f 72 20 5c | 48 54 4d 4c 5c 20 73 6f |eX\ or \|HTML\ so|
|00002120| 75 72 63 65 2e 20 57 69 | 74 68 20 61 20 5c 4c 61 |urce. Wi|th a \La|
|00002130| 54 65 58 5c 0a 73 6f 75 | 72 63 65 2c 20 74 68 65 |TeX\.sou|rce, the|
|00002140| 20 74 6f 6f 6c 73 20 77 | 68 69 63 68 20 67 65 6e | tools w|hich gen|
|00002150| 65 72 61 74 65 20 5c 48 | 54 4d 4c 5c 20 61 75 74 |erate \H|TML\ aut|
|00002160| 6f 6d 61 74 69 63 61 6c | 6c 79 20 70 72 6f 64 75 |omatical|ly produ|
|00002170| 63 65 20 68 79 70 65 72 | 74 65 78 74 20 6c 69 6e |ce hyper|text lin|
|00002180| 6b 73 2e 0a 54 68 65 20 | 72 65 6d 61 69 6e 69 6e |ks..The |remainin|
|00002190| 67 20 74 65 78 74 20 64 | 65 73 63 72 69 62 65 73 |g text d|escribes|
|000021a0| 20 74 68 65 20 75 73 65 | 20 6f 66 20 5c 4c 61 54 | the use| of \LaT|
|000021b0| 65 58 5c 20 6d 61 72 6b | 75 70 3b 20 74 68 65 20 |eX\ mark|up; the |
|000021c0| 75 73 65 20 6f 66 20 5c | 48 54 4d 4c 5c 0a 6d 61 |use of \|HTML\.ma|
|000021d0| 72 6b 75 70 20 66 6f 6c | 6c 6f 77 73 20 74 68 65 |rkup fol|lows the|
|000021e0| 20 73 61 6d 65 20 70 61 | 74 74 65 72 6e 2e 0a 0a | same pa|ttern...|
|000021f0| 0a 0a 5c 73 65 63 74 69 | 6f 6e 7b 57 72 69 74 69 |..\secti|on{Writi|
|00002200| 6e 67 20 4e 75 77 65 62 | 7d 20 5c 6c 61 62 65 6c |ng Nuweb|} \label|
|00002210| 7b 77 72 69 74 69 6e 67 | 6e 75 77 65 62 7d 0a 0a |{writing|nuweb}..|
|00002220| 54 68 65 20 62 75 6c 6b | 20 6f 66 20 61 20 6e 75 |The bulk| of a nu|
|00002230| 77 65 62 20 66 69 6c 65 | 20 77 69 6c 6c 20 62 65 |web file| will be|
|00002240| 20 6f 72 64 69 6e 61 72 | 79 20 5c 4c 61 54 65 58 | ordinar|y \LaTeX|
|00002250| 5c 40 40 2e 20 49 6e 20 | 66 61 63 74 2c 20 61 6e |\@@. In |fact, an|
|00002260| 79 20 5c 4c 61 54 65 58 | 5c 0a 66 69 6c 65 20 63 |y \LaTeX|\.file c|
|00002270| 61 6e 20 73 65 72 76 65 | 20 61 73 20 69 6e 70 75 |an serve| as inpu|
|00002280| 74 20 74 6f 20 6e 75 77 | 65 62 20 61 6e 64 20 77 |t to nuw|eb and w|
|00002290| 69 6c 6c 20 62 65 20 73 | 69 6d 70 6c 79 20 63 6f |ill be s|imply co|
|000022a0| 70 69 65 64 20 74 68 72 | 6f 75 67 68 20 75 6e 63 |pied thr|ough unc|
|000022b0| 68 61 6e 67 65 64 0a 74 | 6f 20 74 68 65 20 64 6f |hanged.t|o the do|
|000022c0| 63 75 6d 65 6e 74 61 74 | 69 6f 6e 20 66 69 6c 65 |cumentat|ion file|
|000022d0| 2d 2d 2d 75 6e 6c 65 73 | 73 20 61 20 6e 75 77 65 |---unles|s a nuwe|
|000022e0| 62 20 63 6f 6d 6d 61 6e | 64 20 69 73 20 64 69 73 |b comman|d is dis|
|000022f0| 63 6f 76 65 72 65 64 2e | 20 41 6c 6c 20 6e 75 77 |covered.| All nuw|
|00002300| 65 62 0a 63 6f 6d 6d 61 | 6e 64 73 20 62 65 67 69 |eb.comma|nds begi|
|00002310| 6e 20 77 69 74 68 20 61 | 6e 20 61 74 20 73 69 67 |n with a|n at sig|
|00002320| 6e 20 28 7c 40 40 7c 29 | 2e 20 20 54 68 65 72 65 |n (|@@|)|. There|
|00002330| 66 6f 72 65 2c 20 61 20 | 66 69 6c 65 20 77 69 74 |fore, a |file wit|
|00002340| 68 6f 75 74 0a 61 74 2d | 73 69 67 6e 73 20 77 69 |hout.at-|signs wi|
|00002350| 6c 6c 20 62 65 20 63 6f | 70 69 65 64 20 75 6e 63 |ll be co|pied unc|
|00002360| 68 61 6e 67 65 64 2e 20 | 20 4e 75 77 65 62 20 63 |hanged. | Nuweb c|
|00002370| 6f 6d 6d 61 6e 64 73 20 | 61 72 65 20 75 73 65 64 |ommands |are used|
|00002380| 20 74 6f 20 73 70 65 63 | 69 66 79 0a 5c 65 6d 70 | to spec|ify.\emp|
|00002390| 68 7b 70 72 6f 67 72 61 | 6d 20 66 69 6c 65 73 7d |h{progra|m files}|
|000023a0| 2c 20 64 65 66 69 6e 65 | 20 5c 65 6d 70 68 7b 6d |, define| \emph{m|
|000023b0| 61 63 72 6f 73 7d 2c 20 | 61 6e 64 20 64 65 6c 69 |acros}, |and deli|
|000023c0| 6d 69 74 20 5c 65 6d 70 | 68 7b 73 63 72 61 70 73 |mit \emp|h{scraps|
|000023d0| 7d 2e 20 54 68 65 73 65 | 0a 61 72 65 20 74 68 65 |}. These|.are the|
|000023e0| 20 6f 6e 6c 79 20 66 65 | 61 74 75 72 65 73 20 6f | only fe|atures o|
|000023f0| 66 20 69 6e 74 65 72 65 | 73 74 20 74 6f 20 74 68 |f intere|st to th|
|00002400| 65 20 6e 75 77 65 62 20 | 74 6f 6f 6c 2d 2d 2d 61 |e nuweb |tool---a|
|00002410| 6c 6c 20 65 6c 73 65 20 | 69 73 20 73 69 6d 70 6c |ll else |is simpl|
|00002420| 79 20 74 65 78 74 0a 74 | 6f 20 62 65 20 63 6f 70 |y text.t|o be cop|
|00002430| 69 65 64 20 74 6f 20 74 | 68 65 20 64 6f 63 75 6d |ied to t|he docum|
|00002440| 65 6e 74 61 74 69 6f 6e | 20 66 69 6c 65 2e 0a 0a |entation| file...|
|00002450| 0a 5c 73 75 62 73 65 63 | 74 69 6f 6e 7b 54 68 65 |.\subsec|tion{The|
|00002460| 20 4d 61 6a 6f 72 20 43 | 6f 6d 6d 61 6e 64 73 7d | Major C|ommands}|
|00002470| 0a 0a 46 69 6c 65 73 20 | 61 6e 64 20 6d 61 63 72 |..Files |and macr|
|00002480| 6f 73 20 61 72 65 20 64 | 65 66 69 6e 65 64 20 77 |os are d|efined w|
|00002490| 69 74 68 20 74 68 65 20 | 66 6f 6c 6c 6f 77 69 6e |ith the |followin|
|000024a0| 67 20 63 6f 6d 6d 61 6e | 64 73 3a 0a 5c 62 65 67 |g comman|ds:.\beg|
|000024b0| 69 6e 7b 64 65 73 63 72 | 69 70 74 69 6f 6e 7d 0a |in{descr|iption}.|
|000024c0| 5c 69 74 65 6d 5b 5c 74 | 65 78 74 74 74 7b 40 40 |\item[\t|exttt{@@|
|000024d0| 6f 7d 20 5c 74 65 78 74 | 69 74 7b 66 69 6c 65 2d |o} \text|it{file-|
|000024e0| 6e 61 6d 65 20 66 6c 61 | 67 73 20 73 63 72 61 70 |name fla|gs scrap|
|000024f0| 7d 5d 20 4f 75 74 70 75 | 74 20 61 20 70 72 6f 67 |}] Outpu|t a prog|
|00002500| 72 61 6d 20 66 69 6c 65 | 2e 20 54 68 65 0a 20 20 |ram file|. The. |
|00002510| 66 69 6c 65 20 6e 61 6d | 65 20 69 73 20 74 65 72 |file nam|e is ter|
|00002520| 6d 69 6e 61 74 65 64 20 | 62 79 20 77 68 69 74 65 |minated |by white|
|00002530| 73 70 61 63 65 2e 0a 5c | 69 74 65 6d 5b 5c 74 65 |space..\|item[\te|
|00002540| 78 74 74 74 7b 40 40 64 | 7d 20 5c 74 65 78 74 69 |xttt{@@d|} \texti|
|00002550| 74 7b 6d 61 63 72 6f 2d | 6e 61 6d 65 20 73 63 72 |t{macro-|name scr|
|00002560| 61 70 7d 5d 20 44 65 66 | 69 6e 65 20 61 20 6d 61 |ap}] Def|ine a ma|
|00002570| 63 72 6f 2e 20 54 68 65 | 20 6d 61 63 72 6f 20 6e |cro. The| macro n|
|00002580| 61 6d 65 0a 20 20 69 73 | 20 74 65 72 6d 69 6e 61 |ame. is| termina|
|00002590| 74 65 64 20 62 79 20 61 | 20 72 65 74 75 72 6e 20 |ted by a| return |
|000025a0| 6f 72 20 74 68 65 20 62 | 65 67 69 6e 6e 69 6e 67 |or the b|eginning|
|000025b0| 20 6f 66 20 61 20 73 63 | 72 61 70 2e 0a 5c 65 6e | of a sc|rap..\en|
|000025c0| 64 7b 64 65 73 63 72 69 | 70 74 69 6f 6e 7d 0a 41 |d{descri|ption}.A|
|000025d0| 20 73 70 65 63 69 66 69 | 63 20 66 69 6c 65 20 6d | specifi|c file m|
|000025e0| 61 79 20 62 65 20 73 70 | 65 63 69 66 69 65 64 20 |ay be sp|ecified |
|000025f0| 73 65 76 65 72 61 6c 20 | 74 69 6d 65 73 2c 20 77 |several |times, w|
|00002600| 69 74 68 20 74 68 65 20 | 64 65 66 69 6e 69 74 69 |ith the |definiti|
|00002610| 6f 6e 73 20 62 65 69 6e | 67 0a 77 72 69 74 74 65 |ons bein|g.writte|
|00002620| 6e 20 6f 75 74 2c 20 6f | 6e 65 20 61 66 74 65 72 |n out, o|ne after|
|00002630| 20 61 6e 6f 74 68 65 72 | 2c 20 69 6e 20 74 68 65 | another|, in the|
|00002640| 20 6f 72 64 65 72 20 74 | 68 65 79 20 61 70 70 65 | order t|hey appe|
|00002650| 61 72 2e 20 54 68 65 20 | 64 65 66 69 6e 69 74 69 |ar. The |definiti|
|00002660| 6f 6e 73 0a 6f 66 20 6d | 61 63 72 6f 73 20 6d 61 |ons.of m|acros ma|
|00002670| 79 20 62 65 20 73 69 6d | 69 6c 61 72 6c 79 20 64 |y be sim|ilarly d|
|00002680| 69 76 69 64 65 64 2e 0a | 0a 4d 61 63 72 6f 20 6e |ivided..|.Macro n|
|00002690| 61 6d 65 73 20 6d 61 79 | 20 62 65 20 28 61 6c 6d |ames may| be (alm|
|000026a0| 6f 73 74 29 20 61 6e 79 | 20 77 65 6c 6c 2d 66 6f |ost) any| well-fo|
|000026b0| 72 6d 65 64 20 5c 54 65 | 58 5c 20 73 74 72 69 6e |rmed \Te|X\ strin|
|000026c0| 67 2e 20 43 68 61 6e 67 | 69 6e 67 20 66 6f 6e 74 |g. Chang|ing font|
|000026d0| 73 20 69 73 0a 61 6c 6c | 6f 77 65 64 2c 20 61 73 |s is.all|owed, as|
|000026e0| 20 69 73 20 75 73 69 6e | 67 20 6d 61 74 68 20 6d | is usin|g math m|
|000026f0| 6f 64 65 3b 20 68 6f 77 | 65 76 65 72 2c 20 73 69 |ode; how|ever, si|
|00002700| 6e 63 65 20 69 6e 20 74 | 68 65 20 7c 61 6c 6c 74 |nce in t|he |allt|
|00002710| 74 7c 20 65 6e 76 69 72 | 6f 6e 6d 65 6e 74 0a 75 |t| envir|onment.u|
|00002720| 73 65 64 20 74 6f 20 64 | 69 73 70 6c 61 79 20 63 |sed to d|isplay c|
|00002730| 6f 64 65 20 74 68 65 20 | 5c 24 20 73 69 67 6e 20 |ode the |\$ sign |
|00002740| 69 73 20 61 6e 20 6f 72 | 64 69 6e 61 72 79 20 63 |is an or|dinary c|
|00002750| 68 61 72 61 63 74 65 72 | 2c 20 74 68 65 20 63 6f |haracter|, the co|
|00002760| 6d 6d 61 6e 64 73 20 7c | 5c 28 7c 0a 61 6e 64 20 |mmands ||\(|.and |
|00002770| 7c 5c 29 7c 20 73 68 6f | 75 6c 64 20 62 65 20 75 ||\)| sho|uld be u|
|00002780| 73 65 64 20 69 6e 73 74 | 65 61 64 20 74 6f 20 65 |sed inst|ead to e|
|00002790| 6e 74 65 72 20 61 6e 64 | 20 6c 65 61 76 65 20 6d |nter and| leave m|
|000027a0| 61 74 68 20 6d 6f 64 65 | 2e 20 41 6c 73 6f 2c 20 |ath mode|. Also, |
|000027b0| 73 70 61 63 65 73 0a 61 | 72 65 20 73 69 67 6e 69 |spaces.a|re signi|
|000027c0| 66 69 63 61 6e 74 2c 20 | 73 6f 20 61 76 6f 69 64 |ficant, |so avoid|
|000027d0| 20 63 6f 6e 73 74 72 75 | 63 74 73 20 73 75 63 68 | constru|cts such|
|000027e0| 20 61 73 20 7c 7b 5c 74 | 74 20 78 79 7a 7d 7c 3b | as |{\t|t xyz}|;|
|000027f0| 20 75 73 65 20 7c 5c 74 | 65 78 74 74 74 7b 78 79 | use |\t|exttt{xy|
|00002800| 7a 7d 7c 0a 69 6e 73 74 | 65 61 64 2e 20 7c 5c 76 |z}|.inst|ead. |\v|
|00002810| 65 72 62 7c 20 63 61 6e | 6e 6f 74 20 62 65 20 75 |erb| can|not be u|
|00002820| 73 65 64 20 69 6e 20 6d | 61 63 72 6f 20 6e 61 6d |sed in m|acro nam|
|00002830| 65 73 3b 20 7c 5c 74 74 | 7c 20 6f 72 20 7c 5c 74 |es; |\tt|| or |\t|
|00002840| 65 78 74 74 74 7c 20 73 | 68 6f 75 6c 64 20 62 65 |exttt| s|hould be|
|00002850| 0a 75 73 65 64 20 69 6e | 73 74 65 61 64 2e 20 57 |.used in|stead. W|
|00002860| 68 65 6e 20 70 72 6f 64 | 75 63 69 6e 67 20 5c 48 |hen prod|ucing \H|
|00002870| 54 4d 4c 2c 20 6d 61 63 | 72 6f 73 20 61 72 65 20 |TML, mac|ros are |
|00002880| 64 69 73 70 6c 61 79 65 | 64 20 69 6e 20 61 20 70 |displaye|d in a p|
|00002890| 72 65 66 6f 72 6d 61 74 | 74 65 64 0a 65 6c 65 6d |reformat|ted.elem|
|000028a0| 65 6e 74 20 28 7c 50 52 | 45 7c 29 2c 20 73 6f 20 |ent (|PR|E|), so |
|000028b0| 6d 61 63 72 6f 73 20 6d | 61 79 20 63 6f 6e 74 61 |macros m|ay conta|
|000028c0| 69 6e 20 6f 6e 65 20 6f | 72 20 6d 6f 72 65 20 7c |in one o|r more ||
|000028d0| 41 7c 2c 20 7c 42 7c 2c | 20 7c 49 7c 2c 20 7c 55 |A|, |B|,| |I|, |U|
|000028e0| 7c 2c 20 6f 72 20 7c 50 | 7c 0a 65 6c 65 6d 65 6e ||, or |P||.elemen|
|000028f0| 74 73 20 6f 72 20 64 61 | 74 61 20 63 68 61 72 61 |ts or da|ta chara|
|00002900| 63 74 65 72 73 2e 0a 0a | 56 65 72 79 20 6c 6f 6e |cters...|Very lon|
|00002910| 67 20 73 63 72 61 70 73 | 20 6d 61 79 20 62 65 20 |g scraps| may be |
|00002920| 61 6c 6c 6f 77 65 64 20 | 74 6f 20 62 72 65 61 6b |allowed |to break|
|00002930| 20 61 63 72 6f 73 73 20 | 61 20 70 61 67 65 20 69 | across |a page i|
|00002940| 66 20 64 65 63 6c 61 72 | 65 64 20 77 69 74 68 0a |f declar|ed with.|
|00002950| 7c 40 40 4f 7c 20 6f 72 | 20 7c 40 40 44 7c 20 28 ||@@O| or| |@@D| (|
|00002960| 69 6e 73 74 65 61 64 20 | 6f 66 20 7c 40 40 6f 7c |instead |of |@@o||
|00002970| 20 61 6e 64 20 7c 40 40 | 64 7c 29 2e 20 54 68 69 | and |@@|d|). Thi|
|00002980| 73 20 64 6f 65 73 6e 27 | 74 0a 77 6f 72 6b 20 76 |s doesn'|t.work v|
|00002990| 65 72 79 20 77 65 6c 6c | 20 61 73 20 61 20 64 65 |ery well| as a de|
|000029a0| 66 61 75 6c 74 2c 20 73 | 69 6e 63 65 20 66 61 72 |fault, s|ince far|
|000029b0| 20 74 6f 6f 20 6d 61 6e | 79 20 73 68 6f 72 74 20 | too man|y short |
|000029c0| 73 63 72 61 70 73 20 77 | 69 6c 6c 20 62 65 20 62 |scraps w|ill be b|
|000029d0| 72 6f 6b 65 6e 0a 61 63 | 72 6f 73 73 20 70 61 67 |roken.ac|ross pag|
|000029e0| 65 73 3b 20 68 6f 77 65 | 76 65 72 2c 20 61 73 20 |es; howe|ver, as |
|000029f0| 61 20 75 73 65 72 2d 63 | 6f 6e 74 72 6f 6c 6c 65 |a user-c|ontrolle|
|00002a00| 64 20 6f 70 74 69 6f 6e | 2c 20 69 74 20 73 65 65 |d option|, it see|
|00002a10| 6d 73 20 76 65 72 79 20 | 75 73 65 66 75 6c 2e 20 |ms very |useful. |
|00002a20| 20 4e 6f 0a 64 69 73 74 | 69 6e 63 74 69 6f 6e 20 | No.dist|inction |
|00002a30| 69 73 20 6d 61 64 65 20 | 62 65 74 77 65 65 6e 20 |is made |between |
|00002a40| 74 68 65 20 75 70 70 65 | 72 20 63 61 73 65 20 61 |the uppe|r case a|
|00002a50| 6e 64 20 6c 6f 77 65 72 | 20 63 61 73 65 20 66 6f |nd lower| case fo|
|00002a60| 72 6d 73 20 6f 66 20 74 | 68 65 73 65 0a 63 6f 6d |rms of t|hese.com|
|00002a70| 6d 61 6e 64 73 20 77 68 | 65 6e 20 67 65 6e 65 72 |mands wh|en gener|
|00002a80| 61 74 69 6e 67 20 5c 48 | 54 4d 4c 5c 40 40 2e 0a |ating \H|TML\@@..|
|00002a90| 0a 5c 73 75 62 73 75 62 | 73 65 63 74 69 6f 6e 7b |.\subsub|section{|
|00002aa0| 53 63 72 61 70 73 7d 0a | 0a 53 63 72 61 70 73 20 |Scraps}.|.Scraps |
|00002ab0| 68 61 76 65 20 73 70 65 | 63 69 66 69 63 20 73 74 |have spe|cific st|
|00002ac0| 61 72 74 20 61 6e 64 20 | 65 6e 64 20 6d 61 72 6b |art and |end mark|
|00002ad0| 65 72 73 20 74 6f 20 61 | 6c 6c 6f 77 20 70 72 65 |ers to a|llow pre|
|00002ae0| 63 69 73 65 20 63 6f 6e | 74 72 6f 6c 0a 6f 76 65 |cise con|trol.ove|
|00002af0| 72 20 74 68 65 20 63 6f | 6e 74 65 6e 74 73 20 61 |r the co|ntents a|
|00002b00| 6e 64 20 6c 61 79 6f 75 | 74 2e 20 4e 6f 74 65 20 |nd layou|t. Note |
|00002b10| 74 68 61 74 20 61 6e 79 | 20 61 6d 6f 75 6e 74 20 |that any| amount |
|00002b20| 6f 66 20 77 68 69 74 65 | 73 70 61 63 65 20 28 69 |of white|space (i|
|00002b30| 6e 63 6c 75 64 69 6e 67 | 0a 63 61 72 72 69 61 67 |ncluding|.carriag|
|00002b40| 65 20 72 65 74 75 72 6e | 73 29 20 6d 61 79 20 61 |e return|s) may a|
|00002b50| 70 70 65 61 72 20 62 65 | 74 77 65 65 6e 20 61 20 |ppear be|tween a |
|00002b60| 6e 61 6d 65 20 61 6e 64 | 20 74 68 65 20 62 65 67 |name and| the beg|
|00002b70| 69 6e 6e 69 6e 67 20 6f | 66 20 61 20 73 63 72 61 |inning o|f a scra|
|00002b80| 70 2e 20 41 0a 73 63 72 | 61 70 20 68 61 73 20 74 |p. A.scr|ap has t|
|00002b90| 68 65 20 66 6f 72 6d 3a | 0a 5c 62 65 67 69 6e 7b |he form:|.\begin{|
|00002ba0| 64 65 73 63 72 69 70 74 | 69 6f 6e 7d 0a 5c 69 74 |descript|ion}.\it|
|00002bb0| 65 6d 5b 5c 74 65 78 74 | 74 74 7b 40 40 5c 7b 7d |em[\text|tt{@@\{}|
|00002bc0| 5c 74 65 78 74 69 74 7b | 61 6e 79 74 68 69 6e 67 |\textit{|anything|
|00002bd0| 7d 5c 74 65 78 74 74 74 | 7b 40 40 5c 7d 7d 5d 20 |}\texttt|{@@\}}] |
|00002be0| 77 68 65 72 65 20 74 68 | 65 20 73 63 72 61 70 20 |where th|e scrap |
|00002bf0| 62 6f 64 79 0a 20 20 69 | 6e 63 6c 75 64 65 73 20 |body. i|ncludes |
|00002c00| 65 76 65 72 79 20 63 68 | 61 72 61 63 74 65 72 20 |every ch|aracter |
|00002c10| 69 6e 20 5c 74 65 78 74 | 69 74 7b 61 6e 79 74 68 |in \text|it{anyth|
|00002c20| 69 6e 67 7d 2d 2d 2d 61 | 6c 6c 20 74 68 65 20 62 |ing}---a|ll the b|
|00002c30| 6c 61 6e 6b 73 2c 20 61 | 6c 6c 20 74 68 65 0a 20 |lanks, a|ll the. |
|00002c40| 20 74 61 62 73 2c 20 61 | 6c 6c 20 74 68 65 20 63 | tabs, a|ll the c|
|00002c50| 61 72 72 69 61 67 65 20 | 72 65 74 75 72 6e 73 2e |arriage |returns.|
|00002c60| 0a 5c 65 6e 64 7b 64 65 | 73 63 72 69 70 74 69 6f |.\end{de|scriptio|
|00002c70| 6e 7d 0a 49 6e 73 69 64 | 65 20 61 20 73 63 72 61 |n}.Insid|e a scra|
|00002c80| 70 2c 20 77 65 20 6d 61 | 79 20 69 6e 76 6f 6b 65 |p, we ma|y invoke|
|00002c90| 20 61 20 6d 61 63 72 6f | 3a 0a 5c 62 65 67 69 6e | a macro|:.\begin|
|00002ca0| 7b 64 65 73 63 72 69 70 | 74 69 6f 6e 7d 0a 5c 69 |{descrip|tion}.\i|
|00002cb0| 74 65 6d 5b 5c 74 65 78 | 74 74 74 7b 40 40 3c 7d |tem[\tex|ttt{@@<}|
|00002cc0| 5c 74 65 78 74 69 74 7b | 6d 61 63 72 6f 2d 6e 61 |\textit{|macro-na|
|00002cd0| 6d 65 7d 5c 74 65 78 74 | 74 74 7b 40 40 3e 7d 5d |me}\text|tt{@@>}]|
|00002ce0| 20 43 61 75 73 65 73 20 | 74 68 65 20 6d 61 63 72 | Causes |the macr|
|00002cf0| 6f 0a 20 20 5c 74 65 78 | 74 69 74 7b 6d 61 63 72 |o. \tex|tit{macr|
|00002d00| 6f 2d 6e 61 6d 65 7d 20 | 74 6f 20 62 65 20 65 78 |o-name} |to be ex|
|00002d10| 70 61 6e 64 65 64 20 69 | 6e 6c 69 6e 65 20 61 73 |panded i|nline as|
|00002d20| 20 74 68 65 20 63 6f 64 | 65 20 69 73 20 77 72 69 | the cod|e is wri|
|00002d30| 74 74 65 6e 20 6f 75 74 | 0a 20 20 74 6f 20 61 20 |tten out|. to a |
|00002d40| 66 69 6c 65 2e 20 52 65 | 63 75 72 73 69 76 65 20 |file. Re|cursive |
|00002d50| 6d 61 63 72 6f 20 69 6e | 76 6f 63 61 74 69 6f 6e |macro in|vocation|
|00002d60| 73 20 61 72 65 20 6e 6f | 74 20 61 6c 6c 6f 77 65 |s are no|t allowe|
|00002d70| 64 2e 0a 5c 65 6e 64 7b | 64 65 73 63 72 69 70 74 |d..\end{|descript|
|00002d80| 69 6f 6e 7d 0a 4e 6f 74 | 65 20 74 68 61 74 20 6d |ion}.Not|e that m|
|00002d90| 61 63 72 6f 20 6e 61 6d | 65 73 20 6d 61 79 20 62 |acro nam|es may b|
|00002da0| 65 20 61 62 62 72 65 76 | 69 61 74 65 64 2c 20 65 |e abbrev|iated, e|
|00002db0| 69 74 68 65 72 20 64 75 | 72 69 6e 67 20 69 6e 76 |ither du|ring inv|
|00002dc0| 6f 63 61 74 69 6f 6e 20 | 6f 72 0a 64 65 66 69 6e |ocation |or.defin|
|00002dd0| 69 74 69 6f 6e 2e 20 46 | 6f 72 20 65 78 61 6d 70 |ition. F|or examp|
|00002de0| 6c 65 2c 20 69 74 20 77 | 6f 75 6c 64 20 62 65 20 |le, it w|ould be |
|00002df0| 74 65 64 69 6f 75 73 20 | 74 6f 20 68 61 76 65 20 |tedious |to have |
|00002e00| 74 6f 20 74 79 70 65 0a | 74 68 65 20 6d 61 63 72 |to type.|the macr|
|00002e10| 6f 20 6e 61 6d 65 0a 5c | 62 65 67 69 6e 7b 71 75 |o name.\|begin{qu|
|00002e20| 6f 74 65 7d 0a 7c 40 40 | 64 20 43 68 65 63 6b 20 |ote}.|@@|d Check |
|00002e30| 66 6f 72 20 74 65 72 6d | 69 6e 61 74 69 6e 67 20 |for term|inating |
|00002e40| 61 74 2d 73 65 71 75 65 | 6e 63 65 20 61 6e 64 20 |at-seque|nce and |
|00002e50| 72 65 74 75 72 6e 20 6e | 61 6d 65 20 69 66 20 66 |return n|ame if f|
|00002e60| 6f 75 6e 64 7c 0a 5c 65 | 6e 64 7b 71 75 6f 74 65 |ound|.\e|nd{quote|
|00002e70| 7d 0a 72 65 70 65 61 74 | 65 64 6c 79 2e 20 54 68 |}.repeat|edly. Th|
|00002e80| 65 72 65 66 6f 72 65 2c | 20 77 65 20 70 72 6f 76 |erefore,| we prov|
|00002e90| 69 64 65 20 61 20 6d 65 | 63 68 61 6e 69 73 6d 20 |ide a me|chanism |
|00002ea0| 28 62 6f 72 72 6f 77 65 | 64 20 66 72 6f 6d 20 4b |(borrowe|d from K|
|00002eb0| 6e 75 74 68 29 20 6f 66 | 0a 69 6e 64 69 63 61 74 |nuth) of|.indicat|
|00002ec0| 69 6e 67 20 61 62 62 72 | 65 76 69 61 74 65 64 20 |ing abbr|eviated |
|00002ed0| 6e 61 6d 65 73 2e 0a 5c | 62 65 67 69 6e 7b 71 75 |names..\|begin{qu|
|00002ee0| 6f 74 65 7d 0a 7c 40 40 | 64 20 43 68 65 63 6b 20 |ote}.|@@|d Check |
|00002ef0| 66 6f 72 20 74 65 72 6d | 69 6e 61 74 69 6e 67 2e |for term|inating.|
|00002f00| 2e 2e 7c 0a 5c 65 6e 64 | 7b 71 75 6f 74 65 7d 0a |..|.\end|{quote}.|
|00002f10| 54 68 65 20 70 72 6f 67 | 72 61 6d 6d 65 72 20 6e |The prog|rammer n|
|00002f20| 65 65 64 20 6f 6e 6c 79 | 20 74 79 70 65 20 65 6e |eed only| type en|
|00002f30| 6f 75 67 68 20 63 68 61 | 72 61 63 74 65 72 73 20 |ough cha|racters |
|00002f40| 74 6f 20 75 6e 69 71 75 | 65 6c 79 20 69 64 65 6e |to uniqu|ely iden|
|00002f50| 74 69 66 79 20 74 68 65 | 0a 6d 61 63 72 6f 20 6e |tify the|.macro n|
|00002f60| 61 6d 65 2c 20 66 6f 6c | 6c 6f 77 65 64 20 62 79 |ame, fol|lowed by|
|00002f70| 20 74 68 72 65 65 20 70 | 65 72 69 6f 64 73 2e 20 | three p|eriods. |
|00002f80| 41 6e 20 61 62 62 72 65 | 76 69 61 74 69 6f 6e 20 |An abbre|viation |
|00002f90| 6d 61 79 20 65 76 65 6e | 20 6f 63 63 75 72 20 62 |may even| occur b|
|00002fa0| 65 66 6f 72 65 0a 74 68 | 65 20 66 75 6c 6c 20 76 |efore.th|e full v|
|00002fb0| 65 72 73 69 6f 6e 3b 20 | 6e 75 77 65 62 20 73 69 |ersion; |nuweb si|
|00002fc0| 6d 70 6c 79 20 70 72 65 | 73 65 72 76 65 73 20 74 |mply pre|serves t|
|00002fd0| 68 65 20 6c 6f 6e 67 65 | 73 74 20 76 65 72 73 69 |he longe|st versi|
|00002fe0| 6f 6e 20 6f 66 20 61 20 | 6d 61 63 72 6f 20 6e 61 |on of a |macro na|
|00002ff0| 6d 65 2e 0a 4e 6f 74 65 | 20 61 6c 73 6f 20 74 68 |me..Note| also th|
|00003000| 61 74 20 73 74 72 69 6e | 67 73 20 6f 66 20 62 6c |at strin|gs of bl|
|00003010| 61 6e 6b 73 20 61 6e 64 | 20 74 61 62 73 20 61 72 |anks and| tabs ar|
|00003020| 65 20 72 65 70 6c 61 63 | 65 64 20 62 79 20 61 20 |e replac|ed by a |
|00003030| 73 69 6e 67 6c 65 20 62 | 6c 61 6e 6b 2e 0a 0a 57 |single b|lank...W|
|00003040| 68 65 6e 20 73 63 72 61 | 70 73 20 61 72 65 20 77 |hen scra|ps are w|
|00003050| 72 69 74 74 65 6e 20 74 | 6f 20 61 20 70 72 6f 67 |ritten t|o a prog|
|00003060| 72 61 6d 20 66 69 6c 65 | 20 6f 72 20 64 6f 63 75 |ram file| or docu|
|00003070| 6d 65 6e 74 61 74 69 6f | 6e 20 66 69 6c 65 2c 20 |mentatio|n file, |
|00003080| 74 61 62 73 20 61 72 65 | 0a 65 78 70 61 6e 64 65 |tabs are|.expande|
|00003090| 64 20 69 6e 74 6f 20 73 | 70 61 63 65 73 20 62 79 |d into s|paces by|
|000030a0| 20 64 65 66 61 75 6c 74 | 2e 20 43 75 72 72 65 6e | default|. Curren|
|000030b0| 74 6c 79 2c 20 49 20 61 | 73 73 75 6d 65 20 74 61 |tly, I a|ssume ta|
|000030c0| 62 20 73 74 6f 70 73 20 | 61 72 65 20 73 65 74 20 |b stops |are set |
|000030d0| 65 76 65 72 79 0a 65 69 | 67 68 74 20 63 68 61 72 |every.ei|ght char|
|000030e0| 61 63 74 65 72 73 2e 20 | 46 75 72 74 68 65 72 6d |acters. |Furtherm|
|000030f0| 6f 72 65 2c 20 77 68 65 | 6e 20 61 20 6d 61 63 72 |ore, whe|n a macr|
|00003100| 6f 20 69 73 20 65 78 70 | 61 6e 64 65 64 20 69 6e |o is exp|anded in|
|00003110| 20 61 20 73 63 72 61 70 | 2c 20 74 68 65 20 62 6f | a scrap|, the bo|
|00003120| 64 79 0a 6f 66 20 74 68 | 65 20 6d 61 63 72 6f 20 |dy.of th|e macro |
|00003130| 69 73 20 69 6e 64 65 6e | 74 65 64 20 74 6f 20 6d |is inden|ted to m|
|00003140| 61 74 63 68 20 74 68 65 | 20 69 6e 64 65 6e 74 61 |atch the| indenta|
|00003150| 74 69 6f 6e 20 6f 66 20 | 74 68 65 20 6d 61 63 72 |tion of |the macr|
|00003160| 6f 20 69 6e 76 6f 63 61 | 74 69 6f 6e 2e 0a 54 68 |o invoca|tion..Th|
|00003170| 65 72 65 66 6f 72 65 2c | 20 63 61 72 65 20 6d 75 |erefore,| care mu|
|00003180| 73 74 20 62 65 20 74 61 | 6b 65 6e 20 77 69 74 68 |st be ta|ken with|
|00003190| 20 6c 61 6e 67 75 61 67 | 65 73 20 73 75 63 68 20 | languag|es such |
|000031a0| 61 73 20 46 6f 72 74 72 | 61 6e 20 74 68 61 74 20 |as Fortr|an that |
|000031b0| 61 72 65 0a 73 65 6e 73 | 69 74 69 76 65 20 74 6f |are.sens|itive to|
|000031c0| 20 69 6e 64 65 6e 74 61 | 74 69 6f 6e 2e 20 54 68 | indenta|tion. Th|
|000031d0| 65 73 65 20 64 65 66 61 | 75 6c 74 20 62 65 68 61 |ese defa|ult beha|
|000031e0| 76 69 6f 72 73 20 6d 61 | 79 20 62 65 20 63 68 61 |viors ma|y be cha|
|000031f0| 6e 67 65 64 20 66 6f 72 | 20 65 61 63 68 0a 70 72 |nged for| each.pr|
|00003200| 6f 67 72 61 6d 20 66 69 | 6c 65 20 28 73 65 65 20 |ogram fi|le (see |
|00003210| 62 65 6c 6f 77 29 2e 0a | 0a 5c 73 75 62 73 75 62 |below)..|.\subsub|
|00003220| 73 65 63 74 69 6f 6e 7b | 46 6c 61 67 73 7d 0a 0a |section{|Flags}..|
|00003230| 57 68 65 6e 20 64 65 66 | 69 6e 69 6e 67 20 61 20 |When def|ining a |
|00003240| 70 72 6f 67 72 61 6d 20 | 66 69 6c 65 2c 20 76 61 |program |file, va|
|00003250| 72 69 6f 75 73 20 66 6c | 61 67 73 20 6d 61 79 20 |rious fl|ags may |
|00003260| 62 65 20 75 73 65 64 20 | 74 6f 20 63 6f 6e 74 72 |be used |to contr|
|00003270| 6f 6c 20 69 74 73 0a 61 | 70 70 65 61 72 61 6e 63 |ol its.a|ppearanc|
|00003280| 65 2e 20 54 68 65 20 66 | 6c 61 67 73 20 61 72 65 |e. The f|lags are|
|00003290| 20 69 6e 74 65 6e 64 65 | 64 20 74 6f 20 6d 61 6b | intende|d to mak|
|000032a0| 65 20 6c 69 66 65 20 61 | 20 6c 69 74 74 6c 65 20 |e life a| little |
|000032b0| 65 61 73 69 65 72 20 66 | 6f 72 0a 70 72 6f 67 72 |easier f|or.progr|
|000032c0| 61 6d 6d 65 72 73 20 75 | 73 69 6e 67 20 63 65 72 |ammers u|sing cer|
|000032d0| 74 61 69 6e 20 6c 61 6e | 67 75 61 67 65 73 2e 20 |tain lan|guages. |
|000032e0| 54 68 65 79 20 69 6e 74 | 72 6f 64 75 63 65 20 6c |They int|roduce l|
|000032f0| 69 74 74 6c 65 20 6c 61 | 6e 67 75 61 67 65 0a 64 |ittle la|nguage.d|
|00003300| 65 70 65 6e 64 65 6e 63 | 69 65 73 3b 20 68 6f 77 |ependenc|ies; how|
|00003310| 65 76 65 72 2c 20 74 68 | 65 79 20 64 6f 20 73 6f |ever, th|ey do so|
|00003320| 20 6f 6e 6c 79 20 66 6f | 72 20 61 20 70 61 72 74 | only fo|r a part|
|00003330| 69 63 75 6c 61 72 20 66 | 69 6c 65 2e 20 54 68 75 |icular f|ile. Thu|
|00003340| 73 20 69 74 20 69 73 20 | 73 74 69 6c 6c 0a 65 61 |s it is |still.ea|
|00003350| 73 79 20 74 6f 20 6d 69 | 78 20 6c 61 6e 67 75 61 |sy to mi|x langua|
|00003360| 67 65 73 20 77 69 74 68 | 69 6e 20 61 20 73 69 6e |ges with|in a sin|
|00003370| 67 6c 65 20 64 6f 63 75 | 6d 65 6e 74 2e 20 54 68 |gle docu|ment. Th|
|00003380| 65 72 65 20 61 72 65 20 | 74 68 72 65 65 20 70 65 |ere are |three pe|
|00003390| 72 2d 66 69 6c 65 0a 66 | 6c 61 67 73 3a 0a 5c 62 |r-file.f|lags:.\b|
|000033a0| 65 67 69 6e 7b 64 65 73 | 63 72 69 70 74 69 6f 6e |egin{des|cription|
|000033b0| 7d 0a 5c 69 74 65 6d 5b | 5c 74 74 20 2d 64 5d 20 |}.\item[|\tt -d] |
|000033c0| 46 6f 72 63 65 73 20 74 | 68 65 20 63 72 65 61 74 |Forces t|he creat|
|000033d0| 69 6f 6e 20 6f 66 20 7c | 23 6c 69 6e 65 7c 20 64 |ion of ||#line| d|
|000033e0| 69 72 65 63 74 69 76 65 | 73 20 69 6e 20 74 68 65 |irective|s in the|
|000033f0| 0a 20 20 70 72 6f 67 72 | 61 6d 20 66 69 6c 65 2e |. progr|am file.|
|00003400| 20 54 68 65 73 65 20 61 | 72 65 20 75 73 65 66 75 | These a|re usefu|
|00003410| 6c 20 77 69 74 68 20 43 | 20 28 61 6e 64 20 73 6f |l with C| (and so|
|00003420| 6d 65 74 69 6d 65 73 20 | 43 2b 2b 20 61 6e 64 20 |metimes |C++ and |
|00003430| 46 6f 72 74 72 61 6e 29 | 20 6f 6e 0a 20 20 6d 61 |Fortran)| on. ma|
|00003440| 6e 79 20 73 79 73 74 65 | 6d 73 20 73 69 6e 63 65 |ny syste|ms since|
|00003450| 20 74 68 65 79 20 63 61 | 75 73 65 20 74 68 65 20 | they ca|use the |
|00003460| 63 6f 6d 70 69 6c 65 72 | 27 73 20 65 72 72 6f 72 |compiler|'s error|
|00003470| 20 6d 65 73 73 61 67 65 | 73 20 74 6f 0a 20 20 72 | message|s to. r|
|00003480| 65 66 65 72 20 74 6f 20 | 74 68 65 20 77 65 62 20 |efer to |the web |
|00003490| 66 69 6c 65 20 72 61 74 | 68 65 72 20 74 68 61 6e |file rat|her than|
|000034a0| 20 74 68 65 20 70 72 6f | 67 72 61 6d 20 66 69 6c | the pro|gram fil|
|000034b0| 65 2e 20 53 69 6d 69 6c | 61 72 6c 79 2c 20 74 68 |e. Simil|arly, th|
|000034c0| 65 79 0a 20 20 61 6c 6c | 6f 77 20 73 6f 75 72 63 |ey. all|ow sourc|
|000034d0| 65 20 64 65 62 75 67 67 | 69 6e 67 20 69 6e 20 74 |e debugg|ing in t|
|000034e0| 65 72 6d 73 20 6f 66 20 | 74 68 65 20 77 65 62 20 |erms of |the web |
|000034f0| 66 69 6c 65 2e 0a 5c 69 | 74 65 6d 5b 5c 74 74 20 |file..\i|tem[\tt |
|00003500| 2d 69 5d 20 53 75 70 70 | 72 65 73 73 65 73 20 74 |-i] Supp|resses t|
|00003510| 68 65 20 69 6e 64 65 6e | 74 61 74 69 6f 6e 20 6f |he inden|tation o|
|00003520| 66 20 6d 61 63 72 6f 73 | 2e 20 54 68 61 74 20 69 |f macros|. That i|
|00003530| 73 2c 20 77 68 65 6e 20 | 61 0a 20 20 6d 61 63 72 |s, when |a. macr|
|00003540| 6f 20 69 73 20 65 78 70 | 61 6e 64 65 64 20 69 6e |o is exp|anded in|
|00003550| 20 61 20 73 63 72 61 70 | 2c 20 69 74 20 77 69 6c | a scrap|, it wil|
|00003560| 6c 20 5c 65 6d 70 68 7b | 6e 6f 74 7d 20 62 65 20 |l \emph{|not} be |
|00003570| 69 6e 64 65 6e 74 65 64 | 20 74 6f 0a 20 20 6d 61 |indented| to. ma|
|00003580| 74 63 68 20 74 68 65 20 | 69 6e 64 65 6e 74 61 74 |tch the |indentat|
|00003590| 69 6f 6e 20 6f 66 20 74 | 68 65 20 6d 61 63 72 6f |ion of t|he macro|
|000035a0| 20 69 6e 76 6f 63 61 74 | 69 6f 6e 2e 20 54 68 69 | invocat|ion. Thi|
|000035b0| 73 20 66 6c 61 67 20 73 | 65 65 6d 73 0a 20 20 6d |s flag s|eems. m|
|000035c0| 6f 73 74 20 75 73 65 66 | 75 6c 20 66 6f 72 20 46 |ost usef|ul for F|
|000035d0| 6f 72 74 72 61 6e 20 70 | 72 6f 67 72 61 6d 6d 65 |ortran p|rogramme|
|000035e0| 72 73 2e 0a 5c 69 74 65 | 6d 5b 5c 74 74 20 2d 74 |rs..\ite|m[\tt -t|
|000035f0| 5d 20 53 75 70 70 72 65 | 73 73 65 73 20 65 78 70 |] Suppre|sses exp|
|00003600| 61 6e 73 69 6f 6e 20 6f | 66 20 74 61 62 73 20 69 |ansion o|f tabs i|
|00003610| 6e 20 74 68 65 20 70 72 | 6f 67 72 61 6d 20 66 69 |n the pr|ogram fi|
|00003620| 6c 65 2e 20 54 68 69 73 | 0a 20 20 66 65 61 74 75 |le. This|. featu|
|00003630| 72 65 20 69 73 20 75 73 | 65 66 75 6c 20 77 68 65 |re is us|eful whe|
|00003640| 6e 20 67 65 6e 65 72 61 | 74 69 6e 67 20 7c 6d 61 |n genera|ting |ma|
|00003650| 6b 65 7c 20 66 69 6c 65 | 73 2e 0a 5c 65 6e 64 7b |ke| file|s..\end{|
|00003660| 64 65 73 63 72 69 70 74 | 69 6f 6e 7d 0a 0a 0a 5c |descript|ion}...\|
|00003670| 73 75 62 73 65 63 74 69 | 6f 6e 7b 54 68 65 20 4d |subsecti|on{The M|
|00003680| 69 6e 6f 72 20 43 6f 6d | 6d 61 6e 64 73 7d 0a 0a |inor Com|mands}..|
|00003690| 54 68 65 72 65 20 61 72 | 65 20 74 77 6f 20 76 65 |There ar|e two ve|
|000036a0| 72 79 20 6c 6f 77 2d 6c | 65 76 65 6c 20 75 74 69 |ry low-l|evel uti|
|000036b0| 6c 69 74 79 20 63 6f 6d | 6d 61 6e 64 73 20 74 68 |lity com|mands th|
|000036c0| 61 74 20 6d 61 79 20 61 | 70 70 65 61 72 20 61 6e |at may a|ppear an|
|000036d0| 79 77 68 65 72 65 20 69 | 6e 20 74 68 65 0a 77 65 |ywhere i|n the.we|
|000036e0| 62 20 66 69 6c 65 2e 0a | 5c 62 65 67 69 6e 7b 64 |b file..|\begin{d|
|000036f0| 65 73 63 72 69 70 74 69 | 6f 6e 7d 0a 5c 69 74 65 |escripti|on}.\ite|
|00003700| 6d 5b 5c 74 74 20 40 40 | 40 40 5d 20 43 61 75 73 |m[\tt @@|@@] Caus|
|00003710| 65 73 20 61 20 73 69 6e | 67 6c 65 20 61 74 20 73 |es a sin|gle at s|
|00003720| 69 67 6e 20 74 6f 20 62 | 65 20 63 6f 70 69 65 64 |ign to b|e copied|
|00003730| 20 69 6e 74 6f 20 74 68 | 65 20 70 72 6f 67 72 61 | into th|e progra|
|00003740| 6d 2e 0a 5c 69 74 65 6d | 5b 5c 74 65 78 74 74 74 |m..\item|[\texttt|
|00003750| 7b 40 40 69 7d 20 5c 74 | 65 78 74 69 74 7b 66 69 |{@@i} \t|extit{fi|
|00003760| 6c 65 2d 6e 61 6d 65 7d | 5d 20 49 6e 63 6c 75 64 |le-name}|] Includ|
|00003770| 65 73 20 61 20 66 69 6c | 65 2e 20 49 6e 63 6c 75 |es a fil|e. Inclu|
|00003780| 64 65 73 20 6d 61 79 20 | 62 65 0a 20 20 6e 65 73 |des may |be. nes|
|00003790| 74 65 64 2c 20 74 68 6f | 75 67 68 20 74 68 65 72 |ted, tho|ugh ther|
|000037a0| 65 20 69 73 20 63 75 72 | 72 65 6e 74 6c 79 20 61 |e is cur|rently a|
|000037b0| 20 6c 69 6d 69 74 20 6f | 66 20 31 36 7e 6c 65 76 | limit o|f 16~lev|
|000037c0| 65 6c 73 2e 20 54 68 65 | 20 66 69 6c 65 20 6e 61 |els. The| file na|
|000037d0| 6d 65 0a 20 20 73 68 6f | 75 6c 64 20 62 65 20 63 |me. sho|uld be c|
|000037e0| 6f 6d 70 6c 65 74 65 20 | 28 6e 6f 20 65 78 74 65 |omplete |(no exte|
|000037f0| 6e 73 69 6f 6e 20 77 69 | 6c 6c 20 62 65 20 61 70 |nsion wi|ll be ap|
|00003800| 70 65 6e 64 65 64 29 20 | 61 6e 64 20 73 68 6f 75 |pended) |and shou|
|00003810| 6c 64 20 62 65 0a 20 20 | 74 65 72 6d 69 6e 61 74 |ld be. |terminat|
|00003820| 65 64 20 62 79 20 61 20 | 6e 65 77 6c 69 6e 65 2e |ed by a |newline.|
|00003830| 0a 5c 65 6e 64 7b 64 65 | 73 63 72 69 70 74 69 6f |.\end{de|scriptio|
|00003840| 6e 7d 0a 0a 0a 5c 73 75 | 62 73 65 63 74 69 6f 6e |n}...\su|bsection|
|00003850| 7b 49 6e 64 69 63 65 73 | 7d 20 5c 6c 61 62 65 6c |{Indices|} \label|
|00003860| 7b 6d 61 6b 65 69 6e 64 | 69 63 65 73 7d 0a 0a 46 |{makeind|ices}..F|
|00003870| 69 6e 61 6c 6c 79 2c 20 | 74 68 65 72 65 20 61 72 |inally, |there ar|
|00003880| 65 20 74 68 72 65 65 20 | 63 6f 6d 6d 61 6e 64 73 |e three |commands|
|00003890| 20 75 73 65 64 20 74 6f | 20 63 72 65 61 74 65 20 | used to| create |
|000038a0| 69 6e 64 69 63 65 73 20 | 74 6f 20 74 68 65 20 6d |indices |to the m|
|000038b0| 61 63 72 6f 20 6e 61 6d | 65 73 2c 0a 66 69 6c 65 |acro nam|es,.file|
|000038c0| 20 64 65 66 69 6e 69 74 | 69 6f 6e 73 2c 20 61 6e | definit|ions, an|
|000038d0| 64 20 75 73 65 72 2d 73 | 70 65 63 69 66 69 65 64 |d user-s|pecified|
|000038e0| 20 69 64 65 6e 74 69 66 | 69 65 72 73 2e 0a 5c 62 | identif|iers..\b|
|000038f0| 65 67 69 6e 7b 64 65 73 | 63 72 69 70 74 69 6f 6e |egin{des|cription|
|00003900| 7d 0a 5c 69 74 65 6d 5b | 5c 74 74 20 40 40 66 5d |}.\item[|\tt @@f]|
|00003910| 20 43 72 65 61 74 65 20 | 61 6e 20 69 6e 64 65 78 | Create |an index|
|00003920| 20 6f 66 20 66 69 6c 65 | 20 6e 61 6d 65 73 2e 0a | of file| names..|
|00003930| 5c 69 74 65 6d 5b 5c 74 | 74 20 40 40 6d 5d 20 43 |\item[\t|t @@m] C|
|00003940| 72 65 61 74 65 20 61 6e | 20 69 6e 64 65 78 20 6f |reate an| index o|
|00003950| 66 20 6d 61 63 72 6f 20 | 6e 61 6d 65 73 2e 0a 5c |f macro |names..\|
|00003960| 69 74 65 6d 5b 5c 74 74 | 20 40 40 75 5d 20 43 72 |item[\tt| @@u] Cr|
|00003970| 65 61 74 65 20 61 6e 20 | 69 6e 64 65 78 20 6f 66 |eate an |index of|
|00003980| 20 75 73 65 72 2d 73 70 | 65 63 69 66 69 65 64 20 | user-sp|ecified |
|00003990| 69 64 65 6e 74 69 66 69 | 65 72 73 2e 0a 5c 65 6e |identifi|ers..\en|
|000039a0| 64 7b 64 65 73 63 72 69 | 70 74 69 6f 6e 7d 0a 54 |d{descri|ption}.T|
|000039b0| 68 65 73 65 20 63 6f 6d | 6d 61 6e 64 73 20 70 72 |hese com|mands pr|
|000039c0| 6f 64 75 63 65 20 61 20 | 73 65 72 69 65 73 20 6f |oduce a |series o|
|000039d0| 66 20 7c 5c 69 74 65 6d | 7c 20 63 6f 6d 6d 61 6e |f |\item|| comman|
|000039e0| 64 73 20 69 6e 20 74 68 | 65 20 5c 4c 61 54 65 58 |ds in th|e \LaTeX|
|000039f0| 5c 20 66 69 6c 65 2c 0a | 61 6e 64 20 73 6f 20 6d |\ file,.|and so m|
|00003a00| 75 73 74 20 62 65 20 70 | 6c 61 63 65 64 20 77 69 |ust be p|laced wi|
|00003a10| 74 68 69 6e 20 61 20 6c | 69 73 74 20 65 6e 76 69 |thin a l|ist envi|
|00003a20| 72 6f 6e 6d 65 6e 74 20 | 6f 66 20 73 6f 6d 65 20 |ronment |of some |
|00003a30| 73 6f 72 74 2e 20 49 66 | 20 74 68 65 72 65 20 69 |sort. If| there i|
|00003a40| 73 0a 6f 6e 6c 79 20 6f | 6e 65 20 69 6e 64 65 78 |s.only o|ne index|
|00003a50| 2c 20 74 68 65 6e 20 74 | 68 65 20 7c 74 68 65 69 |, then t|he |thei|
|00003a60| 6e 64 65 78 7c 20 65 6e | 76 69 72 6f 6e 6d 65 6e |ndex| en|vironmen|
|00003a70| 74 20 69 73 20 73 75 69 | 74 61 62 6c 65 3b 20 6f |t is sui|table; o|
|00003a80| 74 68 65 72 77 69 73 65 | 2c 0a 74 68 65 20 7c 6e |therwise|,.the |n|
|00003a90| 75 77 65 62 7c 20 70 61 | 63 6b 61 67 65 20 28 73 |uweb| pa|ckage (s|
|00003aa0| 65 65 20 73 65 63 74 69 | 6f 6e 7e 5c 72 65 66 7b |ee secti|on~\ref{|
|00003ab0| 70 61 63 6b 61 67 65 7d | 29 20 73 75 70 70 6c 69 |package}|) suppli|
|00003ac0| 65 73 20 74 68 65 0a 7c | 6e 75 77 65 62 69 6e 64 |es the.||nuwebind|
|00003ad0| 65 78 7c 20 65 6e 76 69 | 72 6f 6e 6d 65 6e 74 2e |ex| envi|ronment.|
|00003ae0| 20 41 20 74 79 70 69 63 | 61 6c 20 69 6e 64 65 78 | A typic|al index|
|00003af0| 20 77 69 6c 6c 20 6c 6f | 6f 6b 20 6c 69 6b 65 20 | will lo|ok like |
|00003b00| 74 68 69 73 3a 0a 5c 62 | 65 67 69 6e 7b 76 65 72 |this:.\b|egin{ver|
|00003b10| 62 61 74 69 6d 7d 0a 5c | 62 65 67 69 6e 7b 6e 75 |batim}.\|begin{nu|
|00003b20| 77 65 62 69 6e 64 65 78 | 7d 5b 32 5d 7b 5c 73 65 |webindex|}[2]{\se|
|00003b30| 63 74 69 6f 6e 7b 49 6e | 64 65 78 7d 7d 0a 40 40 |ction{In|dex}}.@@|
|00003b40| 75 0a 5c 65 6e 64 7b 6e | 75 77 65 62 69 6e 64 65 |u.\end{n|uwebinde|
|00003b50| 78 7d 0a 5c 65 6e 64 7b | 76 65 72 62 61 74 69 6d |x}.\end{|verbatim|
|00003b60| 7d 0a 54 68 65 20 6f 70 | 74 69 6f 6e 61 6c 20 61 |}.The op|tional a|
|00003b70| 72 67 75 6d 65 6e 74 20 | 74 6f 20 74 68 65 20 7c |rgument |to the ||
|00003b80| 6e 75 77 65 62 69 6e 64 | 65 78 7c 20 65 6e 76 69 |nuwebind|ex| envi|
|00003b90| 72 6f 6e 6d 65 6e 74 20 | 67 69 76 65 73 20 74 68 |ronment |gives th|
|00003ba0| 65 20 6e 75 6d 62 65 72 | 20 6f 66 0a 63 6f 6c 75 |e number| of.colu|
|00003bb0| 6d 6e 73 20 74 6f 20 75 | 73 65 2c 20 77 68 69 63 |mns to u|se, whic|
|00003bc0| 68 20 6d 75 73 74 20 62 | 65 20 66 72 6f 6d 20 6f |h must b|e from o|
|00003bd0| 6e 65 20 74 6f 20 74 65 | 6e 2e 20 54 68 65 20 64 |ne to te|n. The d|
|00003be0| 65 66 61 75 6c 74 20 69 | 73 20 74 77 6f 2c 20 77 |efault i|s two, w|
|00003bf0| 68 69 63 68 20 69 73 0a | 75 73 75 61 6c 6c 79 20 |hich is.|usually |
|00003c00| 61 70 70 72 6f 70 72 69 | 61 74 65 2c 20 62 75 74 |appropri|ate, but|
|00003c10| 20 6f 6e 65 20 69 73 20 | 75 73 65 66 75 6c 20 66 | one is |useful f|
|00003c20| 6f 72 20 74 68 65 20 6d | 61 63 72 6f 73 20 69 6e |or the m|acros in|
|00003c30| 64 65 78 2e 20 54 68 65 | 20 73 65 63 6f 6e 64 0a |dex. The| second.|
|00003c40| 61 72 67 75 6d 65 6e 74 | 20 69 73 20 74 65 78 74 |argument| is text|
|00003c50| 20 77 68 69 63 68 20 77 | 69 6c 6c 20 62 65 20 70 | which w|ill be p|
|00003c60| 75 74 20 69 6e 20 61 20 | 73 69 6e 67 6c 65 20 63 |ut in a |single c|
|00003c70| 6f 6c 75 6d 6e 20 6a 75 | 73 74 20 62 65 66 6f 72 |olumn ju|st befor|
|00003c80| 65 20 74 68 65 20 69 6e | 64 65 78 2c 0a 61 6e 64 |e the in|dex,.and|
|00003c90| 20 6b 65 70 74 20 6f 6e | 20 74 68 65 20 73 61 6d | kept on| the sam|
|00003ca0| 65 20 70 61 67 65 2e 20 | 54 68 69 73 20 70 72 65 |e page. |This pre|
|00003cb0| 76 65 6e 74 73 20 61 20 | 70 72 6f 62 6c 65 6d 20 |vents a |problem |
|00003cc0| 77 68 65 72 65 20 68 61 | 76 69 6e 67 20 61 20 7c |where ha|ving a ||
|00003cd0| 5c 73 65 63 74 69 6f 6e | 7c 0a 77 68 69 63 68 20 |\section||.which |
|00003ce0| 73 74 61 72 74 73 20 61 | 74 20 74 68 65 20 74 6f |starts a|t the to|
|00003cf0| 70 20 6f 66 20 61 20 70 | 61 67 65 20 63 61 6e 20 |p of a p|age can |
|00003d00| 63 61 75 73 65 20 61 20 | 70 61 67 65 20 62 72 65 |cause a |page bre|
|00003d10| 61 6b 20 62 65 66 6f 72 | 65 20 74 68 65 0a 7c 6e |ak befor|e the.|n|
|00003d20| 75 77 65 62 69 6e 64 65 | 78 7c 20 65 6e 76 69 72 |uwebinde|x| envir|
|00003d30| 6f 6e 6d 65 6e 74 2c 20 | 62 65 63 61 75 73 65 20 |onment, |because |
|00003d40| 77 68 65 6e 20 74 68 65 | 20 7c 5c 62 65 67 69 6e |when the| |\begin|
|00003d50| 7b 6e 75 77 65 62 69 6e | 64 65 78 7d 7c 20 69 73 |{nuwebin|dex}| is|
|00003d60| 20 65 78 65 63 75 74 65 | 64 0a 74 68 65 20 7c 5c | execute|d.the |\|
|00003d70| 73 65 63 74 69 6f 6e 7c | 20 68 61 73 20 6e 6f 74 |section|| has not|
|00003d80| 20 79 65 74 20 62 65 65 | 6e 20 70 75 73 68 65 64 | yet bee|n pushed|
|00003d90| 20 74 6f 20 74 68 65 20 | 74 6f 70 20 6f 66 20 74 | to the |top of t|
|00003da0| 68 65 20 66 6f 6c 6c 6f | 77 69 6e 67 20 70 61 67 |he follo|wing pag|
|00003db0| 65 2c 20 73 6f 20 61 0a | 70 61 67 65 20 62 72 65 |e, so a.|page bre|
|00003dc0| 61 6b 20 69 73 20 69 6e | 73 65 72 74 65 64 20 61 |ak is in|serted a|
|00003dd0| 66 74 65 72 20 69 74 2c | 20 65 76 65 6e 20 74 68 |fter it,| even th|
|00003de0| 6f 75 67 68 20 6c 61 74 | 65 72 20 69 74 20 77 69 |ough lat|er it wi|
|00003df0| 6c 6c 20 74 75 72 6e 20 | 6f 75 74 20 74 6f 20 62 |ll turn |out to b|
|00003e00| 65 0a 75 6e 6e 65 63 65 | 73 73 61 72 79 2e 0a 0a |e.unnece|ssary...|
|00003e10| 49 6e 64 65 78 20 65 6e | 74 72 69 65 73 20 61 72 |Index en|tries ar|
|00003e20| 65 20 6e 6f 74 20 62 72 | 6f 6b 65 6e 20 6f 76 65 |e not br|oken ove|
|00003e30| 72 20 61 20 63 6f 6c 75 | 6d 6e 20 6f 72 20 70 61 |r a colu|mn or pa|
|00003e40| 67 65 3b 20 74 68 69 73 | 20 70 72 65 76 65 6e 74 |ge; this| prevent|
|00003e50| 73 20 70 72 6f 62 6c 65 | 6d 73 20 61 73 0a 6e 75 |s proble|ms as.nu|
|00003e60| 77 65 62 20 67 65 6e 65 | 72 61 74 65 73 20 6c 6f |web gene|rates lo|
|00003e70| 6e 67 20 69 6e 64 65 78 | 20 6c 69 73 74 73 20 66 |ng index| lists f|
|00003e80| 6f 72 20 66 72 65 71 75 | 65 6e 74 6c 79 20 75 73 |or frequ|ently us|
|00003e90| 65 64 20 69 64 65 6e 74 | 69 66 69 65 72 73 2c 20 |ed ident|ifiers, |
|00003ea0| 77 68 69 63 68 20 63 61 | 6e 0a 73 70 61 6e 20 73 |which ca|n.span s|
|00003eb0| 65 76 65 72 61 6c 20 6c | 69 6e 65 73 2e 20 55 6e |everal l|ines. Un|
|00003ec0| 6c 69 6b 65 20 74 68 65 | 20 7c 74 68 65 69 6e 64 |like the| |theind|
|00003ed0| 65 78 7c 20 65 6e 76 69 | 72 6f 6e 6d 65 6e 74 2c |ex| envi|ronment,|
|00003ee0| 20 6e 6f 20 6e 65 77 20 | 63 68 61 70 74 65 72 20 | no new |chapter |
|00003ef0| 69 73 0a 73 74 61 72 74 | 65 64 3b 20 74 68 69 73 |is.start|ed; this|
|00003f00| 20 63 61 6e 20 62 65 20 | 64 6f 6e 65 20 6d 61 6e | can be |done man|
|00003f10| 75 61 6c 6c 79 20 69 66 | 20 64 65 73 69 72 65 64 |ually if| desired|
|00003f20| 2c 20 75 73 69 6e 67 20 | 61 20 63 6f 6d 6d 61 6e |, using |a comman|
|00003f30| 64 20 73 75 63 68 20 61 | 73 0a 7c 5c 63 68 61 70 |d such a|s.|\chap|
|00003f40| 74 65 72 2a 7b 49 6e 64 | 65 78 7d 7c 2e 0a 0a 49 |ter*{Ind|ex}|...I|
|00003f50| 64 65 6e 74 69 66 69 65 | 72 73 20 6d 75 73 74 20 |dentifie|rs must |
|00003f60| 62 65 20 65 78 70 6c 69 | 63 69 74 6c 79 20 73 70 |be expli|citly sp|
|00003f70| 65 63 69 66 69 65 64 20 | 66 6f 72 20 69 6e 63 6c |ecified |for incl|
|00003f80| 75 73 69 6f 6e 20 69 6e | 20 74 68 65 20 7c 40 40 |usion in| the |@@|
|00003f90| 75 7c 0a 69 6e 64 65 78 | 2e 20 42 79 20 63 6f 6e |u|.index|. By con|
|00003fa0| 76 65 6e 74 69 6f 6e 2c | 20 65 61 63 68 20 69 64 |vention,| each id|
|00003fb0| 65 6e 74 69 66 69 65 72 | 20 69 73 20 6d 61 72 6b |entifier| is mark|
|00003fc0| 65 64 20 61 74 20 74 68 | 65 20 70 6f 69 6e 74 20 |ed at th|e point |
|00003fd0| 6f 66 20 69 74 73 0a 64 | 65 66 69 6e 69 74 69 6f |of its.d|efinitio|
|00003fe0| 6e 3b 20 61 6c 6c 20 72 | 65 66 65 72 65 6e 63 65 |n; all r|eference|
|00003ff0| 73 20 74 6f 20 65 61 63 | 68 20 69 64 65 6e 74 69 |s to eac|h identi|
|00004000| 66 69 65 72 20 69 6e 73 | 69 64 65 20 73 63 72 61 |fier ins|ide scra|
|00004010| 70 73 20 77 69 6c 6c 20 | 62 65 0a 64 69 73 63 6f |ps will |be.disco|
|00004020| 76 65 72 65 64 20 61 75 | 74 6f 6d 61 74 69 63 61 |vered au|tomatica|
|00004030| 6c 6c 79 2e 20 54 6f 20 | 6d 61 72 6b 20 61 6e 20 |lly. To |mark an |
|00004040| 69 64 65 6e 74 69 66 69 | 65 72 20 66 6f 72 20 69 |identifi|er for i|
|00004050| 6e 63 6c 75 73 69 6f 6e | 20 69 6e 20 74 68 65 20 |nclusion| in the |
|00004060| 69 6e 64 65 78 2c 0a 69 | 74 20 69 73 20 69 6e 63 |index,.i|t is inc|
|00004070| 6c 75 64 65 64 20 61 66 | 74 65 72 20 74 68 65 20 |luded af|ter the |
|00004080| 73 69 67 6e 20 5c 76 65 | 72 62 21 40 40 7c 21 20 |sign \ve|rb!@@|! |
|00004090| 61 74 20 74 68 65 20 65 | 6e 64 20 6f 66 20 61 20 |at the e|nd of a |
|000040a0| 73 63 72 61 70 2e 20 46 | 6f 72 20 65 78 61 6d 70 |scrap. F|or examp|
|000040b0| 6c 65 2c 0a 5c 62 65 67 | 69 6e 7b 71 75 6f 74 65 |le,.\beg|in{quote|
|000040c0| 7d 0a 5c 62 65 67 69 6e | 7b 76 65 72 62 61 74 69 |}.\begin|{verbati|
|000040d0| 6d 7d 0a 40 40 64 20 61 | 20 73 63 72 61 70 0a 40 |m}.@@d a| scrap.@|
|000040e0| 40 7b 20 4c 65 74 27 73 | 20 70 72 65 74 65 6e 64 |@{ Let's| pretend|
|000040f0| 20 77 65 27 72 65 20 64 | 65 63 6c 61 72 69 6e 67 | we're d|eclaring|
|00004100| 20 74 68 65 20 76 61 72 | 69 61 62 6c 65 73 0a 46 | the var|iables.F|
|00004110| 4f 4f 20 61 6e 64 20 42 | 41 52 20 69 6e 73 69 64 |OO and B|AR insid|
|00004120| 65 20 74 68 69 73 20 73 | 63 72 61 70 2e 0a 40 40 |e this s|crap..@@|
|00004130| 7c 20 46 4f 4f 20 42 41 | 52 0a 40 40 7d 0a 5c 65 || FOO BA|R.@@}.\e|
|00004140| 6e 64 7b 76 65 72 62 61 | 74 69 6d 7d 0a 5c 65 6e |nd{verba|tim}.\en|
|00004150| 64 7b 71 75 6f 74 65 7d | 0a 49 27 76 65 20 75 73 |d{quote}|.I've us|
|00004160| 65 64 20 61 6c 70 68 61 | 62 65 74 69 63 20 69 64 |ed alpha|betic id|
|00004170| 65 6e 74 69 66 69 65 72 | 73 20 69 6e 20 74 68 69 |entifier|s in thi|
|00004180| 73 20 65 78 61 6d 70 6c | 65 2c 20 62 75 74 20 61 |s exampl|e, but a|
|00004190| 6e 79 20 73 74 72 69 6e | 67 20 6f 66 0a 63 68 61 |ny strin|g of.cha|
|000041a0| 72 61 63 74 65 72 73 20 | 28 6e 6f 74 20 69 6e 63 |racters |(not inc|
|000041b0| 6c 75 64 69 6e 67 20 77 | 68 69 74 65 5c 2d 73 70 |luding w|hite\-sp|
|000041c0| 61 63 65 20 6f 72 20 7c | 40 40 7c 20 63 68 61 72 |ace or ||@@| char|
|000041d0| 61 63 74 65 72 73 29 20 | 77 69 6c 6c 20 64 6f 2e |acters) |will do.|
|000041e0| 0a 54 68 65 72 65 66 6f | 72 65 2c 20 69 74 27 73 |.Therefo|re, it's|
|000041f0| 20 70 6f 73 73 69 62 6c | 65 20 74 6f 20 61 64 64 | possibl|e to add|
|00004200| 20 69 6e 64 65 78 20 65 | 6e 74 72 69 65 73 20 66 | index e|ntries f|
|00004210| 6f 72 20 74 68 69 6e 67 | 73 20 6c 69 6b 65 20 7c |or thing|s like ||
|00004220| 3c 3c 3d 7c 20 69 66 0a | 64 65 73 69 72 65 64 2e |<<=| if.|desired.|
|00004230| 20 41 6e 20 69 64 65 6e | 74 69 66 69 65 72 20 6d | An iden|tifier m|
|00004240| 61 79 20 62 65 20 64 65 | 63 6c 61 72 65 64 20 69 |ay be de|clared i|
|00004250| 6e 20 6d 6f 72 65 20 74 | 68 61 6e 20 6f 6e 65 20 |n more t|han one |
|00004260| 73 63 72 61 70 2e 0a 0a | 49 6e 20 74 68 65 20 67 |scrap...|In the g|
|00004270| 65 6e 65 72 61 74 65 64 | 20 69 6e 64 65 78 2c 20 |enerated| index, |
|00004280| 65 61 63 68 20 69 64 65 | 6e 74 69 66 69 65 72 20 |each ide|ntifier |
|00004290| 61 70 70 65 61 72 73 20 | 77 69 74 68 20 61 20 6c |appears |with a l|
|000042a0| 69 73 74 20 6f 66 20 61 | 6c 6c 20 74 68 65 20 73 |ist of a|ll the s|
|000042b0| 63 72 61 70 73 0a 75 73 | 69 6e 67 20 61 6e 64 20 |craps.us|ing and |
|000042c0| 64 65 66 69 6e 69 6e 67 | 20 69 74 2c 20 77 68 65 |defining| it, whe|
|000042d0| 72 65 20 74 68 65 20 64 | 65 66 69 6e 69 6e 67 20 |re the d|efining |
|000042e0| 73 63 72 61 70 73 20 61 | 72 65 20 64 69 73 74 69 |scraps a|re disti|
|000042f0| 6e 67 75 69 73 68 65 64 | 20 62 79 0a 75 6e 64 65 |nguished| by.unde|
|00004300| 72 6c 69 6e 69 6e 67 2e | 20 49 66 20 74 68 65 20 |rlining.| If the |
|00004310| 7c 2d 6e 7c 20 66 6c 61 | 67 20 69 73 20 75 73 65 ||-n| fla|g is use|
|00004320| 64 20 74 6f 20 6e 75 77 | 65 62 20 28 73 65 65 0a |d to nuw|eb (see.|
|00004330| 73 65 63 74 69 6f 6e 7e | 5c 72 65 66 7b 72 75 6e |section~|\ref{run|
|00004340| 6e 69 6e 67 7d 29 2c 20 | 74 68 65 73 65 20 73 63 |ning}), |these sc|
|00004350| 72 61 70 20 6e 75 6d 62 | 65 72 73 20 77 69 6c 6c |rap numb|ers will|
|00004360| 20 6e 6f 74 20 62 65 20 | 70 61 67 65 20 6e 75 6d | not be |page num|
|00004370| 62 65 72 73 2e 20 4e 6f | 74 65 0a 74 68 61 74 20 |bers. No|te.that |
|00004380| 74 68 65 20 69 64 65 6e | 74 69 66 69 65 72 20 64 |the iden|tifier d|
|00004390| 6f 65 73 6e 27 74 20 61 | 63 74 75 61 6c 6c 79 20 |oesn't a|ctually |
|000043a0| 68 61 76 65 20 74 6f 20 | 61 70 70 65 61 72 20 69 |have to |appear i|
|000043b0| 6e 20 74 68 65 20 64 65 | 66 69 6e 69 6e 67 20 73 |n the de|fining s|
|000043c0| 63 72 61 70 3b 20 69 74 | 0a 6a 75 73 74 20 68 61 |crap; it|.just ha|
|000043d0| 73 20 74 6f 20 62 65 20 | 69 6e 20 74 68 65 20 6c |s to be |in the l|
|000043e0| 69 73 74 20 6f 66 20 64 | 65 66 69 6e 69 74 69 6f |ist of d|efinitio|
|000043f0| 6e 73 20 61 74 20 74 68 | 65 20 65 6e 64 20 6f 66 |ns at th|e end of|
|00004400| 20 61 20 73 63 72 61 70 | 2e 0a 0a 0a 5c 73 75 62 | a scrap|....\sub|
|00004410| 73 65 63 74 69 6f 6e 7b | 54 68 65 20 5c 74 65 78 |section{|The \tex|
|00004420| 74 73 66 7b 6e 75 77 65 | 62 7d 20 70 61 63 6b 61 |tsf{nuwe|b} packa|
|00004430| 67 65 7d 20 5c 6c 61 62 | 65 6c 7b 70 61 63 6b 61 |ge} \lab|el{packa|
|00004440| 67 65 7d 0a 0a 57 68 65 | 6e 20 6e 75 77 65 62 20 |ge}..Whe|n nuweb |
|00004450| 69 73 20 75 73 65 64 20 | 74 6f 20 70 72 6f 64 75 |is used |to produ|
|00004460| 63 65 20 5c 4c 61 54 65 | 58 5c 20 6f 75 74 70 75 |ce \LaTe|X\ outpu|
|00004470| 74 2c 20 74 68 65 20 5c | 74 65 78 74 73 66 7b 6e |t, the \|textsf{n|
|00004480| 75 77 65 62 7d 20 70 61 | 63 6b 61 67 65 20 6d 75 |uweb} pa|ckage mu|
|00004490| 73 74 0a 62 65 20 75 73 | 65 64 2c 20 61 73 20 69 |st.be us|ed, as i|
|000044a0| 74 20 70 72 6f 76 69 64 | 65 73 20 63 6f 6d 6d 61 |t provid|es comma|
|000044b0| 6e 64 73 20 74 68 61 74 | 20 6e 75 77 65 62 20 75 |nds that| nuweb u|
|000044c0| 73 65 73 20 74 6f 20 70 | 65 72 66 6f 72 6d 20 69 |ses to p|erform i|
|000044d0| 74 73 20 66 6f 72 6d 61 | 74 74 69 6e 67 2e 0a 49 |ts forma|tting..I|
|000044e0| 66 20 79 6f 75 20 77 61 | 6e 74 20 74 6f 20 63 68 |f you wa|nt to ch|
|000044f0| 61 6e 67 65 20 74 68 65 | 20 77 61 79 20 73 63 72 |ange the| way scr|
|00004500| 61 70 73 20 61 72 65 20 | 66 6f 72 6d 61 74 74 65 |aps are |formatte|
|00004510| 64 2c 20 79 6f 75 20 63 | 61 6e 20 72 65 64 65 66 |d, you c|an redef|
|00004520| 69 6e 65 20 74 68 65 73 | 65 0a 63 6f 6d 6d 61 6e |ine thes|e.comman|
|00004530| 64 73 3b 20 66 6f 72 20 | 64 65 74 61 69 6c 73 2c |ds; for |details,|
|00004540| 20 73 65 65 20 63 68 61 | 70 74 65 72 7e 5c 69 66 | see cha|pter~\if|
|00004550| 74 68 65 6e 65 6c 73 65 | 7b 5c 65 71 75 61 6c 7b |thenelse|{\equal{|
|00004560| 5c 68 69 64 65 63 6f 64 | 65 7d 7b 74 72 75 65 7d |\hidecod|e}{true}|
|00004570| 7d 7b 34 20 6f 66 0a 74 | 68 65 20 66 75 6c 6c 20 |}{4 of.t|he full |
|00004580| 64 6f 63 75 6d 65 6e 74 | 61 74 69 6f 6e 20 28 70 |document|ation (p|
|00004590| 72 6f 64 75 63 65 64 20 | 66 72 6f 6d 0a 5c 74 65 |roduced |from.\te|
|000045a0| 78 74 74 74 7b 6e 75 77 | 65 62 2e 74 65 78 7d 29 |xttt{nuw|eb.tex})|
|000045b0| 2e 7d 7b 5c 72 65 66 7b | 66 6f 72 6d 61 74 74 69 |.}{\ref{|formatti|
|000045c0| 6e 67 73 63 72 61 70 73 | 7d 2e 7d 0a 0a 54 77 6f |ngscraps|}.}..Two|
|000045d0| 20 66 61 63 69 6c 69 74 | 69 65 73 20 61 72 65 20 | facilit|ies are |
|000045e0| 70 72 6f 76 69 64 65 64 | 20 66 6f 72 20 74 68 65 |provided| for the|
|000045f0| 20 75 73 65 72 3a 20 74 | 68 65 20 5c 74 65 78 74 | user: t|he \text|
|00004600| 74 74 7b 6e 75 77 65 62 | 69 6e 64 65 78 7d 20 65 |tt{nuweb|index} e|
|00004610| 6e 76 69 72 6f 6e 6d 65 | 6e 74 0a 28 73 65 65 20 |nvironme|nt.(see |
|00004620| 73 65 63 74 69 6f 6e 7e | 5c 72 65 66 7b 6d 61 6b |section~|\ref{mak|
|00004630| 65 69 6e 64 69 63 65 73 | 7d 29 2c 20 61 6e 64 20 |eindices|}), and |
|00004640| 63 6f 6d 6d 61 6e 64 73 | 20 74 6f 20 61 64 64 20 |commands| to add |
|00004650| 61 20 74 65 72 6d 69 6e | 61 74 69 6e 67 20 73 79 |a termin|ating sy|
|00004660| 6d 62 6f 6c 20 74 6f 0a | 74 68 65 20 65 6e 64 20 |mbol to.|the end |
|00004670| 6f 66 20 65 61 63 68 20 | 73 63 72 61 70 3b 20 73 |of each |scrap; s|
|00004680| 6f 6d 65 20 61 75 74 68 | 6f 72 73 20 66 65 65 6c |ome auth|ors feel|
|00004690| 20 74 68 69 73 20 6d 61 | 6b 65 73 20 77 65 62 73 | this ma|kes webs|
|000046a0| 20 65 61 73 69 65 72 20 | 74 6f 20 72 65 61 64 2e | easier |to read.|
|000046b0| 20 54 68 65 0a 63 6f 6d | 6d 61 6e 64 73 20 61 72 | The.com|mands ar|
|000046c0| 65 3a 0a 5c 62 65 67 69 | 6e 7b 71 75 6f 74 65 7d |e:.\begi|n{quote}|
|000046d0| 0a 7c 5c 6e 75 77 65 62 | 74 65 72 6d 69 6e 61 74 |.|\nuweb|terminat|
|000046e0| 6f 72 7b 7c 5c 74 65 78 | 74 69 74 7b 63 6f 6d 6d |or{|\tex|tit{comm|
|000046f0| 61 6e 64 7d 7c 7d 7c 0a | 5c 65 6e 64 7b 71 75 6f |and}|}|.|\end{quo|
|00004700| 74 65 7d 0a 77 68 65 72 | 65 20 5c 74 65 78 74 69 |te}.wher|e \texti|
|00004710| 74 7b 63 6f 6d 6d 61 6e | 64 7d 20 69 73 20 65 78 |t{comman|d} is ex|
|00004720| 65 63 75 74 65 64 20 61 | 74 20 74 68 65 20 65 6e |ecuted a|t the en|
|00004730| 64 20 6f 66 20 65 76 65 | 72 79 20 73 63 72 61 70 |d of eve|ry scrap|
|00004740| 2e 20 49 6e 20 65 61 72 | 6c 69 65 72 0a 76 65 72 |. In ear|lier.ver|
|00004750| 73 69 6f 6e 73 20 6f 66 | 20 6e 75 77 65 62 2c 20 |sions of| nuweb, |
|00004760| 61 20 64 69 61 6d 6f 6e | 64 20 28 24 5c 44 69 61 |a diamon|d ($\Dia|
|00004770| 6d 6f 6e 64 24 29 20 77 | 61 73 20 75 73 65 64 3b |mond$) w|as used;|
|00004780| 20 74 6f 20 6f 62 74 61 | 69 6e 20 74 68 69 73 20 | to obta|in this |
|00004790| 65 66 66 65 63 74 2c 0a | 75 73 65 20 74 68 65 20 |effect,.|use the |
|000047a0| 63 6f 6d 6d 61 6e 64 0a | 5c 62 65 67 69 6e 7b 71 |command.|\begin{q|
|000047b0| 75 6f 74 65 7d 0a 7c 5c | 6e 75 77 65 62 74 65 72 |uote}.|\|nuwebter|
|000047c0| 6d 69 6e 61 74 6f 72 7b | 5c 28 5c 44 69 61 6d 6f |minator{|\(\Diamo|
|000047d0| 6e 64 5c 29 7d 7c 0a 5c | 65 6e 64 7b 71 75 6f 74 |nd\)}|.\|end{quot|
|000047e0| 65 7d 0a 54 6f 20 68 61 | 76 65 20 6e 6f 20 74 65 |e}.To ha|ve no te|
|000047f0| 72 6d 69 6e 61 74 69 6e | 67 20 73 79 6d 62 6f 6c |rminatin|g symbol|
|00004800| 20 28 74 68 65 20 64 65 | 66 61 75 6c 74 29 2c 20 | (the de|fault), |
|00004810| 75 73 65 20 74 68 65 20 | 63 6f 6d 6d 61 6e 64 0a |use the |command.|
|00004820| 5c 62 65 67 69 6e 7b 71 | 75 6f 74 65 7d 0a 7c 5c |\begin{q|uote}.|\|
|00004830| 6e 75 77 65 62 6e 6f 74 | 65 72 6d 69 6e 61 74 6f |nuwebnot|erminato|
|00004840| 72 7c 0a 5c 65 6e 64 7b | 71 75 6f 74 65 7d 0a 0a |r|.\end{|quote}..|
|00004850| 0a 0a 5c 73 65 63 74 69 | 6f 6e 7b 52 75 6e 6e 69 |..\secti|on{Runni|
|00004860| 6e 67 20 4e 75 77 65 62 | 7d 20 5c 6c 61 62 65 6c |ng Nuweb|} \label|
|00004870| 7b 72 75 6e 6e 69 6e 67 | 7d 0a 0a 4e 75 77 65 62 |{running|}..Nuweb|
|00004880| 20 69 73 20 69 6e 76 6f | 6b 65 64 20 75 73 69 6e | is invo|ked usin|
|00004890| 67 20 74 68 65 20 66 6f | 6c 6c 6f 77 69 6e 67 20 |g the fo|llowing |
|000048a0| 63 6f 6d 6d 61 6e 64 3a | 0a 5c 62 65 67 69 6e 7b |command:|.\begin{|
|000048b0| 71 75 6f 74 65 7d 0a 5c | 74 65 78 74 74 74 7b 6e |quote}.\|texttt{n|
|000048c0| 75 77 65 62 7d 20 5c 74 | 65 78 74 69 74 7b 66 6c |uweb} \t|extit{fl|
|000048d0| 61 67 73 20 5b 5c 74 65 | 78 74 74 74 7b 2d 6f 7d |ags [\te|xttt{-o}|
|000048e0| 20 66 69 6c 65 5d 20 66 | 69 6c 65 7d 5c 64 6f 74 | file] f|ile}\dot|
|000048f0| 73 0a 5c 65 6e 64 7b 71 | 75 6f 74 65 7d 0a 4f 6e |s.\end{q|uote}.On|
|00004900| 65 20 6f 72 20 6d 6f 72 | 65 20 66 69 6c 65 73 20 |e or mor|e files |
|00004910| 6d 61 79 20 62 65 20 70 | 72 6f 63 65 73 73 65 64 |may be p|rocessed|
|00004920| 20 61 74 20 61 20 74 69 | 6d 65 3b 20 65 61 63 68 | at a ti|me; each|
|00004930| 20 66 69 6c 65 20 6d 61 | 79 20 68 61 76 65 20 74 | file ma|y have t|
|00004940| 68 65 20 6e 61 6d 65 20 | 6f 66 0a 69 74 73 20 64 |he name |of.its d|
|00004950| 6f 63 75 6d 65 6e 74 61 | 74 69 6f 6e 20 66 69 6c |ocumenta|tion fil|
|00004960| 65 20 73 70 65 63 69 66 | 69 65 64 2c 20 75 73 69 |e specif|ied, usi|
|00004970| 6e 67 20 5c 6d 62 6f 78 | 7b 5c 74 65 78 74 74 74 |ng \mbox|{\texttt|
|00004980| 7b 2d 6f 7d 20 5c 74 65 | 78 74 69 74 7b 66 69 6c |{-o} \te|xtit{fil|
|00004990| 65 7d 7d 2e 20 54 68 65 | 0a 64 6f 63 75 6d 65 6e |e}}. The|.documen|
|000049a0| 74 61 74 69 6f 6e 20 66 | 69 6c 65 20 6e 61 6d 65 |tation f|ile name|
|000049b0| 20 6d 75 73 74 20 69 6e | 63 6c 75 64 65 20 74 68 | must in|clude th|
|000049c0| 65 20 65 78 74 65 6e 73 | 69 6f 6e 2e 20 49 66 20 |e extens|ion. If |
|000049d0| 61 20 66 69 6c 65 20 6e | 61 6d 65 20 68 61 73 20 |a file n|ame has |
|000049e0| 6e 6f 0a 65 78 74 65 6e | 73 69 6f 6e 2c 20 7c 2e |no.exten|sion, |.|
|000049f0| 77 7c 20 77 69 6c 6c 20 | 62 65 20 61 70 70 65 6e |w| will |be appen|
|00004a00| 64 65 64 2e 20 20 5c 4c | 61 54 65 58 5c 20 73 75 |ded. \L|aTeX\ su|
|00004a10| 69 74 61 62 6c 65 20 66 | 6f 72 20 74 72 61 6e 73 |itable f|or trans|
|00004a20| 6c 61 74 69 6f 6e 20 69 | 6e 74 6f 0a 5c 48 54 4d |lation i|nto.\HTM|
|00004a30| 4c 5c 20 62 79 20 7b 5c | 4c 61 54 65 58 7d 32 5c |L\ by {\|LaTeX}2\|
|00004a40| 48 54 4d 4c 5c 20 77 69 | 6c 6c 20 62 65 20 70 72 |HTML\ wi|ll be pr|
|00004a50| 6f 64 75 63 65 64 20 66 | 72 6f 6d 20 66 69 6c 65 |oduced f|rom file|
|00004a60| 73 20 77 68 6f 73 65 20 | 6e 61 6d 65 20 65 6e 64 |s whose |name end|
|00004a70| 73 20 77 69 74 68 0a 7c | 2e 68 77 7c 3b 20 73 6f |s with.||.hw|; so|
|00004a80| 75 72 63 65 20 6d 61 72 | 6b 65 64 20 75 70 20 69 |urce mar|ked up i|
|00004a90| 6e 20 5c 48 54 4d 4c 5c | 20 73 68 6f 75 6c 64 20 |n \HTML\| should |
|00004aa0| 68 61 76 65 20 74 68 65 | 20 65 78 74 65 6e 73 69 |have the| extensi|
|00004ab0| 6f 6e 20 7c 2e 68 74 77 | 7c 2e 0a 57 68 69 6c 65 |on |.htw||..While|
|00004ac0| 20 61 20 66 69 6c 65 20 | 6e 61 6d 65 20 6d 61 79 | a file |name may|
|00004ad0| 20 73 70 65 63 69 66 79 | 20 61 20 66 69 6c 65 20 | specify| a file |
|00004ae0| 69 6e 20 61 6e 6f 74 68 | 65 72 20 64 69 72 65 63 |in anoth|er direc|
|00004af0| 74 6f 72 79 2c 20 74 68 | 65 20 72 65 73 75 6c 74 |tory, th|e result|
|00004b00| 69 6e 67 0a 64 6f 63 75 | 6d 65 6e 74 61 74 69 6f |ing.docu|mentatio|
|00004b10| 6e 20 66 69 6c 65 20 77 | 69 6c 6c 20 61 6c 77 61 |n file w|ill alwa|
|00004b20| 79 73 20 62 65 20 63 72 | 65 61 74 65 64 20 69 6e |ys be cr|eated in|
|00004b30| 20 74 68 65 20 63 75 72 | 72 65 6e 74 20 64 69 72 | the cur|rent dir|
|00004b40| 65 63 74 6f 72 79 20 75 | 6e 6c 65 73 73 20 74 68 |ectory u|nless th|
|00004b50| 65 0a 6f 75 74 70 75 74 | 20 66 69 6c 65 6e 61 6d |e.output| filenam|
|00004b60| 65 20 69 73 20 73 70 65 | 63 69 66 69 65 64 20 75 |e is spe|cified u|
|00004b70| 73 69 6e 67 20 74 68 65 | 20 7c 2d 6f 7c 20 66 6c |sing the| |-o| fl|
|00004b80| 61 67 2e 20 46 6f 72 20 | 65 78 61 6d 70 6c 65 2c |ag. For |example,|
|00004b90| 0a 5c 62 65 67 69 6e 7b | 71 75 6f 74 65 7d 0a 5c |.\begin{|quote}.\|
|00004ba0| 74 65 78 74 74 74 7b 6e | 75 77 65 62 20 2f 66 6f |texttt{n|uweb /fo|
|00004bb0| 6f 2f 62 61 72 2f 71 75 | 75 78 7d 0a 5c 65 6e 64 |o/bar/qu|ux}.\end|
|00004bc0| 7b 71 75 6f 74 65 7d 0a | 77 69 6c 6c 20 74 61 6b |{quote}.|will tak|
|00004bd0| 65 20 61 73 20 69 6e 70 | 75 74 20 74 68 65 20 66 |e as inp|ut the f|
|00004be0| 69 6c 65 20 7c 2f 66 6f | 6f 2f 62 61 72 2f 71 75 |ile |/fo|o/bar/qu|
|00004bf0| 75 78 2e 77 7c 20 61 6e | 64 20 77 69 6c 6c 20 63 |ux.w| an|d will c|
|00004c00| 72 65 61 74 65 20 74 68 | 65 20 66 69 6c 65 0a 7c |reate th|e file.||
|00004c10| 71 75 75 78 2e 74 65 78 | 7c 20 69 6e 20 74 68 65 |quux.tex|| in the|
|00004c20| 20 63 75 72 72 65 6e 74 | 20 64 69 72 65 63 74 6f | current| directo|
|00004c30| 72 79 2e 0a 0a 42 79 20 | 64 65 66 61 75 6c 74 2c |ry...By |default,|
|00004c40| 20 6e 75 77 65 62 20 70 | 65 72 66 6f 72 6d 73 20 | nuweb p|erforms |
|00004c50| 62 6f 74 68 20 74 61 6e | 67 6c 69 6e 67 20 61 6e |both tan|gling an|
|00004c60| 64 20 77 65 61 76 69 6e | 67 20 61 74 20 74 68 65 |d weavin|g at the|
|00004c70| 20 73 61 6d 65 20 74 69 | 6d 65 2e 0a 4e 6f 72 6d | same ti|me..Norm|
|00004c80| 61 6c 6c 79 2c 20 74 68 | 69 73 20 69 73 20 6e 6f |ally, th|is is no|
|00004c90| 74 20 61 20 62 6f 74 74 | 6c 65 6e 65 63 6b 20 69 |t a bott|leneck i|
|00004ca0| 6e 20 74 68 65 20 63 6f | 6d 70 69 6c 61 74 69 6f |n the co|mpilatio|
|00004cb0| 6e 20 70 72 6f 63 65 73 | 73 3b 20 68 6f 77 65 76 |n proces|s; howev|
|00004cc0| 65 72 2c 20 69 74 27 73 | 0a 70 6f 73 73 69 62 6c |er, it's|.possibl|
|00004cd0| 65 20 74 6f 20 61 63 68 | 69 65 76 65 20 73 6c 69 |e to ach|ieve sli|
|00004ce0| 67 68 74 6c 79 20 66 61 | 73 74 65 72 20 74 68 72 |ghtly fa|ster thr|
|00004cf0| 6f 75 67 68 70 75 74 20 | 62 79 20 61 76 6f 69 64 |oughput |by avoid|
|00004d00| 69 6e 67 20 6f 6e 65 20 | 6f 72 20 61 6e 6f 74 68 |ing one |or anoth|
|00004d10| 65 72 20 6f 66 0a 74 68 | 65 20 64 65 66 61 75 6c |er of.th|e defaul|
|00004d20| 74 20 66 75 6e 63 74 69 | 6f 6e 73 20 75 73 69 6e |t functi|ons usin|
|00004d30| 67 20 63 6f 6d 6d 61 6e | 64 2d 6c 69 6e 65 20 66 |g comman|d-line f|
|00004d40| 6c 61 67 73 2e 20 54 68 | 65 72 65 20 61 72 65 20 |lags. Th|ere are |
|00004d50| 63 75 72 72 65 6e 74 6c | 79 20 66 69 76 65 0a 70 |currentl|y five.p|
|00004d60| 6f 73 73 69 62 6c 65 20 | 66 6c 61 67 73 3a 0a 5c |ossible |flags:.\|
|00004d70| 62 65 67 69 6e 7b 64 65 | 73 63 72 69 70 74 69 6f |begin{de|scriptio|
|00004d80| 6e 7d 0a 5c 69 74 65 6d | 5b 5c 74 65 78 74 74 74 |n}.\item|[\texttt|
|00004d90| 7b 2d 6f 7d 20 5c 74 65 | 78 74 69 74 7b 66 69 6c |{-o} \te|xtit{fil|
|00004da0| 65 7d 5d 20 43 61 6c 6c | 20 74 68 65 20 64 6f 63 |e}] Call| the doc|
|00004db0| 75 6d 65 6e 74 61 74 69 | 6f 6e 20 66 69 6c 65 20 |umentati|on file |
|00004dc0| 5c 74 65 78 74 69 74 7b | 66 69 6c 65 7d 2e 0a 54 |\textit{|file}..T|
|00004dd0| 68 65 20 66 69 6c 65 6e | 61 6d 65 20 6d 75 73 74 |he filen|ame must|
|00004de0| 20 69 6e 63 6c 75 64 65 | 20 74 68 65 20 65 78 74 | include| the ext|
|00004df0| 65 6e 73 69 6f 6e 2e 0a | 5c 69 74 65 6d 5b 5c 74 |ension..|\item[\t|
|00004e00| 74 20 2d 74 5d 20 53 75 | 70 70 72 65 73 73 20 67 |t -t] Su|ppress g|
|00004e10| 65 6e 65 72 61 74 69 6f | 6e 20 6f 66 20 74 68 65 |eneratio|n of the|
|00004e20| 20 64 6f 63 75 6d 65 6e | 74 61 74 69 6f 6e 20 66 | documen|tation f|
|00004e30| 69 6c 65 2e 0a 5c 69 74 | 65 6d 5b 5c 74 74 20 2d |ile..\it|em[\tt -|
|00004e40| 70 5d 20 53 75 70 70 72 | 65 73 73 20 67 65 6e 65 |p] Suppr|ess gene|
|00004e50| 72 61 74 69 6f 6e 20 6f | 66 20 74 68 65 20 70 72 |ration o|f the pr|
|00004e60| 6f 67 72 61 6d 20 66 69 | 6c 65 73 2e 0a 5c 69 74 |ogram fi|les..\it|
|00004e70| 65 6d 5b 5c 74 74 20 2d | 63 5d 20 41 76 6f 69 64 |em[\tt -|c] Avoid|
|00004e80| 20 74 65 73 74 69 6e 67 | 20 70 72 6f 67 72 61 6d | testing| program|
|00004e90| 20 66 69 6c 65 73 20 66 | 6f 72 20 63 68 61 6e 67 | files f|or chang|
|00004ea0| 65 20 62 65 66 6f 72 65 | 20 75 70 64 61 74 69 6e |e before| updatin|
|00004eb0| 67 20 74 68 65 6d 2e 0a | 5c 69 74 65 6d 5b 5c 74 |g them..|\item[\t|
|00004ec0| 74 20 2d 43 5d 20 49 67 | 6e 6f 72 65 20 7c 23 6c |t -C] Ig|nore |#l|
|00004ed0| 69 6e 65 7c 20 64 69 72 | 65 63 74 69 76 65 73 20 |ine| dir|ectives |
|00004ee0| 77 68 65 6e 20 74 65 73 | 74 69 6e 67 20 70 72 6f |when tes|ting pro|
|00004ef0| 67 72 61 6d 20 66 69 6c | 65 73 20 66 6f 72 0a 63 |gram fil|es for.c|
|00004f00| 68 61 6e 67 65 2e 20 54 | 68 69 73 20 61 76 6f 69 |hange. T|his avoi|
|00004f10| 64 73 20 73 6f 75 72 63 | 65 20 66 69 6c 65 73 20 |ds sourc|e files |
|00004f20| 62 65 69 6e 67 20 72 65 | 67 65 6e 65 72 61 74 65 |being re|generate|
|00004f30| 64 20 6a 75 73 74 20 62 | 65 63 61 75 73 65 20 79 |d just b|ecause y|
|00004f40| 6f 75 20 68 61 76 65 0a | 63 68 61 6e 67 65 64 20 |ou have.|changed |
|00004f50| 74 68 65 20 6c 69 6e 65 | 20 6e 75 6d 62 65 72 73 |the line| numbers|
|00004f60| 20 61 74 20 77 68 69 63 | 68 20 74 68 65 69 72 20 | at whic|h their |
|00004f70| 63 6f 64 65 20 61 70 70 | 65 61 72 73 20 69 6e 20 |code app|ears in |
|00004f80| 74 68 65 20 6e 75 77 65 | 62 20 64 6f 63 75 6d 65 |the nuwe|b docume|
|00004f90| 6e 74 2e 0a 55 73 69 6e | 67 20 74 68 69 73 20 6f |nt..Usin|g this o|
|00004fa0| 70 74 69 6f 6e 20 77 69 | 6c 6c 20 73 61 76 65 20 |ption wi|ll save |
|00004fb0| 61 20 6c 6f 74 20 6f 66 | 20 72 65 6d 61 6b 69 6e |a lot of| remakin|
|00004fc0| 67 2c 20 62 75 74 20 6d | 61 79 20 72 65 73 75 6c |g, but m|ay resul|
|00004fd0| 74 20 69 6e 20 64 65 62 | 75 67 0a 69 6e 66 6f 72 |t in deb|ug.infor|
|00004fe0| 6d 61 74 69 6f 6e 20 62 | 65 69 6e 67 20 6f 75 74 |mation b|eing out|
|00004ff0| 20 6f 66 20 64 61 74 65 | 2e 20 43 6f 6d 70 69 6c | of date|. Compil|
|00005000| 65 72 20 65 72 72 6f 72 | 20 6d 65 73 73 61 67 65 |er error| message|
|00005010| 73 20 73 68 6f 75 6c 64 | 20 61 6c 77 61 79 73 20 |s should| always |
|00005020| 62 65 0a 63 6f 72 72 65 | 63 74 2c 20 74 68 6f 75 |be.corre|ct, thou|
|00005030| 67 68 2e 0a 5c 65 6e 64 | 7b 64 65 73 63 72 69 70 |gh..\end|{descrip|
|00005040| 74 69 6f 6e 7d 0a 54 68 | 75 73 2c 20 74 68 65 20 |tion}.Th|us, the |
|00005050| 63 6f 6d 6d 61 6e 64 0a | 5c 62 65 67 69 6e 7b 71 |command.|\begin{q|
|00005060| 75 6f 74 65 7d 20 7c 6e | 75 77 65 62 20 2d 74 6f |uote} |n|uweb -to|
|00005070| 20 2f 66 6f 6f 2f 62 61 | 72 2f 71 75 75 78 7c 20 | /foo/ba|r/quux| |
|00005080| 5c 65 6e 64 7b 71 75 6f | 74 65 7d 0a 77 6f 75 6c |\end{quo|te}.woul|
|00005090| 64 20 73 69 6d 70 6c 79 | 20 73 63 61 6e 20 74 68 |d simply| scan th|
|000050a0| 65 20 69 6e 70 75 74 20 | 61 6e 64 20 70 72 6f 64 |e input |and prod|
|000050b0| 75 63 65 20 6e 6f 20 70 | 72 6f 67 72 61 6d 20 61 |uce no p|rogram a|
|000050c0| 74 20 61 6c 6c 2e 0a 0a | 54 68 65 72 65 20 61 72 |t all...|There ar|
|000050d0| 65 20 74 68 72 65 65 20 | 61 64 64 69 74 69 6f 6e |e three |addition|
|000050e0| 61 6c 20 63 6f 6d 6d 61 | 6e 64 2d 6c 69 6e 65 20 |al comma|nd-line |
|000050f0| 66 6c 61 67 73 3a 0a 5c | 62 65 67 69 6e 7b 64 65 |flags:.\|begin{de|
|00005100| 73 63 72 69 70 74 69 6f | 6e 7d 0a 5c 69 74 65 6d |scriptio|n}.\item|
|00005110| 5b 5c 74 74 20 2d 76 5d | 20 46 6f 72 20 60 60 76 |[\tt -v]| For ``v|
|00005120| 65 72 62 6f 73 65 27 27 | 2c 20 63 61 75 73 65 73 |erbose''|, causes|
|00005130| 20 6e 75 77 65 62 20 74 | 6f 20 77 72 69 74 65 20 | nuweb t|o write |
|00005140| 69 6e 66 6f 72 6d 61 74 | 69 6f 6e 20 61 62 6f 75 |informat|ion abou|
|00005150| 74 0a 20 20 69 74 73 20 | 70 72 6f 67 72 65 73 73 |t. its |progress|
|00005160| 20 74 6f 20 7c 73 74 64 | 65 72 72 7c 2e 0a 5c 69 | to |std|err|..\i|
|00005170| 74 65 6d 5b 5c 74 74 20 | 2d 6e 5d 20 46 6f 72 63 |tem[\tt |-n] Forc|
|00005180| 65 73 20 73 63 72 61 70 | 73 20 74 6f 20 62 65 20 |es scrap|s to be |
|00005190| 6e 75 6d 62 65 72 65 64 | 20 73 65 71 75 65 6e 74 |numbered| sequent|
|000051a0| 69 61 6c 6c 79 20 66 72 | 6f 6d 7e 31 0a 20 20 28 |ially fr|om~1. (|
|000051b0| 69 6e 73 74 65 61 64 20 | 6f 66 20 75 73 69 6e 67 |instead |of using|
|000051c0| 20 70 61 67 65 20 6e 75 | 6d 62 65 72 73 29 2e 20 | page nu|mbers). |
|000051d0| 54 68 69 73 20 66 6f 72 | 6d 20 69 73 20 70 65 72 |This for|m is per|
|000051e0| 68 61 70 73 20 6d 6f 72 | 65 20 64 65 73 69 72 61 |haps mor|e desira|
|000051f0| 62 6c 65 0a 20 20 66 6f | 72 20 73 6d 61 6c 6c 20 |ble. fo|r small |
|00005200| 77 65 62 73 2e 20 54 68 | 69 73 20 6f 70 74 69 6f |webs. Th|is optio|
|00005210| 6e 20 61 70 70 6c 69 65 | 73 20 6f 6e 6c 79 20 77 |n applie|s only w|
|00005220| 68 65 6e 20 73 63 72 61 | 70 73 20 61 72 65 20 67 |hen scra|ps are g|
|00005230| 65 6e 65 72 61 74 65 64 | 20 69 6e 0a 20 20 5c 4c |enerated| in. \L|
|00005240| 61 54 65 58 5c 20 66 6f | 72 6d 61 74 2e 0a 5c 6c |aTeX\ fo|rmat..\l|
|00005250| 61 62 65 6c 7b 73 6b 69 | 70 6f 70 74 69 6f 6e 7d |abel{ski|poption}|
|00005260| 0a 5c 69 74 65 6d 5b 5c | 74 74 20 2d 73 5d 20 4e |.\item[\|tt -s] N|
|00005270| 6f 72 6d 61 6c 6c 79 2c | 20 69 66 20 7c 40 40 7b |ormally,| if |@@{|
|00005280| 7c 20 69 73 20 66 6f 6c | 6c 6f 77 65 64 20 62 79 || is fol|lowed by|
|00005290| 20 61 20 6e 65 77 6c 69 | 6e 65 2c 20 74 68 65 20 | a newli|ne, the |
|000052a0| 6e 65 77 6c 69 6e 65 0a | 20 20 69 73 20 69 67 6e |newline.| is ign|
|000052b0| 6f 72 65 64 20 77 68 65 | 6e 20 66 6f 72 6d 61 74 |ored whe|n format|
|000052c0| 74 69 6e 67 20 74 68 65 | 20 73 63 72 61 70 2c 20 |ting the| scrap, |
|000052d0| 61 6e 64 20 73 69 6d 69 | 6c 61 72 6c 79 20 77 69 |and simi|larly wi|
|000052e0| 74 68 20 61 20 6e 65 77 | 6c 69 6e 65 20 62 65 66 |th a new|line bef|
|000052f0| 6f 72 65 0a 20 20 7c 40 | 40 7d 7c 20 6f 72 20 5c |ore. |@|@}| or \|
|00005300| 76 65 72 62 21 40 40 7c | 21 2e 20 54 68 69 73 20 |verb!@@||!. This |
|00005310| 61 6c 6c 6f 77 73 20 73 | 6f 75 72 63 65 20 63 6f |allows s|ource co|
|00005320| 64 65 20 74 6f 20 73 74 | 61 72 74 20 6f 6e 20 74 |de to st|art on t|
|00005330| 68 65 20 6c 69 6e 65 0a | 20 20 61 66 74 65 72 20 |he line.| after |
|00005340| 7c 40 40 7b 7c 20 61 6e | 64 20 65 6e 64 20 6f 6e ||@@{| an|d end on|
|00005350| 20 74 68 65 20 6c 69 6e | 65 20 62 65 66 6f 72 65 | the lin|e before|
|00005360| 20 7c 40 40 7d 7c 20 6f | 72 20 5c 76 65 72 62 21 | |@@}| o|r \verb!|
|00005370| 40 40 7c 21 2c 20 77 68 | 69 63 68 0a 20 20 69 73 |@@|!, wh|ich. is|
|00005380| 20 63 6f 6e 76 65 6e 69 | 65 6e 74 20 66 6f 72 20 | conveni|ent for |
|00005390| 65 64 69 74 69 6e 67 2c | 20 77 69 74 68 6f 75 74 |editing,| without|
|000053a0| 20 6c 65 61 76 69 6e 67 | 20 62 6c 61 6e 6b 20 6c | leaving| blank l|
|000053b0| 69 6e 65 73 20 69 6e 20 | 74 68 65 20 5c 4c 61 54 |ines in |the \LaT|
|000053c0| 65 58 5c 20 66 69 6c 65 | 2e 0a 20 20 55 73 69 6e |eX\ file|.. Usin|
|000053d0| 67 20 74 68 69 73 20 66 | 6c 61 67 2c 20 74 68 65 |g this f|lag, the|
|000053e0| 20 73 63 72 61 70 73 20 | 61 72 65 20 66 6f 72 6d | scraps |are form|
|000053f0| 61 74 74 65 64 20 76 65 | 72 62 61 74 69 6d 3b 20 |atted ve|rbatim; |
|00005400| 73 63 72 61 70 73 20 61 | 72 65 20 61 6c 77 61 79 |scraps a|re alway|
|00005410| 73 0a 20 20 77 72 69 74 | 74 65 6e 20 6f 75 74 20 |s. writ|ten out |
|00005420| 74 6f 20 70 72 6f 67 72 | 61 6d 20 66 69 6c 65 73 |to progr|am files|
|00005430| 20 76 65 72 62 61 74 69 | 6d 2e 0a 5c 65 6e 64 7b | verbati|m..\end{|
|00005440| 64 65 73 63 72 69 70 74 | 69 6f 6e 7d 0a 49 74 20 |descript|ion}.It |
|00005450| 69 73 20 77 6f 72 74 68 | 20 6e 6f 74 69 6e 67 20 |is worth| noting |
|00005460| 74 68 61 74 20 73 6f 75 | 72 63 65 20 63 6f 64 65 |that sou|rce code|
|00005470| 20 6f 66 74 65 6e 20 63 | 6f 6e 74 61 69 6e 73 20 | often c|ontains |
|00005480| 77 69 64 65 20 6c 69 6e | 65 73 2c 20 73 6f 20 77 |wide lin|es, so w|
|00005490| 68 65 6e 0a 67 65 6e 65 | 72 61 74 69 6e 67 20 5c |hen.gene|rating \|
|000054a0| 4c 61 54 65 58 5c 20 64 | 6f 63 75 6d 65 6e 74 73 |LaTeX\ d|ocuments|
|000054b0| 20 69 74 20 6d 61 79 20 | 68 65 6c 70 20 74 6f 20 | it may |help to |
|000054c0| 75 73 65 20 61 20 70 61 | 63 6b 61 67 65 20 73 75 |use a pa|ckage su|
|000054d0| 63 68 20 61 73 0a 5c 74 | 65 78 74 73 66 7b 61 34 |ch as.\t|extsf{a4|
|000054e0| 77 69 64 65 7d 20 74 6f | 20 61 76 6f 69 64 20 67 |wide} to| avoid g|
|000054f0| 65 74 74 69 6e 67 20 74 | 6f 6f 20 6d 61 6e 79 20 |etting t|oo many |
|00005500| 60 60 5c 74 65 78 74 74 | 74 7b 6f 76 65 72 66 75 |``\textt|t{overfu|
|00005510| 6c 6c 20 68 62 6f 78 7d | 27 27 0a 6d 65 73 73 61 |ll hbox}|''.messa|
|00005520| 67 65 73 2e 0a 0a 0a 0a | 5c 73 65 63 74 69 6f 6e |ges.....|\section|
|00005530| 7b 47 65 6e 65 72 61 74 | 69 6e 67 20 5c 48 54 4d |{Generat|ing \HTM|
|00005540| 4c 7d 0a 0a 4e 69 6b 6f | 73 20 44 72 61 6b 6f 73 |L}..Niko|s Drakos|
|00005550| 27 73 20 7b 5c 4c 61 54 | 65 58 7d 32 5c 48 54 4d |'s {\LaT|eX}2\HTM|
|00005560| 4c 7e 5c 63 69 74 65 7b | 64 72 61 6b 6f 73 3a 39 |L~\cite{|drakos:9|
|00005570| 34 7d 20 63 61 6e 20 62 | 65 20 75 73 65 64 20 74 |4} can b|e used t|
|00005580| 6f 20 74 72 61 6e 73 6c | 61 74 65 0a 5c 4c 61 54 |o transl|ate.\LaT|
|00005590| 65 58 5c 20 77 69 74 68 | 20 65 6d 62 65 64 64 65 |eX\ with| embedde|
|000055a0| 64 20 5c 48 54 4d 4c 5c | 20 73 63 72 61 70 73 20 |d \HTML\| scraps |
|000055b0| 69 6e 74 6f 20 5c 48 54 | 4d 4c 5c 40 40 2e 20 20 |into \HT|ML\@@. |
|000055c0| 42 65 20 73 75 72 65 20 | 74 6f 20 75 73 65 20 74 |Be sure |to use t|
|000055d0| 68 65 20 70 61 63 6b 61 | 67 65 0a 5c 74 65 78 74 |he packa|ge.\text|
|000055e0| 73 66 7b 68 74 6d 6c 7d | 20 73 6f 20 74 68 61 74 |sf{html}| so that|
|000055f0| 20 5c 4c 61 54 65 58 5c | 20 77 69 6c 6c 20 75 6e | \LaTeX\| will un|
|00005600| 64 65 72 73 74 61 6e 64 | 20 74 68 65 20 68 79 70 |derstand| the hyp|
|00005610| 65 72 74 65 78 74 20 63 | 6f 6d 6d 61 6e 64 73 2e |ertext c|ommands.|
|00005620| 20 20 57 68 65 6e 0a 74 | 72 61 6e 73 6c 61 74 69 | When.t|ranslati|
|00005630| 6e 67 20 69 6e 74 6f 20 | 5c 48 54 4d 4c 2c 20 64 |ng into |\HTML, d|
|00005640| 6f 20 6e 6f 74 20 61 6c | 6c 6f 77 20 61 20 64 6f |o not al|low a do|
|00005650| 63 75 6d 65 6e 74 20 74 | 6f 20 62 65 20 73 70 6c |cument t|o be spl|
|00005660| 69 74 20 62 79 20 73 70 | 65 63 69 66 79 69 6e 67 |it by sp|ecifying|
|00005670| 0a 60 60 7c 2d 73 70 6c | 69 74 20 30 7c 27 27 2e |.``|-spl|it 0|''.|
|00005680| 20 59 6f 75 20 6e 65 65 | 64 20 6e 6f 74 20 67 65 | You nee|d not ge|
|00005690| 6e 65 72 61 74 65 20 6e | 61 76 69 67 61 74 69 6f |nerate n|avigatio|
|000056a0| 6e 20 6c 69 6e 6b 73 2c | 20 73 6f 20 61 6c 73 6f |n links,| so also|
|000056b0| 20 73 70 65 63 69 66 79 | 0a 60 60 7c 2d 6e 6f 5f | specify|.``|-no_|
|000056c0| 6e 61 76 69 67 61 74 69 | 6f 6e 7c 27 27 2e 0a 0a |navigati|on|''...|
|000056d0| 57 68 69 6c 65 20 70 72 | 65 70 61 72 69 6e 67 20 |While pr|eparing |
|000056e0| 61 20 77 65 62 2c 20 79 | 6f 75 20 6d 61 79 20 77 |a web, y|ou may w|
|000056f0| 61 6e 74 20 74 6f 20 76 | 69 65 77 20 74 68 65 20 |ant to v|iew the |
|00005700| 70 72 6f 67 72 61 6d 27 | 73 20 73 63 72 61 70 73 |program'|s scraps|
|00005710| 20 77 69 74 68 6f 75 74 | 0a 74 61 6b 69 6e 67 20 | without|.taking |
|00005720| 74 68 65 20 74 69 6d 65 | 20 74 6f 20 72 75 6e 20 |the time| to run |
|00005730| 7b 5c 4c 61 54 65 58 7d | 32 5c 48 54 4d 4c 5c 40 |{\LaTeX}|2\HTML\@|
|00005740| 40 2e 20 20 53 69 6d 70 | 6c 79 20 72 65 6e 61 6d |@. Simp|ly renam|
|00005750| 65 20 74 68 65 20 67 65 | 6e 65 72 61 74 65 64 0a |e the ge|nerated.|
|00005760| 7c 2e 74 65 78 7c 20 66 | 69 6c 65 20 73 6f 20 74 ||.tex| f|ile so t|
|00005770| 68 61 74 20 69 74 73 20 | 66 69 6c 65 20 6e 61 6d |hat its |file nam|
|00005780| 65 20 65 6e 64 73 20 77 | 69 74 68 20 7c 2e 68 74 |e ends w|ith |.ht|
|00005790| 6d 6c 7c 2c 20 61 6e 64 | 20 76 69 65 77 20 74 68 |ml|, and| view th|
|000057a0| 61 74 0a 66 69 6c 65 2e | 20 20 54 68 65 20 64 6f |at.file.| The do|
|000057b0| 63 75 6d 65 6e 74 61 74 | 69 6f 6e 20 73 65 63 74 |cumentat|ion sect|
|000057c0| 69 6f 6e 20 77 69 6c 6c | 20 62 65 20 6a 75 6d 62 |ion will| be jumb|
|000057d0| 6c 65 64 2c 20 62 75 74 | 20 74 68 65 20 73 63 72 |led, but| the scr|
|000057e0| 61 70 73 20 77 69 6c 6c | 20 62 65 0a 63 6c 65 61 |aps will| be.clea|
|000057f0| 72 2e 0a 0a 0a 0a 5c 73 | 65 63 74 69 6f 6e 7b 52 |r.....\s|ection{R|
|00005800| 65 73 74 72 69 63 74 69 | 6f 6e 73 7d 0a 0a 42 65 |estricti|ons}..Be|
|00005810| 63 61 75 73 65 20 6e 75 | 77 65 62 20 69 73 20 69 |cause nu|web is i|
|00005820| 6e 74 65 6e 64 65 64 20 | 74 6f 20 62 65 20 61 20 |ntended |to be a |
|00005830| 73 69 6d 70 6c 65 20 74 | 6f 6f 6c 2c 20 49 27 76 |simple t|ool, I'v|
|00005840| 65 20 65 73 74 61 62 6c | 69 73 68 65 64 20 61 20 |e establ|ished a |
|00005850| 66 65 77 0a 72 65 73 74 | 72 69 63 74 69 6f 6e 73 |few.rest|rictions|
|00005860| 2e 20 4f 76 65 72 20 74 | 69 6d 65 2c 20 73 6f 6d |. Over t|ime, som|
|00005870| 65 20 6f 66 20 74 68 65 | 73 65 20 6d 61 79 20 62 |e of the|se may b|
|00005880| 65 20 65 6c 69 6d 69 6e | 61 74 65 64 3b 20 6f 74 |e elimin|ated; ot|
|00005890| 68 65 72 73 20 73 65 65 | 6d 0a 66 75 6e 64 61 6d |hers see|m.fundam|
|000058a0| 65 6e 74 61 6c 2e 0a 0a | 5c 62 65 67 69 6e 7b 69 |ental...|\begin{i|
|000058b0| 74 65 6d 69 7a 65 7d 0a | 5c 69 74 65 6d 20 46 69 |temize}.|\item Fi|
|000058c0| 6c 65 20 6e 61 6d 65 73 | 20 61 6e 64 20 69 6e 64 |le names| and ind|
|000058d0| 65 78 65 64 20 69 64 65 | 6e 74 69 66 69 65 72 73 |exed ide|ntifiers|
|000058e0| 20 6d 75 73 74 20 6e 6f | 74 20 63 6f 6e 74 61 69 | must no|t contai|
|000058f0| 6e 20 61 6e 79 20 7c 40 | 40 7c 0a 20 20 73 69 67 |n any |@|@|. sig|
|00005900| 6e 73 2e 20 54 68 69 73 | 20 6d 61 79 20 62 65 20 |ns. This| may be |
|00005910| 63 68 61 6e 67 65 64 20 | 69 6e 20 66 75 74 75 72 |changed |in futur|
|00005920| 65 2e 0a 5c 69 74 65 6d | 20 41 6e 79 74 68 69 6e |e..\item| Anythin|
|00005930| 67 20 69 73 20 61 6c 6c | 6f 77 65 64 20 69 6e 20 |g is all|owed in |
|00005940| 74 68 65 20 62 6f 64 79 | 20 6f 66 20 61 20 73 63 |the body| of a sc|
|00005950| 72 61 70 3b 20 68 6f 77 | 65 76 65 72 2c 20 76 65 |rap; how|ever, ve|
|00005960| 72 79 0a 20 20 6c 61 72 | 67 65 20 73 63 72 61 70 |ry. lar|ge scrap|
|00005970| 73 20 28 68 6f 72 69 7a | 6f 6e 74 61 6c 6c 79 20 |s (horiz|ontally |
|00005980| 6f 72 20 76 65 72 74 69 | 63 61 6c 6c 79 29 20 64 |or verti|cally) d|
|00005990| 6f 20 6e 6f 74 20 74 79 | 70 65 73 65 74 20 77 65 |o not ty|peset we|
|000059a0| 6c 6c 2e 0a 5c 69 74 65 | 6d 20 54 65 6d 70 6f 72 |ll..\ite|m Tempor|
|000059b0| 61 72 79 20 66 69 6c 65 | 73 20 28 63 72 65 61 74 |ary file|s (creat|
|000059c0| 65 64 20 66 6f 72 20 63 | 6f 6d 70 61 72 69 73 6f |ed for c|ompariso|
|000059d0| 6e 20 77 69 74 68 20 74 | 68 65 20 65 78 69 73 74 |n with t|he exist|
|000059e0| 69 6e 67 0a 20 20 70 72 | 6f 67 72 61 6d 20 66 69 |ing. pr|ogram fi|
|000059f0| 6c 65 73 29 20 61 72 65 | 20 70 6c 61 63 65 64 20 |les) are| placed |
|00005a00| 69 6e 20 74 68 65 20 63 | 75 72 72 65 6e 74 20 64 |in the c|urrent d|
|00005a10| 69 72 65 63 74 6f 72 79 | 2e 20 53 69 6e 63 65 20 |irectory|. Since |
|00005a20| 74 68 65 79 20 6d 61 79 | 20 62 65 0a 20 20 72 65 |they may| be. re|
|00005a30| 6e 61 6d 65 64 20 74 6f | 20 61 6e 20 70 72 6f 67 |named to| an prog|
|00005a40| 72 61 6d 20 66 69 6c 65 | 20 6e 61 6d 65 2c 20 61 |ram file| name, a|
|00005a50| 6c 6c 20 74 68 65 20 70 | 72 6f 67 72 61 6d 20 66 |ll the p|rogram f|
|00005a60| 69 6c 65 73 20 6d 75 73 | 74 20 62 65 20 6f 6e 20 |iles mus|t be on |
|00005a70| 74 68 65 0a 20 20 73 61 | 6d 65 20 66 69 6c 65 20 |the. sa|me file |
|00005a80| 73 79 73 74 65 6d 20 61 | 73 20 74 68 65 20 63 75 |system a|s the cu|
|00005a90| 72 72 65 6e 74 20 64 69 | 72 65 63 74 6f 72 79 2e |rrent di|rectory.|
|00005aa0| 0a 5c 69 74 65 6d 20 42 | 65 63 61 75 73 65 20 70 |.\item B|ecause p|
|00005ab0| 61 67 65 20 6e 75 6d 62 | 65 72 73 20 63 61 6e 6e |age numb|ers cann|
|00005ac0| 6f 74 20 62 65 20 64 65 | 74 65 72 6d 69 6e 65 64 |ot be de|termined|
|00005ad0| 20 75 6e 74 69 6c 20 74 | 68 65 20 64 6f 63 75 6d | until t|he docum|
|00005ae0| 65 6e 74 20 68 61 73 0a | 20 20 62 65 65 6e 20 74 |ent has.| been t|
|00005af0| 79 70 65 73 65 74 2c 20 | 77 65 20 68 61 76 65 20 |ypeset, |we have |
|00005b00| 74 6f 20 72 65 72 75 6e | 20 6e 75 77 65 62 20 61 |to rerun| nuweb a|
|00005b10| 66 74 65 72 20 5c 4c 61 | 54 65 58 5c 20 74 6f 20 |fter \La|TeX\ to |
|00005b20| 6f 62 74 61 69 6e 20 61 | 20 63 6c 65 61 6e 0a 20 |obtain a| clean. |
|00005b30| 20 76 65 72 73 69 6f 6e | 20 6f 66 20 74 68 65 20 | version| of the |
|00005b40| 64 6f 63 75 6d 65 6e 74 | 20 28 76 65 72 79 20 73 |document| (very s|
|00005b50| 69 6d 69 6c 61 72 20 74 | 6f 20 74 68 65 20 77 61 |imilar t|o the wa|
|00005b60| 79 20 77 65 20 73 6f 6d | 65 74 69 6d 65 73 20 68 |y we som|etimes h|
|00005b70| 61 76 65 0a 20 20 74 6f | 20 72 65 72 75 6e 20 5c |ave. to| rerun \|
|00005b80| 4c 61 54 65 58 5c 20 74 | 6f 20 6f 62 74 61 69 6e |LaTeX\ t|o obtain|
|00005b90| 20 61 6e 20 75 70 2d 74 | 6f 2d 64 61 74 65 20 74 | an up-t|o-date t|
|00005ba0| 61 62 6c 65 20 6f 66 20 | 63 6f 6e 74 65 6e 74 73 |able of |contents|
|00005bb0| 20 61 66 74 65 72 0a 20 | 20 73 69 67 6e 69 66 69 | after. | signifi|
|00005bc0| 63 61 6e 74 20 65 64 69 | 74 73 29 2e 20 20 4e 75 |cant edi|ts). Nu|
|00005bd0| 77 65 62 20 77 69 6c 6c | 20 77 61 72 6e 20 28 69 |web will| warn (i|
|00005be0| 6e 20 6d 6f 73 74 20 63 | 61 73 65 73 29 20 77 68 |n most c|ases) wh|
|00005bf0| 65 6e 20 74 68 69 73 20 | 6e 65 65 64 73 0a 20 20 |en this |needs. |
|00005c00| 74 6f 20 62 65 20 64 6f | 6e 65 3b 20 69 6e 20 74 |to be do|ne; in t|
|00005c10| 68 65 20 72 65 6d 61 69 | 6e 69 6e 67 20 63 61 73 |he remai|ning cas|
|00005c20| 65 73 2c 20 5c 4c 61 54 | 65 58 5c 20 77 69 6c 6c |es, \LaT|eX\ will|
|00005c30| 20 77 61 72 6e 20 74 68 | 61 74 20 6c 61 62 65 6c | warn th|at label|
|00005c40| 73 0a 20 20 6d 61 79 20 | 68 61 76 65 20 63 68 61 |s. may |have cha|
|00005c50| 6e 67 65 64 2e 0a 5c 69 | 74 65 6d 20 54 61 62 73 |nged..\i|tem Tabs|
|00005c60| 20 61 72 65 20 65 78 70 | 61 6e 64 65 64 20 74 6f | are exp|anded to|
|00005c70| 20 65 69 67 68 74 20 73 | 70 61 63 65 73 3b 20 61 | eight s|paces; a|
|00005c80| 20 70 65 72 2d 66 69 6c | 65 20 66 6c 61 67 20 6d | per-fil|e flag m|
|00005c90| 69 67 68 74 20 69 6e 0a | 20 20 66 75 74 75 72 65 |ight in.| future|
|00005ca0| 20 62 65 20 61 64 64 65 | 64 20 74 6f 20 73 70 65 | be adde|d to spe|
|00005cb0| 63 69 66 79 20 68 6f 77 | 20 6d 61 6e 79 20 73 70 |cify how| many sp|
|00005cc0| 61 63 65 73 20 73 68 6f | 75 6c 64 20 72 65 70 6c |aces sho|uld repl|
|00005cd0| 61 63 65 20 61 20 74 61 | 62 2e 0a 5c 69 74 65 6d |ace a ta|b..\item|
|00005ce0| 20 4e 75 77 65 62 20 69 | 73 20 73 74 69 6c 6c 20 | Nuweb i|s still |
|00005cf0| 6e 6f 74 20 63 6f 6d 70 | 6c 65 74 65 6c 79 20 70 |not comp|letely p|
|00005d00| 6f 72 74 61 62 6c 65 3a | 20 69 74 20 65 78 70 65 |ortable:| it expe|
|00005d10| 63 74 73 20 66 69 6c 65 | 2d 6e 61 6d 65 73 20 74 |cts file|-names t|
|00005d20| 6f 20 75 73 65 0a 20 20 | 7c 2f 7c 20 74 6f 20 64 |o use. ||/| to d|
|00005d30| 65 6c 69 6d 69 74 20 64 | 69 72 65 63 74 6f 72 69 |elimit d|irectori|
|00005d40| 65 73 2e 0a 5c 65 6e 64 | 7b 69 74 65 6d 69 7a 65 |es..\end|{itemize|
|00005d50| 7d 0a 0a 0a 0a 5c 73 65 | 63 74 69 6f 6e 7b 41 63 |}....\se|ction{Ac|
|00005d60| 6b 6e 6f 77 6c 65 64 67 | 65 6d 65 6e 74 73 7d 0a |knowledg|ements}.|
|00005d70| 0a 53 65 76 65 72 61 6c | 20 70 65 6f 70 6c 65 20 |.Several| people |
|00005d80| 68 61 76 65 20 63 6f 6e | 74 72 69 62 75 74 65 64 |have con|tributed|
|00005d90| 20 74 68 65 69 72 20 74 | 69 6d 65 73 2c 20 69 64 | their t|imes, id|
|00005da0| 65 61 73 2c 20 61 6e 64 | 20 64 65 62 75 67 67 69 |eas, and| debuggi|
|00005db0| 6e 67 20 73 6b 69 6c 6c | 73 2e 20 49 6e 0a 70 61 |ng skill|s. In.pa|
|00005dc0| 72 74 69 63 75 6c 61 72 | 2c 20 49 27 64 20 6c 69 |rticular|, I'd li|
|00005dd0| 6b 65 20 74 6f 20 61 63 | 6b 6e 6f 77 6c 65 64 67 |ke to ac|knowledg|
|00005de0| 65 20 74 68 65 20 63 6f | 6e 74 72 69 62 75 74 69 |e the co|ntributi|
|00005df0| 6f 6e 73 20 6f 66 20 4f | 73 6d 61 6e 20 42 75 79 |ons of O|sman Buy|
|00005e00| 75 6b 69 73 69 6b 2c 0a | 4d 61 6e 75 65 6c 20 43 |ukisik,.|Manuel C|
|00005e10| 61 72 72 69 62 61 2c 20 | 41 64 72 69 61 6e 20 43 |arriba, |Adrian C|
|00005e20| 6c 61 72 6b 65 2c 20 54 | 69 6d 20 48 61 72 76 65 |larke, T|im Harve|
|00005e30| 79 2c 20 4d 69 63 68 61 | 65 6c 20 4c 65 77 69 73 |y, Micha|el Lewis|
|00005e40| 2c 20 57 61 6c 74 65 72 | 20 52 61 76 65 6e 65 6b |, Walter| Ravenek|
|00005e50| 2c 20 52 6f 62 0a 53 68 | 69 6c 6c 69 6e 67 73 62 |, Rob.Sh|illingsb|
|00005e60| 75 72 67 2c 20 4b 61 79 | 76 61 6e 20 53 79 6c 76 |urg, Kay|van Sylv|
|00005e70| 61 6e 2c 20 44 6f 6d 69 | 6e 69 71 75 65 20 64 65 |an, Domi|nique de|
|00005e80| 7e 57 61 6c 65 66 66 65 | 2c 20 61 6e 64 20 53 63 |~Waleffe|, and Sc|
|00005e90| 6f 74 74 20 57 61 72 72 | 65 6e 2e 20 20 4f 66 0a |ott Warr|en. Of.|
|00005ea0| 63 6f 75 72 73 65 2c 20 | 6d 6f 73 74 20 6f 66 20 |course, |most of |
|00005eb0| 74 68 65 73 65 20 70 65 | 6f 70 6c 65 20 77 6f 75 |these pe|ople wou|
|00005ec0| 6c 64 20 6e 65 76 65 72 | 20 68 61 76 65 20 68 65 |ld never| have he|
|00005ed0| 61 72 64 20 6f 66 20 6e | 75 77 65 62 20 28 6f 72 |ard of n|uweb (or|
|00005ee0| 20 6d 61 6e 79 20 6f 74 | 68 65 72 0a 74 6f 6f 6c | many ot|her.tool|
|00005ef0| 73 29 20 77 69 74 68 6f | 75 74 20 74 68 65 20 65 |s) witho|ut the e|
|00005f00| 66 66 6f 72 74 73 20 6f | 66 20 47 65 6f 72 67 65 |fforts o|f George|
|00005f10| 20 47 72 65 65 6e 77 61 | 64 65 2e 20 5c 5c 5b 30 | Greenwa|de. \\[0|
|00005f20| 2e 33 65 78 5d 0a 5c 68 | 73 70 61 63 65 2a 7b 5c |.3ex].\h|space*{\|
|00005f30| 66 69 6c 6c 7d 5c 74 65 | 78 74 62 66 7b 50 72 65 |fill}\te|xtbf{Pre|
|00005f40| 73 74 6f 6e 20 42 72 69 | 67 67 73 7d 0a 0a 5c 76 |ston Bri|ggs}..\v|
|00005f50| 73 70 61 63 65 7b 30 2e | 35 63 6d 7d 0a 0a 5c 6e |space{0.|5cm}..\n|
|00005f60| 6f 69 6e 64 65 6e 74 20 | 50 72 65 73 74 6f 6e 20 |oindent |Preston |
|00005f70| 42 72 69 67 67 73 20 61 | 6e 64 20 4a 6f 68 6e 20 |Briggs a|nd John |
|00005f80| 52 61 6d 73 64 65 6c 6c | 20 65 6e 63 6f 75 72 61 |Ramsdell| encoura|
|00005f90| 67 65 64 20 61 6e 64 20 | 61 64 76 69 73 65 64 20 |ged and |advised |
|00005fa0| 6d 65 20 77 68 65 6e 20 | 49 0a 73 75 67 67 65 73 |me when |I.sugges|
|00005fb0| 74 65 64 20 6d 79 20 72 | 65 76 69 73 69 6f 6e 73 |ted my r|evisions|
|00005fc0| 2c 20 61 6e 64 20 6b 69 | 6e 64 6c 79 20 70 65 72 |, and ki|ndly per|
|00005fd0| 6d 69 74 74 65 64 20 6d | 65 20 74 6f 20 64 69 73 |mitted m|e to dis|
|00005fe0| 74 72 69 62 75 74 65 20 | 74 68 65 20 72 65 73 75 |tribute |the resu|
|00005ff0| 6c 74 2e 0a 5c 5c 5b 30 | 2e 33 65 78 5d 20 5c 68 |lt..\\[0|.3ex] \h|
|00006000| 73 70 61 63 65 2a 7b 5c | 66 69 6c 6c 7d 5c 74 65 |space*{\|fill}\te|
|00006010| 78 74 62 66 7b 52 65 75 | 62 65 6e 20 54 68 6f 6d |xtbf{Reu|ben Thom|
|00006020| 61 73 7d 0a 0a 0a 0a 5c | 62 65 67 69 6e 7b 63 6f |as}....\|begin{co|
|00006030| 64 65 7d 0a 5c 63 68 61 | 70 74 65 72 7b 54 68 65 |de}.\cha|pter{The|
|00006040| 20 4d 61 69 6e 20 50 72 | 6f 67 72 61 6d 7d 0a 0a | Main Pr|ogram}..|
|00006050| 50 72 6f 63 65 73 73 69 | 6e 67 20 61 20 77 65 62 |Processi|ng a web|
|00006060| 20 72 65 71 75 69 72 65 | 73 20 74 68 72 65 65 20 | require|s three |
|00006070| 6d 61 6a 6f 72 20 73 74 | 65 70 73 3a 0a 0a 5c 62 |major st|eps:..\b|
|00006080| 65 67 69 6e 7b 65 6e 75 | 6d 65 72 61 74 65 7d 0a |egin{enu|merate}.|
|00006090| 5c 69 74 65 6d 20 52 65 | 61 64 20 74 68 65 20 73 |\item Re|ad the s|
|000060a0| 6f 75 72 63 65 2c 20 61 | 63 63 75 6d 75 6c 61 74 |ource, a|ccumulat|
|000060b0| 69 6e 67 20 66 69 6c 65 | 20 6e 61 6d 65 73 2c 20 |ing file| names, |
|000060c0| 6d 61 63 72 6f 20 6e 61 | 6d 65 73 2c 20 73 63 72 |macro na|mes, scr|
|000060d0| 61 70 73 2c 0a 61 6e 64 | 20 6c 69 73 74 73 20 6f |aps,.and| lists o|
|000060e0| 66 20 63 72 6f 73 73 2d | 72 65 66 65 72 65 6e 63 |f cross-|referenc|
|000060f0| 65 73 2e 0a 5c 69 74 65 | 6d 20 52 65 2d 72 65 61 |es..\ite|m Re-rea|
|00006100| 64 20 74 68 65 20 73 6f | 75 72 63 65 2c 20 63 6f |d the so|urce, co|
|00006110| 70 79 69 6e 67 20 6f 75 | 74 20 74 6f 20 74 68 65 |pying ou|t to the|
|00006120| 20 64 6f 63 75 6d 65 6e | 74 61 74 69 6f 6e 20 66 | documen|tation f|
|00006130| 69 6c 65 2c 20 66 6f 72 | 6d 61 74 74 69 6e 67 0a |ile, for|matting.|
|00006140| 61 6e 64 20 63 72 6f 73 | 73 2d 72 65 66 65 72 65 |and cros|s-refere|
|00006150| 6e 63 69 6e 67 20 74 68 | 65 20 73 63 72 61 70 73 |ncing th|e scraps|
|00006160| 2e 0a 5c 69 74 65 6d 20 | 54 72 61 76 65 72 73 65 |..\item |Traverse|
|00006170| 20 74 68 65 20 6c 69 73 | 74 20 6f 66 20 66 69 6c | the lis|t of fil|
|00006180| 65 73 20 6e 61 6d 65 73 | 2e 20 46 6f 72 20 65 61 |es names|. For ea|
|00006190| 63 68 20 66 69 6c 65 20 | 6e 61 6d 65 3a 0a 20 20 |ch file |name:. |
|000061a0| 20 20 5c 62 65 67 69 6e | 7b 65 6e 75 6d 65 72 61 | \begin|{enumera|
|000061b0| 74 65 7d 0a 20 20 20 20 | 5c 69 74 65 6d 20 44 75 |te}. |\item Du|
|000061c0| 6d 70 20 61 6c 6c 20 74 | 68 65 20 64 65 66 69 6e |mp all t|he defin|
|000061d0| 69 6e 67 20 73 63 72 61 | 70 73 20 69 6e 74 6f 20 |ing scra|ps into |
|000061e0| 61 20 74 65 6d 70 6f 72 | 61 72 79 20 66 69 6c 65 |a tempor|ary file|
|000061f0| 2e 0a 20 20 20 20 5c 69 | 74 65 6d 20 49 66 20 74 |.. \i|tem If t|
|00006200| 68 65 20 66 69 6c 65 20 | 61 6c 72 65 61 64 79 20 |he file |already |
|00006210| 65 78 69 73 74 73 20 61 | 6e 64 20 69 73 20 75 6e |exists a|nd is un|
|00006220| 63 68 61 6e 67 65 64 2c | 20 64 65 6c 65 74 65 20 |changed,| delete |
|00006230| 74 68 65 0a 20 20 20 20 | 74 65 6d 70 6f 72 61 72 |the. |temporar|
|00006240| 79 20 66 69 6c 65 3b 20 | 6f 74 68 65 72 77 69 73 |y file; |otherwis|
|00006250| 65 2c 20 72 65 6e 61 6d | 65 20 74 68 65 20 74 65 |e, renam|e the te|
|00006260| 6d 70 6f 72 61 72 79 20 | 66 69 6c 65 2e 0a 20 20 |mporary |file.. |
|00006270| 20 20 5c 65 6e 64 7b 65 | 6e 75 6d 65 72 61 74 65 | \end{e|numerate|
|00006280| 7d 0a 5c 65 6e 64 7b 65 | 6e 75 6d 65 72 61 74 65 |}.\end{e|numerate|
|00006290| 7d 0a 0a 0a 0a 5c 73 65 | 63 74 69 6f 6e 7b 46 69 |}....\se|ction{Fi|
|000062a0| 6c 65 73 7d 0a 0a 49 20 | 68 61 76 65 20 64 69 76 |les}..I |have div|
|000062b0| 69 64 65 64 20 74 68 65 | 20 70 72 6f 67 72 61 6d |ided the| program|
|000062c0| 20 69 6e 74 6f 20 73 65 | 76 65 72 61 6c 20 66 69 | into se|veral fi|
|000062d0| 6c 65 73 20 66 6f 72 20 | 71 75 69 63 6b 65 72 0a |les for |quicker.|
|000062e0| 72 65 63 6f 6d 70 69 6c | 61 74 69 6f 6e 20 64 75 |recompil|ation du|
|000062f0| 72 69 6e 67 20 64 65 76 | 65 6c 6f 70 6d 65 6e 74 |ring dev|elopment|
|00006300| 2e 0a 0a 54 68 65 20 64 | 75 6d 6d 79 20 66 69 6c |...The d|ummy fil|
|00006310| 65 20 7c 64 75 6d 6d 79 | 7c 20 69 73 20 75 73 65 |e |dummy|| is use|
|00006320| 64 20 74 6f 20 6d 61 6b | 65 20 74 68 65 20 6d 61 |d to mak|e the ma|
|00006330| 6b 65 66 69 6c 65 20 77 | 6f 72 6b 20 28 73 65 65 |kefile w|ork (see|
|00006340| 0a 73 65 63 74 69 6f 6e | 7e 5c 72 65 66 7b 64 75 |.section|~\ref{du|
|00006350| 6d 6d 79 7d 29 2e 0a 0a | 40 6f 20 64 75 6d 6d 79 |mmy})...|@o dummy|
|00006360| 0a 40 7b 40 7d 0a 0a 40 | 6f 20 67 6c 6f 62 61 6c |.@{@}..@|o global|
|00006370| 2e 68 20 2d 64 0a 40 7b | 0a 40 3c 49 6e 63 6c 75 |.h -d.@{|.@<Inclu|
|00006380| 64 65 20 66 69 6c 65 73 | 40 3e 0a 40 3c 54 79 70 |de files|@>.@<Typ|
|00006390| 65 20 64 65 63 6c 61 72 | 61 74 69 6f 6e 73 40 3e |e declar|ations@>|
|000063a0| 0a 40 3c 47 6c 6f 62 61 | 6c 20 76 61 72 69 61 62 |.@<Globa|l variab|
|000063b0| 6c 65 20 64 65 63 6c 61 | 72 61 74 69 6f 6e 73 40 |le decla|rations@|
|000063c0| 3e 0a 40 3c 46 75 6e 63 | 74 69 6f 6e 20 70 72 6f |>.@<Func|tion pro|
|000063d0| 74 6f 74 79 70 65 73 40 | 3e 0a 40 7d 0a 0a 57 65 |totypes@|>.@}..We|
|000063e0| 27 6c 6c 20 6e 65 65 64 | 20 73 6f 6d 65 20 6f 66 |'ll need| some of|
|000063f0| 20 74 68 65 20 73 74 61 | 6e 64 61 72 64 20 73 79 | the sta|ndard sy|
+--------+-------------------------+-------------------------+--------+--------+
Only 25.0 KB of data is shown above.
