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
| Corel 10 Texture (image/corel10Texture)
| ext
| Unsupported |
| 1%
| dexvert
| Croteam texture file (image/croteamTextureFile)
| ext
| Unsupported |
| 1%
| dexvert
| Text File (text/txt)
| fallback
| Supported |
| 100%
| file
| LaTeX document text
| default
| |
| 99%
| file
| LaTeX document, ASCII text, with CRLF line terminators
| default
| |
| 100%
| checkBytes
| Printable ASCII
| default
| |
| 100%
| perlTextCheck
| Likely Text (Perl)
| default
| |
| 100%
| siegfried
| fmt/281 LaTeX (Subdocument)
| default
| |
| 100%
| detectItEasy
| Format: plain text[CRLF]
| default (weak)
| |
| 100%
| xdgMime
| text/x-matlab
| default (weak)
|
|
hex view+--------+-------------------------+-------------------------+--------+--------+
|00000000| 25 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |%=======|========|
|00000010| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00000020| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00000030| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00000040| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 25 |========|=======%|
|00000050| 0d 0a 25 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |..% | |
|00000060| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00000070| 20 53 74 61 72 74 20 6f | 66 20 43 68 31 2e 74 65 | Start o|f Ch1.te|
|00000080| 78 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |x | |
|00000090| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|000000a0| 20 25 0d 0a 25 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d | %..%===|========|
|000000b0| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|000000c0| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|000000d0| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|000000e0| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|000000f0| 3d 3d 3d 25 0d 0a 25 0d | 0a 25 20 43 6f 70 79 72 |===%..%.|.% Copyr|
|00000100| 69 67 68 74 0d 0a 25 20 | 2d 2d 2d 2d 2d 2d 2d 2d |ight..% |--------|
|00000110| 2d 0d 0a 25 20 43 6f 70 | 79 72 69 67 68 74 20 28 |-..% Cop|yright (|
|00000120| 43 29 20 31 39 39 32 20 | 52 6f 73 73 20 4e 2e 20 |C) 1992 |Ross N. |
|00000130| 57 69 6c 6c 69 61 6d 73 | 2e 0d 0a 25 20 54 68 69 |Williams|...% Thi|
|00000140| 73 20 66 69 6c 65 20 63 | 6f 6e 74 61 69 6e 73 20 |s file c|ontains |
|00000150| 61 20 63 68 61 70 74 65 | 72 20 6f 66 20 74 68 65 |a chapte|r of the|
|00000160| 20 46 75 6e 6e 65 6c 57 | 65 62 20 48 61 63 6b 65 | FunnelW|eb Hacke|
|00000170| 72 27 73 20 4d 61 6e 75 | 61 6c 2e 0d 0a 25 20 53 |r's Manu|al...% S|
|00000180| 65 65 20 74 68 65 20 6d | 61 69 6e 20 54 65 58 20 |ee the m|ain TeX |
|00000190| 66 69 6c 65 20 66 6f 72 | 20 74 68 69 73 20 6d 61 |file for| this ma|
|000001a0| 6e 75 61 6c 20 66 6f 72 | 20 66 75 72 74 68 65 72 |nual for| further|
|000001b0| 20 69 6e 66 6f 72 6d 61 | 74 69 6f 6e 2e 0d 0a 25 | informa|tion...%|
|000001c0| 0d 0a 25 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |..%=====|========|
|000001d0| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|000001e0| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|000001f0| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00000200| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00000210| 3d 25 0d 0a 0d 0a 5c 63 | 68 61 70 74 65 72 7b 46 |=%....\c|hapter{F|
|00000220| 75 6e 6e 65 6c 57 65 62 | 20 44 65 73 69 67 6e 7d |unnelWeb| Design}|
|00000230| 0d 0a 5c 6c 61 62 65 6c | 7b 63 68 61 70 64 65 73 |..\label|{chapdes|
|00000240| 69 67 6e 7d 5c 78 78 7b | 46 75 6e 6e 65 6c 57 65 |ign}\xx{|FunnelWe|
|00000250| 62 7d 7b 64 65 73 69 67 | 6e 7d 0d 0a 0d 0a 54 68 |b}{desig|n}....Th|
|00000260| 69 73 20 63 68 61 70 74 | 65 72 20 63 6f 6e 74 61 |is chapt|er conta|
|00000270| 69 6e 73 20 6e 6f 74 65 | 73 20 6f 6e 20 74 68 65 |ins note|s on the|
|00000280| 20 64 65 73 69 67 6e 20 | 6f 66 20 46 75 6e 6e 65 | design |of Funne|
|00000290| 6c 57 65 62 2e 20 54 68 | 65 73 65 20 6e 6f 74 65 |lWeb. Th|ese note|
|000002a0| 73 20 77 65 72 65 0d 0a | 6e 6f 74 20 63 72 65 61 |s were..|not crea|
|000002b0| 74 65 64 20 5c 64 71 7b | 66 72 6f 6d 20 73 63 72 |ted \dq{|from scr|
|000002c0| 61 74 63 68 7d 2c 20 61 | 73 20 74 68 65 20 6f 72 |atch}, a|s the or|
|000002d0| 69 67 69 6e 61 6c 0d 0a | 76 65 72 73 69 6f 6e 20 |iginal..|version |
|000002e0| 6f 66 20 46 75 6e 6e 65 | 6c 57 65 62 20 28 5c 6e |of Funne|lWeb (\n|
|000002f0| 65 77 74 65 72 6d 7b 46 | 75 6e 6e 65 6c 57 65 62 |ewterm{F|unnelWeb|
|00000300| 20 56 31 7d 29 20 77 61 | 73 20 64 65 73 69 67 6e | V1}) wa|s design|
|00000310| 65 64 0d 0a 61 6e 64 20 | 63 6f 6e 73 74 72 75 63 |ed..and |construc|
|00000320| 74 65 64 20 69 6e 20 61 | 20 68 75 72 72 79 20 6c |ted in a| hurry l|
|00000330| 61 74 65 20 69 6e 20 31 | 39 38 36 2c 20 61 6e 64 |ate in 1|986, and|
|00000340| 20 6e 6f 20 64 65 73 69 | 67 6e 20 6e 6f 74 65 73 | no desi|gn notes|
|00000350| 20 77 65 72 65 20 65 76 | 65 72 0d 0a 72 65 63 6f | were ev|er..reco|
|00000360| 72 64 65 64 2e 0d 0a 54 | 68 65 73 65 20 6e 6f 74 |rded...T|hese not|
|00000370| 65 73 20 61 72 65 20 69 | 6e 20 66 61 63 74 20 74 |es are i|n fact t|
|00000380| 68 65 20 72 65 73 75 6c | 74 20 6f 66 20 61 20 63 |he resul|t of a c|
|00000390| 6f 6d 70 6c 65 74 65 20 | 72 65 76 69 65 77 20 6f |omplete |review o|
|000003a0| 66 20 74 68 65 0d 0a 46 | 75 6e 6e 65 6c 57 65 62 |f the..F|unnelWeb|
|000003b0| 20 64 65 73 69 67 6e 20 | 74 68 61 74 20 74 6f 6f | design |that too|
|000003c0| 6b 20 70 6c 61 63 65 20 | 69 6e 20 6c 61 74 65 20 |k place |in late |
|000003d0| 31 39 39 31 20 61 73 20 | 70 61 72 74 0d 0a 6f 66 |1991 as |part..of|
|000003e0| 20 74 68 65 20 70 72 6f | 63 65 73 73 20 6f 66 20 | the pro|cess of |
|000003f0| 75 70 67 72 61 64 69 6e | 67 20 69 74 20 66 6f 72 |upgradin|g it for|
|00000400| 20 70 75 62 6c 69 63 20 | 72 65 6c 65 61 73 65 2e | public |release.|
|00000410| 0d 0a 0d 0a 54 68 72 6f | 75 67 68 6f 75 74 20 74 |....Thro|ughout t|
|00000420| 68 65 20 64 65 73 69 67 | 6e 20 70 72 6f 63 65 73 |he desig|n proces|
|00000430| 73 20 49 20 74 72 69 65 | 64 20 74 6f 20 73 74 69 |s I trie|d to sti|
|00000440| 63 6b 20 74 6f 20 74 68 | 65 20 70 72 69 6e 63 69 |ck to th|e princi|
|00000450| 70 6c 65 73 20 6f 66 0d | 0a 73 69 6d 70 6c 69 63 |ples of.|.simplic|
|00000460| 69 74 79 20 61 6e 64 20 | 63 6c 61 72 69 74 79 2e |ity and |clarity.|
|00000470| 20 41 73 20 61 20 72 75 | 6c 65 2c 20 69 74 20 77 | As a ru|le, it w|
|00000480| 61 73 20 63 6f 6e 73 69 | 64 65 72 65 64 20 6d 6f |as consi|dered mo|
|00000490| 72 65 20 69 6d 70 6f 72 | 74 61 6e 74 0d 0a 74 68 |re impor|tant..th|
|000004a0| 61 74 20 61 20 66 65 61 | 74 75 72 65 20 62 65 20 |at a fea|ture be |
|000004b0| 73 69 6d 70 6c 65 20 61 | 6e 64 20 6e 6f 74 20 61 |simple a|nd not a|
|000004c0| 6c 6c 6f 77 20 74 68 65 | 20 75 73 65 72 20 74 6f |llow the| user to|
|000004d0| 20 6f 75 74 73 6d 61 72 | 74 20 68 69 6d 73 65 6c | outsmar|t himsel|
|000004e0| 66 20 74 68 61 6e 20 69 | 74 0d 0a 77 61 73 20 66 |f than i|t..was f|
|000004f0| 6f 72 20 74 68 65 20 66 | 65 61 74 75 72 65 20 74 |or the f|eature t|
|00000500| 6f 20 62 65 20 70 61 72 | 74 69 63 75 6c 61 72 6c |o be par|ticularl|
|00000510| 79 20 63 72 69 73 70 2e | 20 46 6f 72 20 65 78 61 |y crisp.| For exa|
|00000520| 6d 70 6c 65 2c 20 74 68 | 65 20 46 75 6e 6e 65 6c |mple, th|e Funnel|
|00000530| 57 65 62 0d 0a 6d 61 63 | 72 6f 20 63 61 6c 6c 69 |Web..mac|ro calli|
|00000540| 6e 67 20 73 79 6e 74 61 | 78 20 69 73 20 6e 6f 74 |ng synta|x is not|
|00000550| 20 61 73 20 63 72 69 73 | 70 20 61 73 20 74 68 65 | as cris|p as the|
|00000560| 20 43 20 73 79 6e 74 61 | 78 2c 20 62 75 74 20 69 | C synta|x, but i|
|00000570| 73 0d 0a 6d 6f 72 65 20 | 76 69 73 69 62 6c 65 2e |s..more |visible.|
|00000580| 0d 0a 0d 0a 54 6f 20 73 | 6f 6d 65 20 65 78 74 65 |....To s|ome exte|
|00000590| 6e 74 20 74 68 65 20 64 | 65 73 69 67 6e 20 72 65 |nt the d|esign re|
|000005a0| 76 69 65 77 20 77 61 73 | 20 69 6e 66 6c 75 65 6e |view was| influen|
|000005b0| 63 65 64 20 62 79 20 74 | 68 65 20 72 65 71 75 69 |ced by t|he requi|
|000005c0| 72 65 6d 65 6e 74 73 20 | 6f 66 0d 0a 62 61 63 6b |rements |of..back|
|000005d0| 77 61 72 64 20 63 6f 6d | 70 61 74 69 62 69 6c 69 |ward com|patibili|
|000005e0| 74 79 2e 5c 78 78 7b 62 | 61 63 6b 77 61 72 64 73 |ty.\xx{b|ackwards|
|000005f0| 7d 7b 63 6f 6d 70 61 74 | 69 62 69 6c 69 74 79 7d |}{compat|ibility}|
|00000600| 0d 0a 44 75 72 69 6e 67 | 20 74 68 65 20 72 65 76 |..During| the rev|
|00000610| 69 65 77 20 69 74 20 77 | 61 73 20 68 61 72 64 20 |iew it w|as hard |
|00000620| 6e 6f 74 20 74 6f 20 74 | 68 69 6e 6b 20 61 62 6f |not to t|hink abo|
|00000630| 75 74 0d 0a 61 6c 6c 20 | 74 68 65 20 73 6f 75 72 |ut..all |the sour|
|00000640| 63 65 20 66 69 6c 65 73 | 20 69 6e 20 46 75 6e 6e |ce files| in Funn|
|00000650| 65 6c 57 65 62 7e 56 31 | 20 66 6f 72 6d 61 74 20 |elWeb~V1| format |
|00000660| 74 68 61 74 20 49 20 68 | 61 76 65 20 77 72 69 74 |that I h|ave writ|
|00000670| 74 65 6e 20 6f 76 65 72 | 20 74 68 65 0d 0a 79 65 |ten over| the..ye|
|00000680| 61 72 73 20 74 68 61 74 | 20 77 6f 75 6c 64 20 68 |ars that| would h|
|00000690| 61 76 65 20 74 6f 20 62 | 65 0d 0a 63 6f 6e 76 65 |ave to b|e..conve|
|000006a0| 72 74 65 64 20 77 65 72 | 65 20 49 20 74 6f 20 73 |rted wer|e I to s|
|000006b0| 69 67 6e 69 66 69 63 61 | 6e 74 6c 79 20 64 65 76 |ignifica|ntly dev|
|000006c0| 69 61 74 65 20 66 72 6f | 6d 20 74 68 65 20 6f 6c |iate fro|m the ol|
|000006d0| 64 20 69 6e 70 75 74 20 | 6c 61 6e 67 75 61 67 65 |d input |language|
|000006e0| 2e 0d 0a 4c 75 63 6b 69 | 6c 79 20 69 74 20 74 75 |...Lucki|ly it tu|
|000006f0| 72 6e 65 64 20 6f 75 74 | 20 74 68 61 74 20 74 68 |rned out| that th|
|00000700| 65 72 65 20 77 61 73 20 | 6c 69 74 74 6c 65 20 63 |ere was |little c|
|00000710| 6c 61 73 68 20 62 65 74 | 77 65 65 6e 20 74 68 65 |lash bet|ween the|
|00000720| 73 65 0d 0a 69 6e 74 65 | 72 65 73 74 73 2c 20 61 |se..inte|rests, a|
|00000730| 6e 64 20 74 68 65 20 72 | 65 73 75 6c 74 69 6e 67 |nd the r|esulting|
|00000740| 20 64 65 73 69 67 6e 20 | 69 73 20 62 6f 74 68 20 | design |is both |
|00000750| 63 6c 65 61 6e 20 61 6e | 64 20 64 6f 65 73 20 6e |clean an|d does n|
|00000760| 6f 74 20 72 65 71 75 69 | 72 65 0d 0a 6d 75 63 68 |ot requi|re..much|
|00000770| 20 63 6f 6e 76 65 72 73 | 69 6f 6e 20 6f 66 20 6f | convers|ion of o|
|00000780| 6c 64 20 73 6f 75 72 63 | 65 20 66 69 6c 65 73 2e |ld sourc|e files.|
|00000790| 0d 0a 54 68 65 20 6d 61 | 69 6e 20 72 65 76 69 73 |..The ma|in revis|
|000007a0| 69 6f 6e 20 69 73 20 69 | 6e 20 74 68 65 20 64 6f |ion is i|n the do|
|000007b0| 63 75 6d 65 6e 74 20 73 | 74 72 75 63 74 75 72 69 |cument s|tructuri|
|000007c0| 6e 67 20 66 61 63 69 6c | 69 74 79 2e 0d 0a 46 75 |ng facil|ity...Fu|
|000007d0| 6e 6e 65 6c 57 65 62 7e | 56 31 20 68 61 64 20 6a |nnelWeb~|V1 had j|
|000007e0| 75 73 74 20 74 77 6f 20 | 6c 65 76 65 6c 73 20 6f |ust two |levels o|
|000007f0| 66 20 68 65 61 64 69 6e | 67 20 69 6e 64 69 63 61 |f headin|g indica|
|00000800| 74 65 64 20 62 79 20 5c | 70 7b 40 2a 40 2a 7d 0d |ted by \|p{@*@*}.|
|00000810| 0a 28 66 6f 72 20 6d 61 | 6a 6f 72 20 68 65 61 64 |.(for ma|jor head|
|00000820| 69 6e 67 73 29 20 61 6e | 64 0d 0a 5c 70 7b 40 2a |ings) an|d..\p{@*|
|00000830| 7d 20 28 66 6f 72 20 6d | 69 6e 6f 72 20 68 65 61 |} (for m|inor hea|
|00000840| 64 69 6e 67 73 29 2e 20 | 54 68 69 73 20 73 63 68 |dings). |This sch|
|00000850| 65 6d 65 20 28 77 68 69 | 63 68 20 77 61 73 20 63 |eme (whi|ch was c|
|00000860| 6f 70 69 65 64 20 66 72 | 6f 6d 20 4b 6e 75 74 68 |opied fr|om Knuth|
|00000870| 27 73 0d 0a 57 65 62 29 | 20 68 61 73 20 62 65 65 |'s..Web)| has bee|
|00000880| 6e 20 72 65 70 6c 61 63 | 65 64 20 62 79 20 61 20 |n replac|ed by a |
|00000890| 68 69 65 72 61 72 63 68 | 69 63 61 6c 20 73 63 68 |hierarch|ical sch|
|000008a0| 65 6d 65 20 6f 66 20 66 | 69 76 65 20 68 65 61 64 |eme of f|ive head|
|000008b0| 69 6e 67 20 6c 65 76 65 | 6c 73 0d 0a 6c 65 76 65 |ing leve|ls..leve|
|000008c0| 6c 73 20 28 5c 70 7b 40 | 41 7d 24 5c 6c 64 6f 74 |ls (\p{@|A}$\ldot|
|000008d0| 73 24 5c 70 7b 40 45 7d | 29 2e 0d 0a 0d 0a 54 68 |s$\p{@E}|).....Th|
|000008e0| 69 73 20 63 68 61 70 74 | 65 72 20 69 73 20 72 61 |is chapt|er is ra|
|000008f0| 74 68 65 72 20 75 6e 73 | 74 72 75 63 74 75 72 65 |ther uns|tructure|
|00000900| 64 2c 20 61 63 74 69 6e | 67 20 61 73 20 69 74 20 |d, actin|g as it |
|00000910| 68 61 73 2c 20 6d 61 69 | 6e 6c 79 20 61 73 20 61 |has, mai|nly as a|
|00000920| 0d 0a 64 75 6d 70 69 6e | 67 20 67 72 6f 75 6e 64 |..dumpin|g ground|
|00000930| 20 66 6f 72 20 72 61 6e | 64 6f 6d 20 69 64 65 61 | for ran|dom idea|
|00000940| 73 20 61 62 6f 75 74 20 | 46 75 6e 6e 65 6c 57 65 |s about |FunnelWe|
|00000950| 62 2e 0d 0a 0d 0a 5c 73 | 65 63 74 69 6f 6e 7b 4d |b.....\s|ection{M|
|00000960| 6f 74 69 76 61 74 69 6f | 6e 20 66 6f 72 20 46 75 |otivatio|n for Fu|
|00000970| 6e 6e 65 6c 57 65 62 7d | 0d 0a 5c 78 78 7b 46 75 |nnelWeb}|..\xx{Fu|
|00000980| 6e 6e 65 6c 57 65 62 7d | 7b 6d 6f 74 69 76 61 74 |nnelWeb}|{motivat|
|00000990| 69 6f 6e 7d 0d 0a 0d 0a | 44 75 72 69 6e 67 20 31 |ion}....|During 1|
|000009a0| 39 38 36 2c 20 49 20 77 | 61 73 20 65 78 70 6f 73 |986, I w|as expos|
|000009b0| 65 64 20 74 6f 20 44 6f | 6e 61 6c 64 20 4b 6e 75 |ed to Do|nald Knu|
|000009c0| 74 68 27 73 5c 78 6e 7b | 44 6f 6e 61 6c 64 7d 7b |th's\xn{|Donald}{|
|000009d0| 4b 6e 75 74 68 7d 0d 0a | 5c 70 7b 57 45 42 7d 20 |Knuth}..|\p{WEB} |
|000009e0| 6c 69 74 65 72 61 74 65 | 0d 0a 70 72 6f 67 72 61 |literate|..progra|
|000009f0| 6d 6d 69 6e 67 20 73 79 | 73 74 65 6d 20 69 6e 20 |mming sy|stem in |
|00000a00| 74 68 65 0d 0a 66 6f 72 | 6d 20 6f 66 20 4a 6f 6e |the..for|m of Jon|
|00000a10| 20 42 65 6e 74 6c 65 79 | 27 73 5c 78 6e 7b 4a 6f | Bentley|'s\xn{Jo|
|00000a20| 6e 7d 7b 42 65 6e 74 6c | 65 79 7d 0d 0a 5c 69 7b |n}{Bentl|ey}..\i{|
|00000a30| 50 72 6f 67 72 61 6d 6d | 69 6e 67 20 20 50 65 61 |Programm|ing Pea|
|00000a40| 72 6c 73 7d 5c 78 7b 70 | 72 6f 67 72 61 6d 6d 69 |rls}\x{p|rogrammi|
|00000a50| 6e 67 20 70 65 61 72 6c | 73 7d 0d 0a 63 6f 6c 75 |ng pearl|s}..colu|
|00000a60| 6d 6e 20 69 6e 20 5c 69 | 7b 43 6f 6d 6d 75 6e 69 |mn in \i|{Communi|
|00000a70| 63 61 74 69 6f 6e 73 5c | 78 7b 43 6f 6d 6d 75 6e |cations\|x{Commun|
|00000a80| 69 63 61 74 69 6f 6e 73 | 20 6f 66 20 74 68 65 20 |ications| of the |
|00000a90| 41 43 4d 7d 20 6f 66 0d | 0a 74 68 65 20 41 43 4d |ACM} of.|.the ACM|
|00000aa0| 7d 5c 2f 5c 70 61 70 65 | 72 7b 42 65 6e 74 6c 65 |}\/\pape|r{Bentle|
|00000ab0| 79 38 36 7d 2e 5c 66 6f | 6f 74 6e 6f 74 65 7b 41 |y86}.\fo|otnote{A|
|00000ac0| 73 20 69 74 20 68 61 70 | 70 65 6e 73 2c 20 74 68 |s it hap|pens, th|
|00000ad0| 69 73 20 77 61 73 20 73 | 6f 6d 65 77 68 61 74 20 |is was s|omewhat |
|00000ae0| 6f 66 20 61 0d 0a 6c 75 | 63 6b 79 20 65 6e 63 6f |of a..lu|cky enco|
|00000af0| 75 6e 74 65 72 2e 20 49 | 20 68 61 64 20 6f 6e 6c |unter. I| had onl|
|00000b00| 79 20 6a 75 73 74 20 6a | 6f 69 6e 65 64 20 74 68 |y just j|oined th|
|00000b10| 65 20 41 43 4d 20 61 6e | 64 0d 0a 74 68 65 20 4d |e ACM an|d..the M|
|00000b20| 61 79 20 31 39 38 36 20 | 69 73 73 75 65 20 6f 66 |ay 1986 |issue of|
|00000b30| 20 43 41 43 4d 20 69 6e | 20 77 68 69 63 68 20 74 | CACM in| which t|
|00000b40| 68 65 20 63 6f 6c 75 6d | 6e 20 61 70 70 65 61 72 |he colum|n appear|
|00000b50| 65 64 20 77 61 73 20 74 | 68 65 20 66 69 72 73 74 |ed was t|he first|
|00000b60| 0d 0a 69 73 73 75 65 20 | 49 20 72 65 63 65 69 76 |..issue |I receiv|
|00000b70| 65 64 2e 7d 20 54 68 69 | 73 20 20 70 72 6f 6d 70 |ed.} Thi|s promp|
|00000b80| 74 65 64 20 6d 65 20 74 | 6f 20 6f 62 74 61 69 6e |ted me t|o obtain|
|00000b90| 20 20 61 20 63 6f 70 79 | 20 6f 66 20 74 68 65 0d | a copy| of the.|
|00000ba0| 0a 72 65 70 6f 72 74 20 | 6f 6e 20 74 68 65 20 57 |.report |on the W|
|00000bb0| 65 62 20 73 79 73 74 65 | 6d 5c 70 61 70 65 72 7b |eb syste|m\paper{|
|00000bc0| 4b 6e 75 74 68 38 33 7d | 0d 0a 61 6e 64 20 74 6f |Knuth83}|..and to|
|00000bd0| 20 74 72 79 20 6f 75 74 | 20 74 68 65 20 70 72 6f | try out| the pro|
|00000be0| 67 72 61 6d 20 77 68 69 | 63 68 20 68 61 64 20 62 |gram whi|ch had b|
|00000bf0| 65 65 6e 20 69 6e 73 74 | 61 6c 6c 65 64 20 6f 6e |een inst|alled on|
|00000c00| 20 74 68 65 20 6c 6f 63 | 61 6c 20 56 61 78 65 6e | the loc|al Vaxen|
|00000c10| 2e 0d 0a 0d 0a 57 65 62 | 20 77 61 73 20 20 74 68 |.....Web| was th|
|00000c20| 65 20 62 65 73 74 20 73 | 79 73 74 65 6d 20 74 68 |e best s|ystem th|
|00000c30| 61 74 20 49 20 68 61 64 | 20 73 65 65 6e 20 20 66 |at I had| seen f|
|00000c40| 6f 72 20 70 72 6f 64 75 | 63 69 6e 67 20 70 72 69 |or produ|cing pri|
|00000c50| 6e 74 65 64 20 61 6e 64 | 0d 0a 6f 6e 6c 69 6e 65 |nted and|..online|
|00000c60| 2c 20 69 6e 6c 69 6e 65 | 20 20 64 6f 63 75 6d 65 |, inline| docume|
|00000c70| 6e 74 61 74 69 6f 6e 2e | 20 54 6f 20 6d 65 0d 0a |ntation.| To me..|
|00000c80| 74 68 65 20 6d 6f 73 74 | 20 20 65 78 74 72 61 6f |the most| extrao|
|00000c90| 72 64 69 6e 61 72 79 20 | 61 73 70 65 63 74 20 6f |rdinary |aspect o|
|00000ca0| 66 20 74 68 65 20 20 73 | 79 73 74 65 6d 20 77 61 |f the s|ystem wa|
|00000cb0| 73 0d 0a 69 74 73 20 73 | 75 63 63 65 73 73 20 64 |s..its s|uccess d|
|00000cc0| 65 73 70 69 74 65 20 74 | 68 65 20 66 61 63 74 20 |espite t|he fact |
|00000cd0| 74 68 61 74 20 69 74 20 | 68 61 64 20 62 65 65 6e |that it |had been|
|00000ce0| 20 62 75 69 6c 74 20 69 | 6e 74 6f 20 74 68 65 20 | built i|nto the |
|00000cf0| 68 6f 72 72 69 62 6c 79 | 20 61 6e 74 69 71 75 61 |horribly| antiqua|
|00000d00| 74 65 64 0d 0a 66 69 6c | 65 2f 62 61 74 63 68 20 |ted..fil|e/batch |
|00000d10| 70 72 6f 63 65 73 73 69 | 6e 67 20 73 79 73 74 65 |processi|ng syste|
|00000d20| 6d 73 20 74 68 61 74 20 | 77 65 20 61 6c 6c 20 6b |ms that |we all k|
|00000d30| 6e 6f 77 20 20 61 6e 64 | 20 6c 6f 76 65 20 28 61 |now and| love (a|
|00000d40| 6e 64 20 75 73 65 29 2e | 20 49 20 68 61 64 0d 0a |nd use).| I had..|
|00000d50| 69 6d 61 67 69 6e 65 64 | 20 73 6f 70 68 69 73 74 |imagined| sophist|
|00000d60| 69 63 61 74 65 64 20 64 | 6f 63 75 6d 65 6e 74 61 |icated d|ocumenta|
|00000d70| 74 69 6f 6e 20 73 79 73 | 74 65 6d 73 20 62 65 66 |tion sys|tems bef|
|00000d80| 6f 72 65 20 74 68 69 73 | 20 74 69 6d 65 2c 20 62 |ore this| time, b|
|00000d90| 75 74 20 68 61 64 20 61 | 6c 77 61 79 73 0d 0a 61 |ut had a|lways..a|
|00000da0| 73 73 75 6d 65 64 20 74 | 68 61 74 20 74 68 65 79 |ssumed t|hat they|
|00000db0| 20 77 6f 75 6c 64 20 62 | 65 20 70 61 72 74 73 20 | would b|e parts |
|00000dc0| 6f 66 20 63 6f 6d 70 6c | 65 78 20 70 72 6f 67 72 |of compl|ex progr|
|00000dd0| 61 6d 6d 69 6e 67 20 65 | 6e 76 69 72 6f 6e 6d 65 |amming e|nvironme|
|00000de0| 6e 74 73 2e 0d 0a 4b 6e | 75 74 68 20 73 68 6f 77 |nts...Kn|uth show|
|00000df0| 65 64 20 74 68 61 74 2c | 20 74 6f 20 73 6f 6d 65 |ed that,| to some|
|00000e00| 20 65 78 74 65 6e 74 2c | 20 69 74 20 63 61 6e 20 | extent,| it can |
|00000e10| 62 65 20 64 6f 6e 65 20 | 75 73 69 6e 67 20 31 39 |be done |using 19|
|00000e20| 36 30 73 0d 0a 73 6f 66 | 74 77 61 72 65 20 74 65 |60s..sof|tware te|
|00000e30| 63 68 6e 6f 6c 6f 67 79 | 20 28 65 78 63 6c 75 64 |chnology| (exclud|
|00000e40| 69 6e 67 20 74 68 65 20 | 31 39 38 30 73 20 74 79 |ing the |1980s ty|
|00000e50| 70 65 73 65 74 74 69 6e | 67 20 74 65 63 68 6e 6f |pesettin|g techno|
|00000e60| 6c 6f 67 79 29 2e 0d 0a | 54 68 69 73 20 77 61 73 |logy)...|This was|
|00000e70| 20 65 78 63 69 74 69 6e | 67 2e 0d 0a 0d 0a 54 68 | excitin|g.....Th|
|00000e80| 65 20 57 65 62 20 20 73 | 79 73 74 65 6d 20 77 61 |e Web s|ystem wa|
|00000e90| 73 20 20 65 6e 74 69 63 | 69 6e 67 20 61 6e 64 20 |s entic|ing and |
|00000ea0| 70 72 6f 6d 69 73 69 6e | 67 20 20 62 75 74 20 74 |promisin|g but t|
|00000eb0| 6f 20 6d 65 20 73 75 66 | 66 65 72 65 64 20 20 66 |o me suf|fered f|
|00000ec0| 72 6f 6d 20 6d 61 6e 79 | 0d 0a 64 72 61 77 62 61 |rom many|..drawba|
|00000ed0| 63 6b 73 2c 20 6d 61 6e | 79 20 6f 66 20 77 68 69 |cks, man|y of whi|
|00000ee0| 63 68 20 4b 6e 75 74 68 | 20 68 61 64 20 20 70 72 |ch Knuth| had pr|
|00000ef0| 6f 6d 6f 74 65 64 20 61 | 73 20 61 64 76 61 6e 74 |omoted a|s advant|
|00000f00| 61 67 65 73 2e 20 54 68 | 65 20 66 6f 6c 6c 6f 77 |ages. Th|e follow|
|00000f10| 69 6e 67 20 68 69 67 68 | 6c 79 0d 0a 73 75 62 6a |ing high|ly..subj|
|00000f20| 65 63 74 69 76 65 20 6c | 69 73 74 20 20 6f 66 20 |ective l|ist of |
|00000f30| 64 69 73 61 64 76 61 6e | 74 61 67 65 73 20 66 6f |disadvan|tages fo|
|00000f40| 72 6d 65 64 20 20 61 20 | 73 70 72 69 6e 67 62 6f |rmed a |springbo|
|00000f50| 61 72 64 20 66 6f 72 20 | 74 68 65 20 20 63 6f 6e |ard for |the con|
|00000f60| 73 74 72 75 63 74 69 6f | 6e 20 6f 66 0d 0a 46 75 |structio|n of..Fu|
|00000f70| 6e 6e 65 6c 57 65 62 2e | 0d 0a 0d 0a 5c 62 65 67 |nnelWeb.|....\beg|
|00000f80| 69 6e 7b 69 74 65 6d 69 | 7a 65 7d 0d 0a 0d 0a 5c |in{itemi|ze}....\|
|00000f90| 69 74 65 6d 20 57 65 62 | 20 63 61 6e 20 6f 6e 6c |item Web| can onl|
|00000fa0| 79 20 70 72 6f 63 65 73 | 73 20 50 61 73 63 61 6c |y proces|s Pascal|
|00000fb0| 5c 78 7b 50 61 73 63 61 | 6c 7d 20 70 72 6f 67 72 |\x{Pasca|l} progr|
|00000fc0| 61 6d 73 2e 0d 0a 0d 0a | 5c 69 74 65 6d 20 57 65 |ams.....|\item We|
|00000fd0| 62 20 63 61 6e 20 70 72 | 6f 64 75 63 65 20 6f 6e |b can pr|oduce on|
|00000fe0| 6c 79 20 6f 6e 65 20 6f | 75 74 70 75 74 20 66 69 |ly one o|utput fi|
|00000ff0| 6c 65 2e 20 49 6e 20 6d | 61 6e 79 20 69 6e 73 74 |le. In m|any inst|
|00001000| 61 6e 63 65 73 20 69 74 | 20 69 73 0d 0a 64 65 73 |ances it| is..des|
|00001010| 69 72 61 62 6c 65 20 74 | 6f 20 67 65 6e 65 72 61 |irable t|o genera|
|00001020| 74 65 20 20 6d 6f 72 65 | 20 74 68 61 6e 20 6f 6e |te more| than on|
|00001030| 65 20 6f 75 74 70 75 74 | 20 66 69 6c 65 2e 20 46 |e output| file. F|
|00001040| 6f 72 20 20 65 78 61 6d | 70 6c 65 2c 20 77 68 65 |or exam|ple, whe|
|00001050| 6e 20 70 72 6f 67 72 61 | 6d 6d 69 6e 67 0d 0a 69 |n progra|mming..i|
|00001060| 6e 20 41 64 61 2c 20 20 | 69 74 20 69 73 20 20 64 |n Ada, |it is d|
|00001070| 65 73 69 72 61 62 6c 65 | 20 74 6f 20 77 72 69 74 |esirable| to writ|
|00001080| 65 20 20 61 20 70 61 63 | 6b 61 67 65 20 73 70 65 |e a pac|kage spe|
|00001090| 63 69 66 69 63 61 74 69 | 6f 6e 20 20 61 6e 64 20 |cificati|on and |
|000010a0| 61 20 20 70 61 63 6b 61 | 67 65 20 62 6f 64 79 0d |a packa|ge body.|
|000010b0| 0a 74 6f 67 65 74 68 65 | 72 20 69 6e 20 74 68 65 |.togethe|r in the|
|000010c0| 20 73 61 6d 65 20 66 69 | 6c 65 2e 5c 78 78 7b 6e | same fi|le.\xx{n|
|000010d0| 75 6d 62 65 72 7d 7b 6f | 75 74 70 75 74 20 66 69 |umber}{o|utput fi|
|000010e0| 6c 65 73 7d 0d 0a 0d 0a | 5c 69 74 65 6d 20 20 57 |les}....|\item W|
|000010f0| 65 62 20 20 65 6e 66 6f | 72 63 65 73 20 20 4b 6e |eb enfo|rces Kn|
|00001100| 75 74 68 27 73 20 20 69 | 6e 64 69 76 69 64 75 61 |uth's i|ndividua|
|00001110| 6c 20 73 74 79 6c 65 20 | 20 6f 66 20 20 69 6e 64 |l style | of ind|
|00001120| 65 6e 74 61 74 69 6f 6e | 2e 20 20 57 65 62 20 20 |entation|. Web |
|00001130| 73 75 70 70 6c 69 65 73 | 0d 0a 63 6f 6d 6d 61 6e |supplies|..comman|
|00001140| 64 73 20 74 6f 20 6f 76 | 65 72 2d 72 69 64 65 20 |ds to ov|er-ride |
|00001150| 20 74 68 65 20 61 75 74 | 6f 6d 61 74 69 63 20 69 | the aut|omatic i|
|00001160| 6e 64 65 6e 74 61 74 69 | 6f 6e 20 62 75 74 20 69 |ndentati|on but i|
|00001170| 74 20 69 73 20 20 61 6e | 20 75 70 68 69 6c 6c 20 |t is an| uphill |
|00001180| 62 61 74 74 6c 65 20 61 | 6e 64 0d 0a 74 68 65 20 |battle a|nd..the |
|00001190| 63 6f 64 65 20 62 65 63 | 6f 6d 65 73 20 63 6c 6f |code bec|omes clo|
|000011a0| 67 67 65 64 20 75 70 20 | 77 69 74 68 20 66 6f 72 |gged up |with for|
|000011b0| 6d 61 74 20 64 69 72 65 | 63 74 69 76 65 73 2e 5c |mat dire|ctives.\|
|000011c0| 78 7b 69 6e 64 65 6e 74 | 61 74 69 6f 6e 7d 0d 0a |x{indent|ation}..|
|000011d0| 0d 0a 5c 69 74 65 6d 20 | 57 65 62 20 20 64 6f 65 |..\item |Web doe|
|000011e0| 73 20 6e 6f 74 20 63 61 | 74 65 72 20 66 6f 72 20 |s not ca|ter for |
|000011f0| 20 6e 6f 6e 2d 73 74 61 | 6e 64 61 72 64 20 50 61 | non-sta|ndard Pa|
|00001200| 73 63 61 6c 20 70 72 6f | 67 72 61 6d 73 2e 20 49 |scal pro|grams. I|
|00001210| 6e 20 20 70 61 72 74 69 | 63 75 6c 61 72 2c 20 61 |n parti|cular, a|
|00001220| 6c 6c 0d 0a 69 64 65 6e | 74 69 66 69 65 72 73 20 |ll..iden|tifiers |
|00001230| 61 72 65 20 74 72 75 6e | 63 61 74 65 64 20 74 6f |are trun|cated to|
|00001240| 20 61 62 6f 75 74 20 65 | 69 67 68 74 20 63 68 61 | about e|ight cha|
|00001250| 72 61 63 74 65 72 73 2e | 0d 0a 0d 0a 5c 69 74 65 |racters.|....\ite|
|00001260| 6d 20 57 65 62 20 20 66 | 6f 72 6d 61 74 73 20 74 |m Web f|ormats t|
|00001270| 68 65 20 20 70 72 6f 67 | 72 61 6d 20 6f 75 74 70 |he prog|ram outp|
|00001280| 75 74 20 66 69 6c 65 20 | 20 69 6e 74 6f 20 61 20 |ut file | into a |
|00001290| 66 6f 72 6d 20 20 74 68 | 61 74 20 69 73 20 20 75 |form th|at is u|
|000012a0| 6e 72 65 61 64 61 62 6c | 65 20 74 6f 0d 0a 68 75 |nreadabl|e to..hu|
|000012b0| 6d 61 6e 73 2e 0d 0a 0d | 0a 5c 69 74 65 6d 20 20 |mans....|.\item |
|000012c0| 57 65 62 20 64 6f 65 73 | 20 20 6e 6f 74 20 20 70 |Web does| not p|
|000012d0| 72 6f 76 69 64 65 20 61 | 6e 20 69 6e 63 6c 75 64 |rovide a|n includ|
|000012e0| 65 20 66 61 63 69 6c 69 | 74 79 2e 0d 0a 54 68 69 |e facili|ty...Thi|
|000012f0| 73 20 20 77 61 73 20 63 | 6f 6e 73 69 64 65 72 65 |s was c|onsidere|
|00001300| 64 20 61 20 66 65 61 74 | 75 72 65 20 65 73 73 65 |d a feat|ure esse|
|00001310| 6e 74 69 61 6c 20 66 6f | 72 20 73 75 70 70 6f 72 |ntial fo|r suppor|
|00001320| 74 69 6e 67 20 6d 61 63 | 72 6f 20 6c 69 62 72 61 |ting mac|ro libra|
|00001330| 72 69 65 73 2e 0d 0a 0d | 0a 5c 69 74 65 6d 20 57 |ries....|.\item W|
|00001340| 65 62 20 70 72 6f 76 69 | 64 65 73 20 6d 61 63 72 |eb provi|des macr|
|00001350| 6f 73 20 77 69 74 68 20 | 61 74 20 6d 6f 73 74 20 |os with |at most |
|00001360| 6f 6e 65 20 70 61 72 61 | 6d 65 74 65 72 2e 20 4b |one para|meter. K|
|00001370| 6e 75 74 68 0d 0a 64 65 | 73 63 72 69 62 65 73 20 |nuth..de|scribes |
|00001380| 61 20 68 61 63 6b 20 74 | 68 61 74 20 63 61 6e 0d |a hack t|hat can.|
|00001390| 0a 65 78 74 72 61 63 74 | 20 61 20 6d 75 6c 74 69 |.extract| a multi|
|000013a0| 70 6c 65 20 70 61 72 61 | 6d 65 74 65 72 20 6d 61 |ple para|meter ma|
|000013b0| 63 72 6f 20 66 61 63 69 | 6c 69 74 79 20 20 66 72 |cro faci|lity fr|
|000013c0| 6f 6d 20 61 20 73 69 6e | 67 6c 65 20 70 61 72 61 |om a sin|gle para|
|000013d0| 6d 65 74 65 72 20 6f 6e | 65 2c 0d 0a 62 75 74 20 |meter on|e,..but |
|000013e0| 69 74 20 69 73 20 68 61 | 72 64 6c 79 20 73 61 74 |it is ha|rdly sat|
|000013f0| 69 73 66 61 63 74 6f 72 | 79 2e 0d 0a 0d 0a 5c 69 |isfactor|y.....\i|
|00001400| 74 65 6d 20 57 65 62 20 | 64 6f 65 73 20 6e 6f 74 |tem Web |does not|
|00001410| 20 70 72 6f 76 69 64 65 | 20 63 6f 6e 64 69 74 69 | provide| conditi|
|00001420| 6f 6e 61 6c 73 2e 0d 0a | 0d 0a 5c 65 6e 64 7b 69 |onals...|..\end{i|
|00001430| 74 65 6d 69 7a 65 7d 0d | 0a 0d 0a 4d 6f 73 74 20 |temize}.|...Most |
|00001440| 20 6f 66 20 74 68 65 73 | 65 20 20 6f 62 6a 65 63 | of thes|e objec|
|00001450| 74 69 6f 6e 73 20 62 6f | 69 6c 65 64 20 20 64 6f |tions bo|iled do|
|00001460| 77 6e 20 20 74 6f 20 74 | 77 6f 20 70 6f 69 6e 74 |wn to t|wo point|
|00001470| 73 3a 0d 0a 74 68 61 74 | 20 57 65 62 20 20 69 73 |s:..that| Web is|
|00001480| 20 66 61 72 20 20 74 6f | 6f 0d 0a 73 70 65 63 69 | far to|o..speci|
|00001490| 61 6c 69 7a 65 64 2c 20 | 61 6e 64 20 74 68 61 74 |alized, |and that|
|000014a0| 20 4b 6e 75 74 68 27 73 | 20 5c 64 71 7b 4f 63 63 | Knuth's| \dq{Occ|
|000014b0| 61 6d 27 73 20 52 61 7a | 6f 72 7d 5c 78 7b 4f 63 |am's Raz|or}\x{Oc|
|000014c0| 63 61 6d 27 73 20 72 61 | 7a 6f 72 7d 0d 0a 68 61 |cam's ra|zor}..ha|
|000014d0| 64 20 63 75 74 20 74 6f | 6f 20 66 61 72 2e 0d 0a |d cut to|o far...|
|000014e0| 57 68 61 74 20 49 20 77 | 61 6e 74 65 64 20 77 61 |What I w|anted wa|
|000014f0| 73 0d 0a 61 20 64 6f 63 | 75 6d 65 6e 74 61 74 69 |s..a doc|umentati|
|00001500| 6f 6e 20 73 79 73 74 65 | 6d 20 74 68 61 74 20 65 |on syste|m that e|
|00001510| 6d 70 6c 6f 79 65 64 20 | 20 61 6c 6c 20 74 68 65 |mployed | all the|
|00001520| 20 73 61 6d 65 20 70 72 | 69 6e 63 69 70 6c 65 73 | same pr|inciples|
|00001530| 20 61 73 20 57 65 62 0d | 0a 62 75 74 20 77 61 73 | as Web.|.but was|
|00001540| 20 66 61 72 0d 0a 6d 6f | 72 65 20 20 67 65 6e 65 | far..mo|re gene|
|00001550| 72 61 6c 2e 20 54 68 65 | 20 20 72 65 73 75 6c 74 |ral. The| result|
|00001560| 20 20 77 61 73 20 46 75 | 6e 6e 65 6c 57 65 62 7e | was Fu|nnelWeb~|
|00001570| 56 31 2c 20 20 77 68 69 | 63 68 20 63 61 6e 0d 0a |V1, whi|ch can..|
|00001580| 70 72 6f 63 65 73 73 20 | 20 70 72 6f 67 72 61 6d |process | program|
|00001590| 73 20 69 6e 20 20 61 6e | 79 0d 0a 6c 61 6e 67 75 |s in an|y..langu|
|000015a0| 61 67 65 20 6f 72 20 61 | 6e 79 20 63 6f 6d 62 69 |age or a|ny combi|
|000015b0| 6e 61 74 69 6f 6e 20 6f | 66 20 6c 61 6e 67 75 61 |nation o|f langua|
|000015c0| 67 65 73 20 61 74 20 20 | 74 68 65 20 63 6f 73 74 |ges at |the cost|
|000015d0| 20 6f 66 20 74 79 70 65 | 73 65 74 74 69 6e 67 20 | of type|setting |
|000015e0| 74 68 65 20 74 65 78 74 | 20 69 6e 0d 0a 5c 70 7b |the text| in..\p{|
|000015f0| 74 74 20 66 6f 6e 74 7d | 2e 0d 0a 0d 0a 4f 72 69 |tt font}|.....Ori|
|00001600| 67 69 6e 61 6c 6c 79 2c | 20 69 74 20 20 77 61 73 |ginally,| it was|
|00001610| 20 69 6e 74 65 6e 64 65 | 64 20 74 68 61 74 20 20 | intende|d that |
|00001620| 46 75 6e 6e 65 6c 57 65 | 62 20 77 6f 75 6c 64 20 |FunnelWe|b would |
|00001630| 62 65 20 74 79 70 65 73 | 65 74 74 65 72 20 20 69 |be types|etter i|
|00001640| 6e 64 65 70 65 6e 64 65 | 6e 74 20 61 73 0d 0a 77 |ndepende|nt as..w|
|00001650| 65 6c 6c 20 61 73 20 6c | 61 6e 67 75 61 67 65 20 |ell as l|anguage |
|00001660| 69 6e 64 65 70 65 6e 64 | 65 6e 74 2e 20 49 74 20 |independ|ent. It |
|00001670| 77 61 73 20 69 6e 74 65 | 6e 64 65 64 20 74 68 61 |was inte|nded tha|
|00001680| 74 20 61 20 66 6f 72 6d | 61 74 20 66 69 6c 65 20 |t a form|at file |
|00001690| 63 6f 6e 73 69 73 74 69 | 6e 67 20 6f 66 20 61 0d |consisti|ng of a.|
|000016a0| 0a 73 65 74 20 6f 66 20 | 70 72 6f 64 75 63 74 69 |.set of |producti|
|000016b0| 6f 6e 73 20 64 65 73 63 | 72 69 62 69 6e 67 20 68 |ons desc|ribing h|
|000016c0| 6f 77 20 74 68 65 20 64 | 6f 63 75 6d 65 6e 74 20 |ow the d|ocument |
|000016d0| 66 69 6c 65 20 77 61 73 | 20 74 6f 20 62 65 20 66 |file was| to be f|
|000016e0| 6f 72 6d 61 74 74 65 64 | 20 77 6f 75 6c 64 20 62 |ormatted| would b|
|000016f0| 65 0d 0a 68 61 6e 64 65 | 64 20 74 6f 20 46 75 6e |e..hande|d to Fun|
|00001700| 6e 65 6c 57 65 62 20 61 | 6c 6f 6e 67 20 77 69 74 |nelWeb a|long wit|
|00001710| 68 20 74 68 65 20 69 6e | 70 75 74 20 66 69 6c 65 |h the in|put file|
|00001720| 2e 20 49 6e 20 74 68 65 | 20 65 6e 64 2c 20 74 69 |. In the| end, ti|
|00001730| 6d 65 20 70 72 65 73 73 | 75 72 65 73 20 66 6f 72 |me press|ures for|
|00001740| 63 65 64 0d 0a 6d 65 20 | 74 6f 20 74 61 6b 65 20 |ced..me |to take |
|00001750| 74 68 65 20 62 61 63 6b | 20 64 6f 6f 72 20 61 6e |the back| door an|
|00001760| 64 20 68 61 63 6b 20 75 | 70 20 61 20 5c 54 65 58 |d hack u|p a \TeX|
|00001770| 7b 7d 20 64 6f 63 75 6d | 65 6e 74 20 66 69 6c 65 |{} docum|ent file|
|00001780| 20 67 65 6e 65 72 61 74 | 6f 72 2e 20 54 68 69 73 | generat|or. This|
|00001790| 0d 0a 63 6f 6d 70 72 6f | 6d 69 73 65 20 68 61 73 |..compro|mise has|
|000017a0| 20 66 6f 75 6e 64 20 69 | 74 73 20 77 61 79 20 69 | found i|ts way i|
|000017b0| 6e 74 6f 20 46 75 6e 6e | 65 6c 57 65 62 7e 56 33 |nto Funn|elWeb~V3|
|000017c0| 2e 30 20 77 68 69 63 68 | 20 69 73 20 73 74 69 6c |.0 which| is stil|
|000017d0| 6c 20 72 65 6c 69 61 6e | 74 0d 0a 6f 6e 20 5c 54 |l relian|t..on \T|
|000017e0| 65 58 7b 7d 2c 20 61 6c | 74 68 6f 75 67 68 20 56 |eX{}, al|though V|
|000017f0| 33 2e 30 20 61 74 20 6c | 65 61 73 74 20 65 6e 63 |3.0 at l|east enc|
|00001800| 6f 75 72 61 67 65 73 20 | 69 6e 70 75 74 20 66 69 |ourages |input fi|
|00001810| 6c 65 73 20 74 6f 20 62 | 65 20 74 79 70 65 73 65 |les to b|e typese|
|00001820| 74 74 65 72 0d 0a 69 6e | 64 65 70 65 6e 64 65 6e |tter..in|dependen|
|00001830| 74 2e 20 49 74 20 69 73 | 20 68 6f 70 65 64 20 74 |t. It is| hoped t|
|00001840| 68 61 74 20 66 75 74 75 | 72 65 20 76 65 72 73 69 |hat futu|re versi|
|00001850| 6f 6e 73 20 6f 66 20 46 | 75 6e 6e 65 6c 57 65 62 |ons of F|unnelWeb|
|00001860| 20 77 69 6c 6c 20 69 6e | 63 6c 75 64 65 0d 0a 6d | will in|clude..m|
|00001870| 6f 72 65 20 73 6f 70 68 | 69 73 74 69 63 61 74 65 |ore soph|isticate|
|00001880| 64 20 74 79 70 65 73 65 | 74 74 69 6e 67 20 66 61 |d typese|tting fa|
|00001890| 63 69 6c 69 74 69 65 73 | 2e 0d 0a 0d 0a 5c 73 65 |cilities|.....\se|
|000018a0| 63 74 69 6f 6e 7b 49 6e | 64 65 6e 74 61 74 69 6f |ction{In|dentatio|
|000018b0| 6e 7d 0d 0a 5c 78 7b 69 | 6e 64 65 6e 74 61 74 69 |n}..\x{i|ndentati|
|000018c0| 6f 6e 7d 5c 78 78 7b 69 | 6e 64 65 6e 74 61 74 69 |on}\xx{i|ndentati|
|000018d0| 6f 6e 7d 7b 6e 6f 7d 25 | 0d 0a 5c 78 78 7b 69 6e |on}{no}%|..\xx{in|
|000018e0| 64 65 6e 74 61 74 69 6f | 6e 7d 7b 62 6c 61 6e 6b |dentatio|n}{blank|
|000018f0| 7d 5c 78 78 7b 69 6e 64 | 65 6e 74 61 74 69 6f 6e |}\xx{ind|entation|
|00001900| 7d 7b 74 65 78 74 7d 0d | 0a 0d 0a 41 20 6d 61 63 |}{text}.|...A mac|
|00001910| 72 6f 20 63 61 6c 6c 20 | 74 68 61 74 20 64 6f 65 |ro call |that doe|
|00001920| 73 20 6e 6f 74 20 61 70 | 70 65 61 72 20 61 74 20 |s not ap|pear at |
|00001930| 74 68 65 20 6c 65 66 74 | 20 6d 61 72 67 69 6e 20 |the left| margin |
|00001940| 69 73 20 63 61 6c 6c 65 | 64 20 61 6e 0d 0a 5c 6e |is calle|d an..\n|
|00001950| 65 77 74 65 72 6d 7b 69 | 6e 64 65 6e 74 65 64 20 |ewterm{i|ndented |
|00001960| 6d 61 63 72 6f 20 63 61 | 6c 6c 7d 20 61 6e 64 20 |macro ca|ll} and |
|00001970| 73 65 65 6d 73 20 74 6f | 20 6c 65 61 64 20 74 6f |seems to| lead to|
|00001980| 20 74 68 72 65 65 20 64 | 69 66 66 65 72 65 6e 74 | three d|ifferent|
|00001990| 0d 0a 61 6c 74 65 72 6e | 61 74 69 76 65 73 20 66 |..altern|atives f|
|000019a0| 6f 72 20 69 74 73 20 65 | 78 70 61 6e 73 69 6f 6e |or its e|xpansion|
|000019b0| 3a 20 5c 6e 65 77 74 65 | 72 6d 7b 6e 6f 20 69 6e |: \newte|rm{no in|
|000019c0| 64 65 6e 74 61 74 69 6f | 6e 7d 2c 20 5c 6e 65 77 |dentatio|n}, \new|
|000019d0| 74 65 72 6d 7b 62 6c 61 | 6e 6b 0d 0a 69 6e 64 65 |term{bla|nk..inde|
|000019e0| 6e 74 61 74 69 6f 6e 7d | 2c 20 61 6e 64 20 5c 6e |ntation}|, and \n|
|000019f0| 65 77 74 65 72 6d 7b 74 | 65 78 74 20 69 6e 64 65 |ewterm{t|ext inde|
|00001a00| 6e 74 61 74 69 6f 6e 7d | 2e 20 48 65 72 65 20 61 |ntation}|. Here a|
|00001a10| 72 65 20 65 78 61 6d 70 | 6c 65 73 20 6f 66 20 65 |re examp|les of e|
|00001a20| 61 63 68 20 6b 69 6e 64 | 0d 0a 6f 66 20 69 6e 64 |ach kind|..of ind|
|00001a30| 65 6e 74 61 74 69 6f 6e | 2e 20 46 69 72 73 74 20 |entation|. First |
|00001a40| 74 68 65 20 65 78 61 6d | 70 6c 65 20 70 72 6f 62 |the exam|ple prob|
|00001a50| 6c 65 6d 2e 0d 0a 0d 0a | 5c 62 65 67 69 6e 7b 76 |lem.....|\begin{v|
|00001a60| 65 72 62 61 74 69 6d 7d | 0d 0a 40 24 40 3c 53 6c |erbatim}|..@$@<Sl|
|00001a70| 6f 74 68 40 3e 3d 3d 40 | 7b 40 2d 0d 0a 41 61 72 |oth@>==@|{@-..Aar|
|00001a80| 64 76 61 72 6b 0d 0a 57 | 61 6c 72 75 73 40 7d 0d |dvark..W|alrus@}.|
|00001a90| 0a 0d 0a 40 4f 40 3c 4f | 75 74 70 75 74 40 3e 3d |...@O@<O|utput@>=|
|00001aa0| 3d 40 7b 40 2d 0d 0a 5a | 65 62 72 61 40 3c 53 6c |=@{@-..Z|ebra@<Sl|
|00001ab0| 6f 74 68 40 3e 0d 0a 47 | 69 72 61 66 66 65 0d 0a |oth@>..G|iraffe..|
|00001ac0| 40 7d 0d 0a 5c 65 6e 64 | 7b 76 65 72 62 61 74 69 |@}..\end|{verbati|
|00001ad0| 6d 7d 0d 0a 0d 0a 54 68 | 65 72 65 20 61 72 65 20 |m}....Th|ere are |
|00001ae0| 74 68 72 65 65 20 77 61 | 79 73 20 74 68 61 74 20 |three wa|ys that |
|00001af0| 74 68 65 20 73 65 63 6f | 6e 64 20 6c 69 6e 65 20 |the seco|nd line |
|00001b00| 6f 66 20 74 68 65 20 5c | 70 7b 53 6c 6f 74 68 7d |of the \|p{Sloth}|
|00001b10| 20 6d 61 63 72 6f 0d 0a | 63 61 6e 20 62 65 20 69 | macro..|can be i|
|00001b20| 6e 64 65 6e 74 65 64 2e | 0d 0a 0d 0a 5c 74 68 69 |ndented.|....\thi|
|00001b30| 6e 67 7b 4e 6f 20 69 6e | 64 65 6e 74 61 74 69 6f |ng{No in|dentatio|
|00001b40| 6e 3a 7d 0d 0a 5c 62 65 | 67 69 6e 7b 76 65 72 62 |n:}..\be|gin{verb|
|00001b50| 61 74 69 6d 7d 0d 0a 20 | 20 20 20 20 5a 65 62 72 |atim}.. | Zebr|
|00001b60| 61 41 61 72 64 76 61 72 | 6b 0d 0a 20 20 20 20 20 |aAardvar|k.. |
|00001b70| 57 61 6c 72 75 73 0d 0a | 20 20 20 20 20 47 69 72 |Walrus..| Gir|
|00001b80| 61 66 66 65 0d 0a 5c 65 | 6e 64 7b 76 65 72 62 61 |affe..\e|nd{verba|
|00001b90| 74 69 6d 7d 0d 0a 0d 0a | 5c 74 68 69 6e 67 7b 42 |tim}....|\thing{B|
|00001ba0| 6c 61 6e 6b 20 69 6e 64 | 65 6e 74 61 74 69 6f 6e |lank ind|entation|
|00001bb0| 3a 7d 0d 0a 5c 62 65 67 | 69 6e 7b 76 65 72 62 61 |:}..\beg|in{verba|
|00001bc0| 74 69 6d 7d 0d 0a 20 20 | 20 20 20 5a 65 62 72 61 |tim}.. | Zebra|
|00001bd0| 41 61 72 64 76 61 72 6b | 0d 0a 20 20 20 20 20 20 |Aardvark|.. |
|00001be0| 20 20 20 20 57 61 6c 72 | 75 73 0d 0a 20 20 20 20 | Walr|us.. |
|00001bf0| 20 47 69 72 61 66 66 65 | 0d 0a 5c 65 6e 64 7b 76 | Giraffe|..\end{v|
|00001c00| 65 72 62 61 74 69 6d 7d | 0d 0a 0d 0a 5c 74 68 69 |erbatim}|....\thi|
|00001c10| 6e 67 7b 54 65 78 74 20 | 69 6e 64 65 6e 74 61 74 |ng{Text |indentat|
|00001c20| 69 6f 6e 3a 7d 0d 0a 5c | 62 65 67 69 6e 7b 76 65 |ion:}..\|begin{ve|
|00001c30| 72 62 61 74 69 6d 7d 0d | 0a 20 20 20 20 20 5a 65 |rbatim}.|. Ze|
|00001c40| 62 72 61 41 61 72 64 76 | 61 72 6b 0d 0a 20 20 20 |braAardv|ark.. |
|00001c50| 20 20 5a 65 62 72 61 57 | 61 6c 72 75 73 0d 0a 20 | ZebraW|alrus.. |
|00001c60| 20 20 20 20 47 69 72 61 | 66 66 65 0d 0a 5c 65 6e | Gira|ffe..\en|
|00001c70| 64 7b 76 65 72 62 61 74 | 69 6d 7d 0d 0a 0d 0a 4e |d{verbat|im}....N|
|00001c80| 6f 20 69 6e 64 65 6e 74 | 61 74 69 6f 6e 20 69 73 |o indent|ation is|
|00001c90| 20 75 73 65 66 75 6c 20 | 77 68 65 72 65 20 74 68 | useful |where th|
|00001ca0| 65 20 75 73 65 72 20 77 | 69 73 68 65 73 20 74 6f |e user w|ishes to|
|00001cb0| 20 64 65 61 6c 20 77 69 | 74 68 20 74 68 65 20 6f | deal wi|th the o|
|00001cc0| 75 74 70 75 74 0d 0a 73 | 74 72 65 61 6d 20 61 73 |utput..s|tream as|
|00001cd0| 20 61 20 70 75 72 65 20 | 6f 75 74 70 75 74 20 73 | a pure |output s|
|00001ce0| 74 72 65 61 6d 2e 20 42 | 6c 61 6e 6b 20 69 6e 64 |tream. B|lank ind|
|00001cf0| 65 6e 74 61 74 69 6f 6e | 20 69 73 20 75 73 65 66 |entation| is usef|
|00001d00| 75 6c 20 77 68 65 6e 20 | 74 68 65 20 75 73 65 72 |ul when |the user|
|00001d10| 0d 0a 77 69 73 68 65 73 | 20 74 6f 20 67 65 6e 65 |..wishes| to gene|
|00001d20| 72 61 74 65 20 69 6e 64 | 65 6e 74 65 64 20 63 6f |rate ind|ented co|
|00001d30| 6d 70 75 74 65 72 20 70 | 72 6f 67 72 61 6d 73 2e |mputer p|rograms.|
|00001d40| 0d 0a 54 65 78 74 20 69 | 6e 64 65 6e 74 61 74 69 |..Text i|ndentati|
|00001d50| 6f 6e 20 69 73 20 75 73 | 65 66 75 6c 20 77 68 65 |on is us|eful whe|
|00001d60| 72 65 20 74 68 65 20 75 | 73 65 72 20 77 69 73 68 |re the u|ser wish|
|00001d70| 65 73 20 74 6f 20 70 72 | 65 66 69 78 20 65 61 63 |es to pr|efix eac|
|00001d80| 68 20 6c 69 6e 65 20 6f | 66 20 61 6e 0d 0a 65 6e |h line o|f an..en|
|00001d90| 74 69 72 65 20 6d 61 63 | 72 6f 20 69 6e 76 6f 63 |tire mac|ro invoc|
|00001da0| 61 74 69 6f 6e 20 77 69 | 74 68 20 61 20 73 74 72 |ation wi|th a str|
|00001db0| 69 6e 67 2e 20 54 68 69 | 73 20 63 61 6e 20 62 65 |ing. Thi|s can be|
|00001dc0| 20 75 73 65 66 75 6c 20 | 66 6f 72 0d 0a 63 6f 6d | useful |for..com|
|00001dd0| 6d 65 6e 74 69 6e 67 20 | 6f 75 74 20 63 6f 64 65 |menting |out code|
|00001de0| 20 28 5c 65 67 7b 7d 69 | 6e 20 41 64 61 20 75 73 | (\eg{}i|n Ada us|
|00001df0| 69 6e 67 20 5c 70 7b 2d | 2d 7d 29 2c 20 61 6e 64 |ing \p{-|-}), and|
|00001e00| 20 66 6f 72 20 70 72 65 | 70 65 6e 64 69 6e 67 20 | for pre|pending |
|00001e10| 74 68 69 6e 67 73 0d 0a | 6c 69 6b 65 20 61 20 64 |things..|like a d|
|00001e20| 6f 6c 6c 61 72 20 73 69 | 67 6e 20 61 74 20 74 68 |ollar si|gn at th|
|00001e30| 65 20 73 74 61 72 74 20 | 6f 66 20 65 61 63 68 20 |e start |of each |
|00001e40| 6c 69 6e 65 20 61 6e 20 | 61 20 56 41 58 20 56 4d |line an |a VAX VM|
|00001e50| 53 20 44 43 4c 20 73 63 | 72 69 70 74 0d 0a 63 6f |S DCL sc|ript..co|
|00001e60| 6d 6d 61 6e 64 20 66 69 | 6c 65 2e 5c 78 7b 44 43 |mmand fi|le.\x{DC|
|00001e70| 4c 7d 0d 0a 0d 0a 46 75 | 6e 6e 65 6c 57 65 62 7e |L}....Fu|nnelWeb~|
|00001e80| 56 31 20 70 72 6f 76 69 | 64 65 64 20 61 20 63 68 |V1 provi|ded a ch|
|00001e90| 6f 69 63 65 20 6f 66 20 | 6e 6f 20 69 6e 64 65 6e |oice of |no inden|
|00001ea0| 74 61 74 69 6f 6e 20 6f | 72 20 62 6c 61 6e 6b 20 |tation o|r blank |
|00001eb0| 69 6e 64 65 6e 74 61 74 | 69 6f 6e 2e 0d 0a 54 68 |indentat|ion...Th|
|00001ec0| 65 20 63 68 6f 69 63 65 | 20 77 61 73 20 6d 61 64 |e choice| was mad|
|00001ed0| 65 20 69 6e 20 74 68 65 | 20 63 6f 6d 6d 61 6e 64 |e in the| command|
|00001ee0| 20 6c 69 6e 65 20 61 6e | 64 20 63 6f 75 6c 64 20 | line an|d could |
|00001ef0| 6e 6f 74 20 62 65 20 6f | 76 65 72 72 69 64 64 65 |not be o|verridde|
|00001f00| 6e 2e 0d 0a 0d 0a 54 68 | 65 20 64 65 73 69 67 6e |n.....Th|e design|
|00001f10| 20 71 75 65 73 74 69 6f | 6e 73 20 61 72 65 20 61 | questio|ns are a|
|00001f20| 73 20 66 6f 6c 6c 6f 77 | 73 3a 0d 0a 0d 0a 5c 62 |s follow|s:....\b|
|00001f30| 65 67 69 6e 7b 65 6e 75 | 6d 65 72 61 74 65 7d 0d |egin{enu|merate}.|
|00001f40| 0a 5c 69 74 65 6d 20 57 | 68 69 63 68 20 6f 66 20 |.\item W|hich of |
|00001f50| 74 68 65 20 74 68 72 65 | 65 20 6b 69 6e 64 73 20 |the thre|e kinds |
|00001f60| 6f 66 20 69 6e 64 65 6e | 74 61 74 69 6f 6e 20 73 |of inden|tation s|
|00001f70| 68 6f 75 6c 64 20 46 75 | 6e 6e 65 6c 57 65 62 20 |hould Fu|nnelWeb |
|00001f80| 73 75 70 70 6f 72 74 3f | 0d 0a 5c 69 74 65 6d 20 |support?|..\item |
|00001f90| 57 68 61 74 20 73 68 6f | 75 6c 64 20 62 65 20 74 |What sho|uld be t|
|00001fa0| 68 65 20 67 72 61 6e 75 | 6c 61 72 69 74 79 20 6f |he granu|larity o|
|00001fb0| 66 20 73 77 61 70 70 69 | 6e 67 20 62 65 74 77 65 |f swappi|ng betwe|
|00001fc0| 65 6e 20 69 6e 64 65 6e | 74 61 74 69 6f 6e 20 6d |en inden|tation m|
|00001fd0| 6f 64 65 73 3f 0d 0a 5c | 69 74 65 6d 20 41 72 65 |odes?..\|item Are|
|00001fe0| 20 70 61 72 74 69 63 75 | 6c 61 72 20 69 6e 64 65 | particu|lar inde|
|00001ff0| 6e 74 61 74 69 6f 6e 20 | 6d 6f 64 65 73 20 64 61 |ntation |modes da|
|00002000| 6e 67 65 72 6f 75 73 3f | 0d 0a 5c 69 74 65 6d 20 |ngerous?|..\item |
|00002010| 49 73 20 74 68 65 20 70 | 72 65 73 65 6e 63 65 20 |Is the p|resence |
|00002020| 6f 66 20 70 61 72 74 69 | 63 75 6c 61 72 20 63 6f |of parti|cular co|
|00002030| 6d 62 69 6e 61 74 69 6f | 6e 73 20 6f 66 20 69 6e |mbinatio|ns of in|
|00002040| 64 65 6e 74 61 74 69 6f | 6e 20 6d 6f 64 65 73 0d |dentatio|n modes.|
|00002050| 0a 20 20 20 20 20 20 63 | 6f 6e 66 75 73 69 6e 67 |. c|onfusing|
|00002060| 20 74 6f 20 74 68 65 20 | 75 73 65 72 3f 0d 0a 5c | to the |user?..\|
|00002070| 69 74 65 6d 20 48 6f 77 | 20 61 6e 64 20 77 68 65 |item How| and whe|
|00002080| 6e 20 73 68 6f 75 6c 64 | 20 74 68 65 20 63 68 6f |n should| the cho|
|00002090| 69 63 65 20 6f 66 20 69 | 6e 64 65 6e 74 61 74 69 |ice of i|ndentati|
|000020a0| 6f 6e 20 62 65 20 73 70 | 65 63 69 66 69 65 64 3f |on be sp|ecified?|
|000020b0| 0d 0a 5c 65 6e 64 7b 65 | 6e 75 6d 65 72 61 74 65 |..\end{e|numerate|
|000020c0| 7d 0d 0a 0d 0a 41 6c 6c | 20 73 6f 72 74 73 20 6f |}....All| sorts o|
|000020d0| 66 20 73 63 68 65 6d 65 | 73 20 77 65 72 65 20 63 |f scheme|s were c|
|000020e0| 6f 6e 73 69 64 65 72 65 | 64 2c 20 69 6e 63 6c 75 |onsidere|d, inclu|
|000020f0| 64 69 6e 67 20 61 20 66 | 69 6e 65 6c 79 20 67 72 |ding a f|inely gr|
|00002100| 61 69 6e 65 64 20 73 79 | 73 74 65 6d 20 69 6e 0d |ained sy|stem in.|
|00002110| 0a 77 68 69 63 68 20 74 | 68 65 20 75 73 65 72 20 |.which t|he user |
|00002120| 63 6f 75 6c 64 20 73 70 | 65 63 69 66 79 20 61 74 |could sp|ecify at|
|00002130| 20 74 68 65 20 70 6f 69 | 6e 74 20 6f 66 20 63 61 | the poi|nt of ca|
|00002140| 6c 6c 20 77 68 69 63 68 | 20 69 6e 64 65 6e 74 61 |ll which| indenta|
|00002150| 74 69 6f 6e 20 6d 6f 64 | 65 0d 0a 73 68 6f 75 6c |tion mod|e..shoul|
|00002160| 64 20 62 65 20 75 73 65 | 64 20 66 6f 72 20 74 68 |d be use|d for th|
|00002170| 65 20 63 61 6c 6c 65 64 | 20 6d 61 63 72 6f 20 65 |e called| macro e|
|00002180| 78 70 61 6e 73 69 6f 6e | 2e 0d 0a 0d 0a 41 66 74 |xpansion|.....Aft|
|00002190| 65 72 20 61 20 6c 6f 74 | 20 6f 66 20 74 68 6f 75 |er a lot| of thou|
|000021a0| 67 68 74 2c 20 74 68 65 | 20 64 6f 6d 69 6e 61 6e |ght, the| dominan|
|000021b0| 74 20 66 61 63 74 6f 72 | 20 74 68 61 74 20 73 68 |t factor| that sh|
|000021c0| 6f 75 6c 64 20 61 66 66 | 65 63 74 20 74 68 65 20 |ould aff|ect the |
|000021d0| 64 65 73 69 67 6e 0d 0a | 77 61 73 20 64 65 63 69 |design..|was deci|
|000021e0| 64 65 64 20 74 6f 20 62 | 65 20 74 68 65 20 5c 69 |ded to b|e the \i|
|000021f0| 7b 63 6c 61 72 69 74 79 | 7d 20 69 6e 20 74 68 65 |{clarity|} in the|
|00002200| 20 75 73 65 72 27 73 20 | 6d 69 6e 64 20 6f 66 20 | user's |mind of |
|00002210| 74 68 65 20 69 6e 64 65 | 6e 74 61 74 69 6f 6e 20 |the inde|ntation |
|00002220| 66 61 63 69 6c 69 74 79 | 0d 0a 61 6e 64 20 74 68 |facility|..and th|
|00002230| 65 20 5c 69 7b 64 61 6e | 67 65 72 7d 20 61 73 73 |e \i{dan|ger} ass|
|00002240| 6f 63 69 61 74 65 64 20 | 77 69 74 68 20 6d 69 73 |ociated |with mis|
|00002250| 75 6e 64 65 72 73 74 61 | 6e 64 69 6e 67 20 69 74 |understa|nding it|
|00002260| 2e 20 48 65 72 65 20 61 | 72 65 20 74 77 6f 20 0d |. Here a|re two .|
|00002270| 0a 65 78 61 6d 70 6c 65 | 73 20 74 68 61 74 20 73 |.example|s that s|
|00002280| 68 6f 77 20 68 6f 77 20 | 65 61 73 69 6c 79 20 61 |how how |easily a|
|00002290| 20 63 6f 6e 66 75 73 69 | 6f 6e 20 6f 72 0d 0a 6d | confusi|on or..m|
|000022a0| 69 73 75 6e 64 65 72 73 | 74 61 6e 64 69 6e 67 20 |isunders|tanding |
|000022b0| 6f 66 20 74 68 65 20 69 | 6e 64 65 6e 74 69 6e 67 |of the i|ndenting|
|000022c0| 20 62 65 69 6e 67 20 75 | 73 65 64 20 63 61 6e 20 | being u|sed can |
|000022d0| 63 61 75 73 65 20 64 61 | 6e 67 65 72 2e 0d 0a 54 |cause da|nger...T|
|000022e0| 68 65 20 66 69 72 73 74 | 20 65 78 61 6d 70 6c 65 |he first| example|
|000022f0| 20 73 68 6f 77 73 20 68 | 6f 77 20 62 6c 61 6e 6b | shows h|ow blank|
|00002300| 20 6f 72 20 6e 6f 20 69 | 6e 64 65 6e 74 61 74 69 | or no i|ndentati|
|00002310| 6f 6e 20 6d 69 67 68 74 | 20 62 65 0d 0a 6d 69 73 |on might| be..mis|
|00002320| 75 73 65 64 2e 0d 0a 0d | 0a 5c 62 65 67 69 6e 7b |used....|.\begin{|
|00002330| 76 65 72 62 61 74 69 6d | 7d 0d 0a 2d 2d 4d 69 73 |verbatim|}..--Mis|
|00002340| 75 73 65 20 6f 66 20 62 | 6c 61 6e 6b 20 28 61 6e |use of b|lank (an|
|00002350| 64 20 6e 6f 29 20 69 6e | 64 65 6e 74 61 74 69 6f |d no) in|dentatio|
|00002360| 6e 2e 0d 0a 2d 2d 40 3c | 53 6c 6f 74 68 40 3e 0d |n...--@<|Sloth@>.|
|00002370| 0a 5c 65 6e 64 7b 76 65 | 72 62 61 74 69 6d 7d 0d |.\end{ve|rbatim}.|
|00002380| 0a 0d 0a 48 65 72 65 20 | 74 68 65 20 75 73 65 72 |...Here |the user|
|00002390| 20 68 61 73 20 61 73 73 | 75 6d 65 64 20 74 68 61 | has ass|umed tha|
|000023a0| 74 20 74 65 78 74 20 69 | 6e 64 65 6e 74 61 74 69 |t text i|ndentati|
|000023b0| 6f 6e 20 69 73 20 69 6e | 20 61 63 74 69 6f 6e 20 |on is in| action |
|000023c0| 61 6e 64 20 68 61 73 0d | 0a 70 6c 61 63 65 64 20 |and has.|.placed |
|000023d0| 61 6e 20 41 64 61 20 63 | 6f 6d 6d 65 6e 74 20 73 |an Ada c|omment s|
|000023e0| 79 6d 62 6f 6c 20 5c 64 | 71 70 7b 2d 2d 7d 20 62 |ymbol \d|qp{--} b|
|000023f0| 65 66 6f 72 65 20 74 68 | 65 20 69 6e 76 6f 63 61 |efore th|e invoca|
|00002400| 74 69 6f 6e 20 6f 66 20 | 74 68 65 20 6d 61 63 72 |tion of |the macr|
|00002410| 6f 0d 0a 5c 70 7b 40 3c | 53 6c 6f 74 68 40 3e 7d |o..\p{@<|Sloth@>}|
|00002420| 20 69 6e 20 74 68 65 20 | 68 6f 70 65 20 74 68 61 | in the |hope tha|
|00002430| 74 20 74 68 65 20 65 6e | 74 69 72 65 20 74 65 78 |t the en|tire tex|
|00002440| 74 20 6f 66 20 74 68 65 | 20 6d 61 63 72 6f 20 77 |t of the| macro w|
|00002450| 6f 75 6c 64 20 62 65 20 | 70 72 65 66 69 78 65 64 |ould be |prefixed|
|00002460| 20 62 79 0d 0a 5c 64 71 | 70 7b 2d 2d 7d 2e 20 54 | by..\dq|p{--}. T|
|00002470| 68 65 20 72 65 73 75 6c | 74 20 63 6f 75 6c 64 20 |he resul|t could |
|00002480| 62 65 20 70 61 73 73 65 | 64 20 62 79 20 74 68 65 |be passe|d by the|
|00002490| 20 63 6f 6d 70 69 6c 65 | 72 20 77 68 69 63 68 20 | compile|r which |
|000024a0| 77 6f 75 6c 64 20 61 63 | 74 69 76 61 74 65 20 61 |would ac|tivate a|
|000024b0| 6c 6c 0d 0a 62 75 74 20 | 74 68 65 20 66 69 72 73 |ll..but |the firs|
|000024c0| 74 20 73 74 61 74 65 6d | 65 6e 74 20 69 6e 20 74 |t statem|ent in t|
|000024d0| 68 65 20 65 78 70 61 6e | 73 69 6f 6e 20 6f 66 20 |he expan|sion of |
|000024e0| 6d 61 63 72 6f 20 5c 70 | 7b 40 3c 53 6c 6f 74 68 |macro \p|{@<Sloth|
|000024f0| 40 3e 7d 2e 0d 0a 0d 0a | 54 68 65 20 6e 65 78 74 |@>}.....|The next|
|00002500| 20 65 78 61 6d 70 6c 65 | 20 64 65 6d 6f 6e 73 74 | example| demonst|
|00002510| 72 61 74 65 73 20 68 6f | 77 20 74 65 78 74 20 69 |rates ho|w text i|
|00002520| 6e 64 65 6e 74 61 74 69 | 6f 6e 20 63 6f 75 6c 64 |ndentati|on could|
|00002530| 20 62 65 0d 0a 6d 69 73 | 75 73 65 64 2e 5c 78 78 | be..mis|used.\xx|
|00002540| 7b 69 6e 64 65 6e 74 61 | 74 69 6f 6e 7d 7b 64 61 |{indenta|tion}{da|
|00002550| 6e 67 65 72 73 7d 0d 0a | 0d 0a 5c 62 65 67 69 6e |ngers}..|..\begin|
|00002560| 7b 76 65 72 62 61 74 69 | 6d 7d 0d 0a 2d 2d 4d 69 |{verbati|m}..--Mi|
|00002570| 73 75 73 65 20 6f 66 20 | 74 65 78 74 20 69 6e 64 |suse of |text ind|
|00002580| 65 6e 74 61 74 69 6f 6e | 3a 0d 0a 61 2b 2b 3b 20 |entation|:..a++; |
|00002590| 40 3c 53 6c 6f 74 68 40 | 3e 0d 0a 5c 65 6e 64 7b |@<Sloth@|>..\end{|
|000025a0| 76 65 72 62 61 74 69 6d | 7d 0d 0a 0d 0a 48 65 72 |verbatim|}....Her|
|000025b0| 65 20 74 68 65 20 75 73 | 65 72 20 68 61 73 20 70 |e the us|er has p|
|000025c0| 6c 61 63 65 64 20 74 68 | 65 20 63 61 6c 6c 20 74 |laced th|e call t|
|000025d0| 6f 20 5c 70 7b 40 3c 53 | 6c 6f 74 68 40 3e 7d 20 |o \p{@<S|loth@>} |
|000025e0| 61 66 74 65 72 20 74 68 | 65 20 69 6e 63 72 65 6d |after th|e increm|
|000025f0| 65 6e 74 69 6e 67 20 6f | 66 0d 0a 76 61 72 69 61 |enting o|f..varia|
|00002600| 62 6c 65 0d 0a 5c 70 7b | 61 7d 2e 20 54 68 65 20 |ble..\p{|a}. The |
|00002610| 72 65 73 75 6c 74 20 69 | 73 20 74 68 61 74 20 74 |result i|s that t|
|00002620| 68 65 72 65 20 69 73 20 | 61 20 67 6f 6f 64 20 63 |here is |a good c|
|00002630| 68 61 6e 63 65 20 74 68 | 61 74 20 74 68 65 20 5c |hance th|at the \|
|00002640| 64 71 70 7b 61 2b 2b 3b | 7d 0d 0a 70 72 65 70 65 |dqp{a++;|}..prepe|
|00002650| 6e 64 65 64 20 74 6f 0d | 0a 65 61 63 68 20 6c 69 |nded to.|.each li|
|00002660| 6e 65 20 6f 66 20 74 68 | 65 20 65 78 70 61 6e 73 |ne of th|e expans|
|00002670| 69 6f 6e 20 6f 66 20 5c | 70 7b 40 3c 53 6c 6f 74 |ion of \|p{@<Slot|
|00002680| 68 40 3e 7d 20 77 69 6c | 6c 20 62 65 20 70 61 73 |h@>} wil|l be pas|
|00002690| 73 65 64 20 62 79 20 74 | 68 65 20 63 6f 6d 70 69 |sed by t|he compi|
|000026a0| 6c 65 72 20 61 6e 64 0d | 0a 77 69 6c 6c 20 63 61 |ler and.|.will ca|
|000026b0| 75 73 65 20 5c 70 7b 61 | 7d 20 74 6f 20 62 65 20 |use \p{a|} to be |
|000026c0| 6f 76 65 72 69 6e 63 72 | 65 6d 65 6e 74 65 64 2e |overincr|emented.|
|000026d0| 0d 0a 0d 0a 54 68 65 73 | 65 20 65 78 61 6d 70 6c |....Thes|e exampl|
|000026e0| 65 73 20 61 72 65 20 6e | 6f 74 20 74 6f 20 62 65 |es are n|ot to be|
|000026f0| 20 6c 61 75 67 68 65 64 | 20 61 74 2e 20 49 74 20 | laughed| at. It |
|00002700| 69 73 20 70 6f 73 73 69 | 62 6c 65 20 74 68 61 74 |is possi|ble that|
|00002710| 20 46 75 6e 6e 65 6c 57 | 65 62 20 77 69 6c 6c 0d | FunnelW|eb will.|
|00002720| 0a 62 65 20 75 73 65 64 | 20 77 69 64 65 6c 79 2c |.be used| widely,|
|00002730| 20 61 6e 64 20 74 68 65 | 20 70 72 6f 62 6c 65 6d | and the| problem|
|00002740| 73 20 61 62 6f 76 65 20 | 6d 61 79 20 63 61 75 73 |s above |may caus|
|00002750| 65 20 70 72 6f 62 6c 65 | 6d 73 20 69 6e 20 63 72 |e proble|ms in cr|
|00002760| 69 74 69 63 61 6c 20 73 | 79 73 74 65 6d 73 2e 0d |itical s|ystems..|
|00002770| 0a 54 68 65 20 65 78 61 | 6d 70 6c 65 73 20 61 62 |.The exa|mples ab|
|00002780| 6f 76 65 20 61 72 65 20 | 70 61 72 74 69 63 75 6c |ove are |particul|
|00002790| 61 72 6c 79 20 73 63 61 | 72 79 20 62 65 63 61 75 |arly sca|ry becau|
|000027a0| 73 65 20 74 68 65 79 20 | 61 72 65 20 72 65 66 6c |se they |are refl|
|000027b0| 65 78 69 76 65 2e 20 4f | 6e 65 20 63 61 6e 6e 6f |exive. O|ne canno|
|000027c0| 74 0d 0a 73 69 6d 70 6c | 79 20 70 69 6e 20 74 68 |t..simpl|y pin th|
|000027d0| 65 20 62 6c 61 6d 65 20 | 6f 6e 20 6f 6e 65 20 70 |e blame |on one p|
|000027e0| 61 72 74 69 63 75 6c 61 | 72 20 69 6e 64 65 6e 74 |articula|r indent|
|000027f0| 61 74 69 6f 6e 20 66 6f | 72 6d 2e 20 41 20 6c 69 |ation fo|rm. A li|
|00002800| 74 74 6c 65 20 74 68 6f | 75 67 68 74 0d 0a 72 65 |ttle tho|ught..re|
|00002810| 76 65 61 6c 73 20 74 68 | 61 74 20 74 68 65 20 67 |veals th|at the g|
|00002820| 72 65 61 74 65 73 74 20 | 64 61 6e 67 65 72 20 6c |reatest |danger l|
|00002830| 69 65 73 20 69 6e 20 5c | 69 7b 63 6f 6e 66 75 73 |ies in \|i{confus|
|00002840| 69 6f 6e 7d 20 69 6e 20 | 74 68 65 20 75 73 65 72 |ion} in |the user|
|00002850| 27 73 20 6d 69 6e 64 2e | 0d 0a 49 66 20 74 68 65 |'s mind.|..If the|
|00002860| 0d 0a 75 73 65 72 20 69 | 73 20 63 6f 6e 66 75 73 |..user i|s confus|
|00002870| 65 64 20 62 65 74 77 65 | 65 6e 20 74 65 78 74 20 |ed betwe|en text |
|00002880| 6f 72 20 62 6c 61 6e 6b | 20 69 6e 64 65 6e 74 69 |or blank| indenti|
|00002890| 6e 67 2c 20 70 72 6f 62 | 6c 65 6d 73 20 77 69 6c |ng, prob|lems wil|
|000028a0| 6c 20 61 72 69 73 65 2e | 0d 0a 0d 0a 54 68 65 72 |l arise.|....Ther|
|000028b0| 65 20 73 65 65 6d 20 74 | 6f 20 62 65 20 74 77 6f |e seem t|o be two|
|000028c0| 20 77 61 79 73 20 74 6f | 20 73 6f 6c 76 65 20 74 | ways to| solve t|
|000028d0| 68 65 20 70 72 6f 62 6c | 65 6d 2e 20 54 68 65 20 |he probl|em. The |
|000028e0| 66 69 72 73 74 20 69 73 | 20 74 6f 20 62 61 6e 20 |first is| to ban |
|000028f0| 61 6c 6c 0d 0a 6d 61 63 | 72 6f 20 63 61 6c 6c 73 |all..mac|ro calls|
|00002900| 20 74 68 61 74 20 61 72 | 65 20 70 72 65 63 65 64 | that ar|e preced|
|00002910| 65 64 20 62 79 20 6e 6f | 6e 2d 62 6c 61 6e 6b 20 |ed by no|n-blank |
|00002920| 74 65 78 74 2e 20 54 68 | 69 73 20 69 73 20 6e 6f |text. Th|is is no|
|00002930| 74 20 61 20 67 6f 6f 64 | 20 6f 70 74 69 6f 6e 0d |t a good| option.|
|00002940| 0a 62 65 63 61 75 73 65 | 20 74 68 65 72 65 20 61 |.because| there a|
|00002950| 72 65 20 73 6f 20 6d 61 | 6e 79 20 63 61 73 65 73 |re so ma|ny cases|
|00002960| 20 77 68 65 72 65 20 69 | 74 20 69 73 20 64 65 73 | where i|t is des|
|00002970| 69 72 61 62 6c 65 20 74 | 6f 20 65 78 70 61 6e 64 |irable t|o expand|
|00002980| 20 6d 6f 72 65 20 74 68 | 61 6e 20 6f 6e 65 0d 0a | more th|an one..|
|00002990| 73 69 6e 67 6c 65 20 6c | 69 6e 65 20 6d 61 63 72 |single l|ine macr|
|000029a0| 6f 73 20 6f 6e 20 74 68 | 65 20 73 61 6d 65 20 6c |os on th|e same l|
|000029b0| 69 6e 65 2e 20 41 20 73 | 65 63 6f 6e 64 20 6f 70 |ine. A s|econd op|
|000029c0| 74 69 6f 6e 20 69 73 20 | 74 6f 20 65 6c 69 6d 69 |tion is |to elimi|
|000029d0| 6e 61 74 65 20 6f 6e 65 | 20 6f 66 0d 0a 74 68 65 |nate one| of..the|
|000029e0| 20 74 77 6f 20 66 6f 72 | 6d 73 20 73 6f 20 61 73 | two for|ms so as|
|000029f0| 20 74 6f 20 72 65 64 75 | 63 65 20 74 68 65 20 70 | to redu|ce the p|
|00002a00| 6f 74 65 6e 74 69 61 6c | 20 66 6f 72 20 61 6d 62 |otential| for amb|
|00002a10| 69 67 75 69 74 79 20 69 | 6e 20 74 68 65 20 75 73 |iguity i|n the us|
|00002a20| 65 72 27 73 0d 0a 6d 69 | 6e 64 2e 20 49 20 63 68 |er's..mi|nd. I ch|
|00002a30| 6f 6f 73 65 20 74 68 65 | 20 6c 61 74 74 65 72 20 |oose the| latter |
|00002a40| 6f 70 74 69 6f 6e 2e 20 | 4f 66 20 74 68 65 20 74 |option. |Of the t|
|00002a50| 77 6f 20 66 6f 72 6d 73 | 2c 20 74 68 65 20 63 6c |wo forms|, the cl|
|00002a60| 65 61 72 20 63 68 6f 69 | 63 65 20 66 6f 72 0d 0a |ear choi|ce for..|
|00002a70| 65 6c 69 6d 69 6e 61 74 | 69 6f 6e 20 69 73 20 74 |eliminat|ion is t|
|00002a80| 65 78 74 20 69 6e 64 65 | 6e 74 69 6e 67 20 66 6f |ext inde|nting fo|
|00002a90| 72 20 74 68 65 20 66 6f | 6c 6c 6f 77 69 6e 67 20 |r the fo|llowing |
|00002aa0| 72 65 61 73 6f 6e 73 3a | 0d 0a 0d 0a 5c 62 65 67 |reasons:|....\beg|
|00002ab0| 69 6e 7b 65 6e 75 6d 65 | 72 61 74 65 7d 0d 0a 5c |in{enume|rate}..\|
|00002ac0| 69 74 65 6d 20 49 74 20 | 61 63 74 75 61 6c 6c 79 |item It |actually|
|00002ad0| 20 69 6e 74 72 6f 64 75 | 63 65 73 20 65 78 74 72 | introdu|ces extr|
|00002ae0| 61 20 74 65 78 74 20 77 | 68 69 63 68 20 67 69 76 |a text w|hich giv|
|00002af0| 65 73 20 69 74 20 61 6e | 20 61 20 70 72 69 6f 72 |es it an| a prior|
|00002b00| 69 0d 0a 20 20 20 20 20 | 20 70 6f 74 65 6e 74 69 |i.. | potenti|
|00002b10| 61 6c 20 66 6f 72 20 70 | 72 6f 62 6c 65 6d 73 2e |al for p|roblems.|
|00002b20| 0d 0a 5c 69 74 65 6d 20 | 49 74 20 69 73 20 68 61 |..\item |It is ha|
|00002b30| 72 64 65 72 20 74 6f 20 | 69 6d 70 6c 65 6d 65 6e |rder to |implemen|
|00002b40| 74 20 61 6e 64 20 77 6f | 75 6c 64 20 73 6c 6f 77 |t and wo|uld slow|
|00002b50| 20 64 6f 77 6e 20 54 61 | 6e 67 6c 65 2e 0d 0a 5c | down Ta|ngle...\|
|00002b60| 69 74 65 6d 20 49 74 20 | 77 6f 75 6c 64 20 6e 6f |item It |would no|
|00002b70| 74 20 62 65 20 63 6f 6d | 70 61 74 69 62 6c 65 20 |t be com|patible |
|00002b80| 77 69 74 68 20 46 75 6e | 6e 65 6c 57 65 62 7e 56 |with Fun|nelWeb~V|
|00002b90| 31 20 77 68 69 63 68 20 | 75 73 65 73 20 62 6c 61 |1 which |uses bla|
|00002ba0| 6e 6b 0d 0a 20 20 20 20 | 20 20 69 6e 64 65 6e 74 |nk.. | indent|
|00002bb0| 61 74 69 6f 6e 2e 0d 0a | 5c 65 6e 64 7b 65 6e 75 |ation...|\end{enu|
|00002bc0| 6d 65 72 61 74 65 7d 0d | 0a 0d 0a 54 68 65 20 6f |merate}.|...The o|
|00002bd0| 6e 6c 79 20 6f 74 68 65 | 72 20 64 65 63 69 73 69 |nly othe|r decisi|
|00002be0| 6f 6e 20 69 73 20 74 68 | 65 20 6c 65 76 65 6c 20 |on is th|e level |
|00002bf0| 6f 66 20 67 72 61 6e 75 | 6c 61 72 69 74 79 20 6f |of granu|larity o|
|00002c00| 66 20 63 68 6f 69 63 65 | 20 62 65 74 77 65 65 6e |f choice| between|
|00002c10| 20 74 68 65 0d 0a 72 65 | 6d 61 69 6e 69 6e 67 20 | the..re|maining |
|00002c20| 6f 70 74 69 6f 6e 73 3a | 20 6e 6f 20 69 6e 64 65 |options:| no inde|
|00002c30| 6e 74 61 74 69 6f 6e 20 | 61 6e 64 20 62 6c 61 6e |ntation |and blan|
|00002c40| 6b 20 69 6e 64 65 6e 74 | 61 74 69 6f 6e 2e 20 46 |k indent|ation. F|
|00002c50| 75 6e 6e 65 6c 57 65 62 | 7e 56 31 0d 0a 61 6c 6c |unnelWeb|~V1..all|
|00002c60| 6f 77 65 64 20 74 68 69 | 73 20 63 68 6f 69 63 65 |owed thi|s choice|
|00002c70| 20 74 6f 20 62 65 20 6d | 61 64 65 20 69 6e 20 74 | to be m|ade in t|
|00002c80| 68 65 20 63 6f 6d 6d 61 | 6e 64 20 6c 69 6e 65 2e |he comma|nd line.|
|00002c90| 20 49 6e 20 72 65 74 72 | 6f 73 70 65 63 74 2c 20 | In retr|ospect, |
|00002ca0| 74 68 69 73 0d 0a 77 61 | 73 20 62 61 64 20 64 65 |this..wa|s bad de|
|00002cb0| 73 69 67 6e 20 62 65 63 | 61 75 73 65 20 74 68 65 |sign bec|ause the|
|00002cc0| 20 75 73 65 72 20 6d 69 | 67 68 74 20 75 6e 77 69 | user mi|ght unwi|
|00002cd0| 74 74 69 6e 67 6c 79 20 | 63 6f 64 65 20 63 65 72 |ttingly |code cer|
|00002ce0| 74 61 69 6e 20 6d 61 63 | 72 6f 20 63 61 6c 6c 73 |tain mac|ro calls|
|00002cf0| 0d 0a 72 65 6c 79 69 6e | 67 20 6f 6e 20 6f 6e 65 |..relyin|g on one|
|00002d00| 20 6f 72 20 74 68 65 20 | 6f 74 68 65 72 20 6d 6f | or the |other mo|
|00002d10| 64 65 2e 20 41 20 62 65 | 74 74 65 72 20 73 79 73 |de. A be|tter sys|
|00002d20| 74 65 6d 20 69 73 20 74 | 6f 20 61 6c 6c 6f 77 20 |tem is t|o allow |
|00002d30| 74 68 65 20 75 73 65 72 | 0d 0a 74 6f 20 73 70 65 |the user|..to spe|
|00002d40| 63 69 66 79 20 77 68 69 | 63 68 20 6d 6f 64 65 20 |cify whi|ch mode |
|00002d50| 69 6e 20 74 68 65 20 69 | 6e 70 75 74 20 66 69 6c |in the i|nput fil|
|00002d60| 65 20 69 74 73 65 6c 66 | 2e 20 54 68 69 73 20 68 |e itself|. This h|
|00002d70| 61 73 20 62 65 65 6e 20 | 64 6f 6e 65 20 69 6e 0d |as been |done in.|
|00002d80| 0a 46 75 6e 6e 65 6c 57 | 65 62 7e 56 33 2e 0d 0a |.FunnelW|eb~V3...|
|00002d90| 0d 0a 41 67 61 69 6e 2c | 20 74 6f 20 61 76 6f 69 |..Again,| to avoi|
|00002da0| 64 20 63 6f 6e 66 75 73 | 69 6f 6e 2c 20 69 74 20 |d confus|ion, it |
|00002db0| 73 65 65 6d 73 20 73 65 | 6e 73 69 62 6c 65 20 74 |seems se|nsible t|
|00002dc0| 6f 20 61 6c 6c 6f 77 20 | 74 68 65 20 75 73 65 72 |o allow |the user|
|00002dd0| 20 6f 6e 6c 79 0d 0a 6f | 6e 65 20 69 6e 64 65 6e | only..o|ne inden|
|00002de0| 74 61 74 69 6f 6e 20 6d | 6f 64 65 20 70 65 72 20 |tation m|ode per |
|00002df0| 46 75 6e 6e 65 6c 57 65 | 62 20 69 6e 70 75 74 20 |FunnelWe|b input |
|00002e00| 66 69 6c 65 2e 20 49 6e | 20 6d 6f 73 74 20 63 61 |file. In| most ca|
|00002e10| 73 65 73 2c 20 74 68 65 | 20 75 73 65 72 0d 0a 77 |ses, the| user..w|
|00002e20| 69 6c 6c 20 62 65 20 68 | 61 70 70 79 20 77 69 74 |ill be h|appy wit|
|00002e30| 68 20 62 6c 61 6e 6b 20 | 69 6e 64 65 6e 74 61 74 |h blank |indentat|
|00002e40| 69 6f 6e 20 28 74 68 65 | 20 64 65 66 61 75 6c 74 |ion (the| default|
|00002e50| 29 20 61 6e 64 20 74 68 | 65 72 65 20 77 69 6c 6c |) and th|ere will|
|00002e60| 20 62 65 0d 0a 6e 6f 20 | 6e 65 65 64 20 66 6f 72 | be..no |need for|
|00002e70| 20 63 68 61 6e 67 65 20 | 61 6e 79 77 61 79 2e 0d | change |anyway..|
|00002e80| 0a 0d 0a 5c 74 68 69 6e | 67 7b 44 65 63 69 73 69 |...\thin|g{Decisi|
|00002e90| 6f 6e 3a 7d 20 49 6d 70 | 6c 65 6d 65 6e 74 20 6f |on:} Imp|lement o|
|00002ea0| 6e 6c 79 20 5c 64 71 7b | 6e 6f 20 69 6e 64 65 6e |nly \dq{|no inden|
|00002eb0| 74 61 74 69 6f 6e 7d 20 | 61 6e 64 20 5c 64 71 7b |tation} |and \dq{|
|00002ec0| 62 6c 61 6e 6b 20 69 6e | 64 65 6e 74 61 74 69 6f |blank in|dentatio|
|00002ed0| 6e 7d 2e 0d 0a 4d 61 6b | 65 20 74 68 65 0d 0a 63 |n}...Mak|e the..c|
|00002ee0| 68 6f 69 63 65 20 6f 66 | 20 69 6e 64 65 6e 74 61 |hoice of| indenta|
|00002ef0| 74 69 6f 6e 20 61 20 73 | 74 61 74 69 63 20 61 74 |tion a s|tatic at|
|00002f00| 74 72 69 62 75 74 65 20 | 6f 66 20 61 20 70 61 72 |tribute |of a par|
|00002f10| 74 69 63 75 6c 61 72 20 | 46 75 6e 6e 65 6c 57 65 |ticular |FunnelWe|
|00002f20| 62 20 72 75 6e 0d 0a 74 | 68 61 74 20 69 73 20 73 |b run..t|hat is s|
|00002f30| 70 65 63 69 66 69 65 64 | 20 69 6e 20 74 68 65 20 |pecified| in the |
|00002f40| 69 6e 70 75 74 20 66 69 | 6c 65 2e 20 54 68 69 73 |input fi|le. This|
|00002f50| 20 73 6f 6c 75 74 69 6f | 6e 20 69 73 20 74 68 65 | solutio|n is the|
|00002f60| 20 73 61 6d 65 20 61 73 | 20 46 75 6e 6e 65 6c 57 | same as| FunnelW|
|00002f70| 65 62 7e 56 31 0d 0a 65 | 78 63 65 70 74 20 74 68 |eb~V1..e|xcept th|
|00002f80| 61 74 20 74 68 65 20 63 | 68 6f 69 63 65 20 68 61 |at the c|hoice ha|
|00002f90| 73 20 62 65 65 6e 20 6d | 6f 76 65 64 20 66 72 6f |s been m|oved fro|
|00002fa0| 6d 20 74 68 65 20 63 6f | 6d 6d 61 6e 64 20 6c 69 |m the co|mmand li|
|00002fb0| 6e 65 20 74 6f 20 74 68 | 65 0d 0a 69 6e 70 75 74 |ne to th|e..input|
|00002fc0| 20 66 69 6c 65 2e 0d 0a | 0d 0a 5c 73 65 63 74 69 | file...|..\secti|
|00002fd0| 6f 6e 7b 52 65 76 69 65 | 77 20 6f 66 20 46 75 6e |on{Revie|w of Fun|
|00002fe0| 6e 65 6c 57 65 62 20 53 | 79 6e 74 61 78 7d 0d 0a |nelWeb S|yntax}..|
|00002ff0| 5c 78 78 7b 46 75 6e 6e | 65 6c 57 65 62 7d 7b 73 |\xx{Funn|elWeb}{s|
|00003000| 79 6e 74 61 78 7d 0d 0a | 0d 0a 4f 6e 65 20 6f 66 |yntax}..|..One of|
|00003010| 20 74 68 65 20 64 69 73 | 74 72 65 73 73 69 6e 67 | the dis|tressing|
|00003020| 20 61 73 70 65 63 74 73 | 20 6f 66 20 46 75 6e 6e | aspects| of Funn|
|00003030| 65 6c 57 65 62 7e 56 31 | 20 77 61 73 20 69 74 73 |elWeb~V1| was its|
|00003040| 20 63 6c 75 6d 73 79 20 | 6d 61 63 72 6f 0d 0a 64 | clumsy |macro..d|
|00003050| 65 66 69 6e 69 74 69 6f | 6e 20 61 6e 64 20 63 61 |efinitio|n and ca|
|00003060| 6c 6c 69 6e 67 20 73 79 | 6e 74 61 78 2e 0d 0a 43 |lling sy|ntax...C|
|00003070| 6f 6d 70 61 72 65 64 20 | 74 6f 20 28 73 61 79 29 |ompared |to (say)|
|00003080| 20 74 68 65 20 43 20 70 | 72 65 70 72 6f 63 65 73 | the C p|reproces|
|00003090| 73 6f 72 2c 20 46 75 6e | 6e 65 6c 57 65 62 27 73 |sor, Fun|nelWeb's|
|000030a0| 20 6d 61 63 72 6f 20 63 | 61 6c 6c 20 73 79 6e 74 | macro c|all synt|
|000030b0| 61 78 20 69 73 0d 0a 6c | 69 6b 65 20 61 20 66 72 |ax is..l|ike a fr|
|000030c0| 65 69 67 68 74 20 74 72 | 61 69 6e 20 69 6e 20 61 |eight tr|ain in a|
|000030d0| 20 63 68 69 6e 61 20 73 | 68 6f 77 2e 0d 0a 44 75 | china s|how...Du|
|000030e0| 72 69 6e 67 20 74 68 65 | 20 46 75 6e 6e 65 6c 57 |ring the| FunnelW|
|000030f0| 65 62 20 72 65 64 65 73 | 69 67 6e 2c 20 61 20 63 |eb redes|ign, a c|
|00003100| 6f 6d 70 6c 65 74 65 20 | 72 65 76 69 65 77 20 6f |omplete |review o|
|00003110| 66 20 74 68 69 73 20 73 | 79 6e 74 61 78 20 74 6f |f this s|yntax to|
|00003120| 6f 6b 20 70 6c 61 63 65 | 20 74 6f 0d 0a 74 72 79 |ok place| to..try|
|00003130| 20 74 6f 20 6e 65 61 74 | 65 6e 20 69 74 20 75 70 | to neat|en it up|
|00003140| 2e 20 53 75 72 70 72 69 | 73 69 6e 67 6c 79 2c 20 |. Surpri|singly, |
|00003150| 74 68 65 20 56 31 20 73 | 79 6e 74 61 78 20 73 75 |the V1 s|yntax su|
|00003160| 72 76 69 76 65 64 20 75 | 6e 73 63 61 74 68 65 64 |rvived u|nscathed|
|00003170| 0d 0a 77 69 74 68 20 74 | 68 65 20 65 78 63 65 70 |..with t|he excep|
|00003180| 74 69 6f 6e 20 74 68 61 | 74 20 5c 64 71 70 7b 3d |tion tha|t \dqp{=|
|00003190| 3d 7d 5c 78 7b 3d 3d 7d | 20 69 6e 20 6d 61 63 72 |=}\x{==}| in macr|
|000031a0| 6f 20 64 65 66 69 6e 69 | 74 69 6f 6e 73 20 77 61 |o defini|tions wa|
|000031b0| 73 20 6d 61 64 65 20 6f | 70 74 69 6f 6e 61 6c 2e |s made o|ptional.|
|000031c0| 0d 0a 54 68 65 20 73 75 | 72 76 69 76 61 6c 20 6f |..The su|rvival o|
|000031d0| 66 20 74 68 69 73 20 63 | 6c 75 6d 73 79 20 73 79 |f this c|lumsy sy|
|000031e0| 6e 74 61 78 20 77 61 73 | 20 61 20 70 72 6f 64 75 |ntax was| a produ|
|000031f0| 63 74 20 6f 66 20 74 68 | 65 20 64 65 73 69 67 6e |ct of th|e design|
|00003200| 20 67 6f 61 6c 20 6f 66 | 0d 0a 6d 61 6b 69 6e 67 | goal of|..making|
|00003210| 20 65 76 65 72 79 74 68 | 69 6e 67 20 73 69 6d 70 | everyth|ing simp|
|00003220| 6c 65 2c 20 65 78 70 6c | 69 63 69 74 2c 20 61 6e |le, expl|icit, an|
|00003230| 64 20 6e 6f 74 20 73 75 | 62 6a 65 63 74 20 74 6f |d not su|bject to|
|00003240| 20 73 75 62 74 6c 65 20 | 65 72 72 6f 72 73 2e 0d | subtle |errors..|
|00003250| 0a 0d 0a 5c 73 75 62 73 | 65 63 74 69 6f 6e 7b 52 |...\subs|ection{R|
|00003260| 65 76 69 65 77 20 6f 66 | 20 4d 61 63 72 6f 20 44 |eview of| Macro D|
|00003270| 65 66 69 6e 69 74 69 6f | 6e 20 53 79 6e 74 61 78 |efinitio|n Syntax|
|00003280| 7d 0d 0a 5c 78 78 7b 6d | 61 63 72 6f 20 64 65 66 |}..\xx{m|acro def|
|00003290| 69 6e 69 74 69 6f 6e 7d | 7b 73 79 6e 74 61 78 7d |inition}|{syntax}|
|000032a0| 0d 0a 0d 0a 46 75 6e 6e | 65 6c 57 65 62 7e 56 31 |....Funn|elWeb~V1|
|000032b0| 20 75 73 65 64 20 61 20 | 6d 61 63 72 6f 20 64 65 | used a |macro de|
|000032c0| 66 69 6e 69 74 69 6f 6e | 20 73 79 6e 74 61 78 20 |finition| syntax |
|000032d0| 74 68 61 74 20 72 65 73 | 75 6c 74 65 64 20 69 6e |that res|ulted in|
|000032e0| 20 6d 61 63 72 6f 0d 0a | 64 65 66 69 6e 69 74 69 | macro..|definiti|
|000032f0| 6f 6e 73 20 73 75 63 68 | 20 61 73 20 74 68 65 20 |ons such| as the |
|00003300| 66 6f 6c 6c 6f 77 69 6e | 67 2e 0d 0a 0d 0a 5c 62 |followin|g.....\b|
|00003310| 65 67 69 6e 7b 76 65 72 | 62 61 74 69 6d 7d 0d 0a |egin{ver|batim}..|
|00003320| 40 24 40 3c 50 75 74 20 | 6f 75 74 20 74 68 65 20 |@$@<Put |out the |
|00003330| 63 61 74 40 3e 3d 3d 40 | 7b 40 2d 0d 0a 4f 70 65 |cat@>==@|{@-..Ope|
|00003340| 6e 20 74 68 65 20 64 6f | 6f 72 0d 0a 53 61 79 20 |n the do|or..Say |
|00003350| 6f 75 74 0d 0a 43 6c 6f | 73 65 20 74 68 65 20 64 |out..Clo|se the d|
|00003360| 6f 6f 72 40 7d 0d 0a 5c | 65 6e 64 7b 76 65 72 62 |oor@}..\|end{verb|
|00003370| 61 74 69 6d 7d 0d 0a 0d | 0a 54 68 69 73 20 69 73 |atim}...|.This is|
|00003380| 20 6d 65 73 73 79 2c 20 | 62 75 74 20 49 20 63 6f | messy, |but I co|
|00003390| 75 6c 64 6e 27 74 20 74 | 68 69 6e 6b 20 6f 66 20 |uldn't t|hink of |
|000033a0| 61 6e 79 74 68 69 6e 67 | 20 62 65 74 74 65 72 20 |anything| better |
|000033b0| 61 74 20 74 68 65 20 74 | 69 6d 65 2e 0d 0a 54 68 |at the t|ime...Th|
|000033c0| 65 20 5c 70 7b 40 5c 24 | 7d 20 69 73 20 6e 65 63 |e \p{@\$|} is nec|
|000033d0| 65 73 73 61 72 79 20 74 | 6f 20 63 75 65 20 61 20 |essary t|o cue a |
|000033e0| 64 65 66 69 6e 69 74 69 | 6f 6e 2e 20 57 69 74 68 |definiti|on. With|
|000033f0| 6f 75 74 20 69 74 2c 20 | 74 68 65 20 64 65 66 69 |out it, |the defi|
|00003400| 6e 69 74 69 6f 6e 0d 0a | 6d 69 67 68 74 20 73 6f |nition..|might so|
|00003410| 6d 65 68 6f 77 20 62 65 | 20 6d 69 73 74 61 6b 65 |mehow be| mistake|
|00003420| 6e 20 66 6f 72 20 61 6e | 20 69 6e 76 6f 63 61 74 |n for an| invocat|
|00003430| 69 6f 6e 2e 0d 0a 54 68 | 65 20 5c 70 7b 40 3c 7d |ion...Th|e \p{@<}|
|00003440| 20 61 6e 64 20 5c 70 7b | 40 3e 7d 20 64 65 6c 69 | and \p{|@>} deli|
|00003450| 6d 69 74 20 74 68 65 20 | 6e 61 6d 65 2e 0d 0a 54 |mit the |name...T|
|00003460| 68 65 20 5c 70 7b 40 24 | 5c 7b 24 7d 20 61 6e 64 |he \p{@$|\{$} and|
|00003470| 20 5c 70 7b 40 24 5c 7d | 24 7d 20 64 65 6c 69 6d | \p{@$\}|$} delim|
|00003480| 69 74 20 74 68 65 20 74 | 65 78 74 2e 0d 0a 54 68 |it the t|ext...Th|
|00003490| 65 20 5c 70 7b 40 2d 7d | 20 69 73 20 61 20 70 72 |e \p{@-}| is a pr|
|000034a0| 6f 64 75 63 74 20 6f 66 | 20 74 68 65 20 72 75 6c |oduct of| the rul|
|000034b0| 65 0d 0a 5c 64 71 7b 65 | 78 61 63 74 6c 79 20 74 |e..\dq{e|xactly t|
|000034c0| 68 65 20 74 65 78 74 20 | 62 65 74 77 65 65 6e 20 |he text |between |
|000034d0| 74 68 65 20 5c 70 7b 40 | 24 5c 7b 24 7d 20 61 6e |the \p{@|$\{$} an|
|000034e0| 64 20 5c 70 7b 40 24 5c | 7d 24 7d 7d 2e 0d 0a 0d |d \p{@$\|}$}}....|
|000034f0| 0a 54 68 65 20 6f 6e 6c | 79 20 72 65 61 6c 20 74 |.The onl|y real t|
|00003500| 61 72 67 65 74 20 69 73 | 20 74 68 65 20 5c 64 71 |arget is| the \dq|
|00003510| 70 7b 2b 3d 7d 20 61 6e | 64 20 5c 64 71 70 7b 3d |p{+=} an|d \dqp{=|
|00003520| 3d 7d 20 77 68 69 63 68 | 20 72 65 61 6c 6c 79 20 |=} which| really |
|00003530| 62 72 65 61 6b 20 61 6c | 6c 0d 0a 74 68 65 20 72 |break al|l..the r|
|00003540| 75 6c 65 73 0d 0a 61 6e | 64 20 73 68 6f 75 6c 64 |ules..an|d should|
|00003550| 20 62 65 20 63 68 61 6e | 67 65 64 2e 20 55 6e 66 | be chan|ged. Unf|
|00003560| 6f 72 74 75 6e 61 74 65 | 6c 79 20 49 20 63 6f 75 |ortunate|ly I cou|
|00003570| 6c 64 6e 27 74 0d 0a 74 | 68 69 6e 6b 20 6f 66 20 |ldn't..t|hink of |
|00003580| 61 6e 79 74 68 69 6e 67 | 20 74 6f 20 63 68 61 6e |anything| to chan|
|00003590| 67 65 20 74 68 65 6d 0d | 0a 74 6f 2e 20 49 66 20 |ge them.|.to. If |
|000035a0| 74 68 65 72 65 20 77 61 | 73 20 6e 6f 20 5c 70 7b |there wa|s no \p{|
|000035b0| 2b 3d 7d 20 6d 65 63 68 | 61 6e 69 73 6d 2c 20 77 |+=} mech|anism, w|
|000035c0| 65 20 63 6f 75 6c 64 20 | 75 73 65 3a 0d 0a 0d 0a |e could |use:....|
|000035d0| 5c 62 65 67 69 6e 7b 76 | 65 72 62 61 74 69 6d 7d |\begin{v|erbatim}|
|000035e0| 0d 0a 40 24 40 3c 50 75 | 74 20 6f 75 74 20 74 68 |..@$@<Pu|t out th|
|000035f0| 65 20 63 61 74 40 3e 40 | 7b 0d 0a 4f 70 65 6e 20 |e cat@>@|{..Open |
|00003600| 74 68 65 20 64 6f 6f 72 | 0d 0a 53 61 79 20 6f 75 |the door|..Say ou|
|00003610| 74 0d 0a 43 6c 6f 73 65 | 20 74 68 65 20 64 6f 6f |t..Close| the doo|
|00003620| 72 40 7d 0d 0a 5c 65 6e | 64 7b 76 65 72 62 61 74 |r@}..\en|d{verbat|
|00003630| 69 6d 7d 0d 0a 0d 0a 49 | 6e 20 66 61 63 74 2c 20 |im}....I|n fact, |
|00003640| 65 6c 69 6d 69 6e 61 74 | 69 6e 67 20 5c 70 7b 2b |eliminat|ing \p{+|
|00003650| 3d 7d 20 69 73 20 74 68 | 69 6e 6b 61 62 6c 65 20 |=} is th|inkable |
|00003660| 62 65 63 61 75 73 65 20 | 69 74 20 64 6f 65 73 20 |because |it does |
|00003670| 6e 6f 74 20 61 70 70 65 | 61 72 20 69 6e 0d 0a 6d |not appe|ar in..m|
|00003680| 61 6e 79 20 6f 66 20 6d | 79 20 65 78 69 73 74 69 |any of m|y existi|
|00003690| 6e 67 20 46 75 6e 6e 65 | 6c 57 65 62 20 73 6f 75 |ng Funne|lWeb sou|
|000036a0| 72 63 65 20 66 69 6c 65 | 73 2e 20 54 68 69 73 20 |rce file|s. This |
|000036b0| 69 6e 64 69 63 61 74 65 | 73 20 61 74 20 6c 65 61 |indicate|s at lea|
|000036c0| 73 74 20 74 68 61 74 0d | 0a 69 74 20 77 61 73 20 |st that.|.it was |
|000036d0| 6e 6f 74 20 6e 65 65 64 | 65 64 20 6d 75 63 68 20 |not need|ed much |
|000036e0| 62 79 20 6d 79 73 65 6c | 66 2e 0d 0a 0d 0a 41 20 |by mysel|f.....A |
|000036f0| 6d 69 6e 69 6d 61 6c 69 | 73 74 20 63 6f 6e 73 74 |minimali|st const|
|00003700| 72 75 63 74 20 63 6f 75 | 6c 64 20 62 65 0d 0a 0d |ruct cou|ld be...|
|00003710| 0a 5c 62 65 67 69 6e 7b | 76 65 72 62 61 74 69 6d |.\begin{|verbatim|
|00003720| 7d 0d 0a 40 3c 50 75 74 | 20 6f 75 74 20 74 68 65 |}..@<Put| out the|
|00003730| 20 63 61 74 40 3e 0d 0a | 4f 70 65 6e 20 74 68 65 | cat@>..|Open the|
|00003740| 20 64 6f 6f 72 0d 0a 53 | 61 79 20 6f 75 74 0d 0a | door..S|ay out..|
|00003750| 43 6c 6f 73 65 20 74 68 | 65 20 64 6f 6f 72 40 7d |Close th|e door@}|
|00003760| 0d 0a 5c 65 6e 64 7b 76 | 65 72 62 61 74 69 6d 7d |..\end{v|erbatim}|
|00003770| 0d 0a 0d 0a 62 75 74 20 | 74 68 69 73 20 69 73 20 |....but |this is |
|00003780| 74 6f 6f 20 64 61 6e 67 | 65 72 6f 75 73 20 66 6f |too dang|erous fo|
|00003790| 72 20 6d 79 20 74 61 73 | 74 65 73 2e 0d 0a 0d 0a |r my tas|tes.....|
|000037a0| 5c 74 68 69 6e 67 7b 44 | 65 63 69 73 69 6f 6e 3a |\thing{D|ecision:|
|000037b0| 7d 20 46 6f 72 20 63 6f | 6d 70 61 74 69 62 69 6c |} For co|mpatibil|
|000037c0| 69 74 79 20 72 65 61 73 | 6f 6e 73 2c 0d 0a 72 65 |ity reas|ons,..re|
|000037d0| 74 61 69 6e 20 74 68 65 | 20 6f 6c 64 20 5c 70 7b |tain the| old \p{|
|000037e0| 2b 3d 7d 20 61 6e 64 20 | 5c 70 7b 3d 3d 7d 20 63 |+=} and |\p{==} c|
|000037f0| 6f 6e 73 74 72 75 63 74 | 73 2c 20 62 75 74 20 6d |onstruct|s, but m|
|00003800| 61 6b 65 20 74 68 65 6d | 20 6f 70 74 69 6f 6e 61 |ake them| optiona|
|00003810| 6c 2e 0d 0a 54 68 65 20 | 6e 65 77 20 73 79 6e 74 |l...The |new synt|
|00003820| 61 78 20 66 6f 72 20 64 | 65 66 69 6e 69 6e 67 20 |ax for d|efining |
|00003830| 6d 61 63 72 6f 73 20 69 | 73 3a 0d 0a 0d 0a 5c 62 |macros i|s:....\b|
|00003840| 65 67 69 6e 7b 76 65 72 | 62 61 74 69 6d 7d 0d 0a |egin{ver|batim}..|
|00003850| 40 24 40 3c 50 75 74 20 | 6f 75 74 20 74 68 65 20 |@$@<Put |out the |
|00003860| 63 61 74 40 3e 40 7b 0d | 0a 4f 70 65 6e 20 74 68 |cat@>@{.|.Open th|
|00003870| 65 20 64 6f 6f 72 0d 0a | 53 61 79 20 6f 75 74 0d |e door..|Say out.|
|00003880| 0a 43 6c 6f 73 65 20 74 | 68 65 20 64 6f 6f 72 40 |.Close t|he door@|
|00003890| 7d 0d 0a 5c 65 6e 64 7b | 76 65 72 62 61 74 69 6d |}..\end{|verbatim|
|000038a0| 7d 0d 0a 0d 0a 4e 65 78 | 74 20 77 65 20 74 75 72 |}....Nex|t we tur|
|000038b0| 6e 20 74 6f 20 70 61 72 | 61 6d 65 74 65 72 69 7a |n to par|ameteriz|
|000038c0| 65 64 20 6d 61 63 72 6f | 0d 0a 64 65 66 69 6e 69 |ed macro|..defini|
|000038d0| 74 69 6f 6e 73 2e 5c 78 | 78 7b 70 61 72 61 6d 65 |tions.\x|x{parame|
|000038e0| 74 65 72 69 7a 65 64 20 | 6d 61 63 72 6f 20 64 65 |terized |macro de|
|000038f0| 66 69 6e 69 74 69 6f 6e | 73 7d 7b 73 79 6e 74 61 |finition|s}{synta|
|00003900| 78 7d 0d 0a 41 20 63 6f | 6e 76 65 6e 74 69 6f 6e |x}..A co|nvention|
|00003910| 61 6c 20 46 75 6e 6e 65 | 6c 57 65 62 20 70 61 72 |al Funne|lWeb par|
|00003920| 61 6d 65 74 65 72 69 7a | 65 64 20 6d 61 63 72 6f |ameteriz|ed macro|
|00003930| 20 64 65 66 69 6e 69 74 | 69 6f 6e 20 6c 6f 6f 6b | definit|ion look|
|00003940| 73 20 6c 69 6b 65 20 74 | 68 69 73 3a 0d 0a 0d 0a |s like t|his:....|
|00003950| 5c 62 65 67 69 6e 7b 76 | 65 72 62 61 74 69 6d 7d |\begin{v|erbatim}|
|00003960| 0d 0a 40 24 40 3c 50 75 | 74 20 6f 75 74 20 74 68 |..@$@<Pu|t out th|
|00003970| 65 20 63 61 74 40 3e 40 | 28 40 33 40 29 3d 3d 40 |e cat@>@|(@3@)==@|
|00003980| 7b 40 2d 0d 0a 4f 70 65 | 6e 20 74 68 65 20 64 6f |{@-..Ope|n the do|
|00003990| 6f 72 0d 0a 53 61 79 20 | 6f 75 74 0d 0a 43 6c 6f |or..Say |out..Clo|
|000039a0| 73 65 20 74 68 65 20 64 | 6f 6f 72 40 7d 0d 0a 5c |se the d|oor@}..\|
|000039b0| 65 6e 64 7b 76 65 72 62 | 61 74 69 6d 7d 0d 0a 0d |end{verb|atim}...|
|000039c0| 0a 77 68 69 63 68 20 69 | 73 20 61 20 62 69 74 20 |.which i|s a bit |
|000039d0| 6d 65 73 73 79 2e 20 54 | 68 65 20 6e 61 74 75 72 |messy. T|he natur|
|000039e0| 61 6c 20 61 6c 74 65 72 | 6e 61 74 69 76 65 20 69 |al alter|native i|
|000039f0| 73 20 65 76 65 6e 20 77 | 6f 72 73 65 3a 0d 0a 0d |s even w|orse:...|
|00003a00| 0a 5c 62 65 67 69 6e 7b | 76 65 72 62 61 74 69 6d |.\begin{|verbatim|
|00003a10| 7d 0d 0a 40 24 40 3c 50 | 75 74 20 6f 75 74 20 74 |}..@$@<P|ut out t|
|00003a20| 68 65 20 63 61 74 40 3e | 40 28 40 31 40 2c 40 32 |he cat@>|@(@1@,@2|
|00003a30| 40 2c 40 33 40 29 3d 3d | 40 7b 40 2d 0d 0a 4f 70 |@,@3@)==|@{@-..Op|
|00003a40| 65 6e 20 74 68 65 20 64 | 6f 6f 72 0d 0a 53 61 79 |en the d|oor..Say|
|00003a50| 20 6f 75 74 0d 0a 43 6c | 6f 73 65 20 74 68 65 20 | out..Cl|ose the |
|00003a60| 64 6f 6f 72 40 7d 0d 0a | 5c 65 6e 64 7b 76 65 72 |door@}..|\end{ver|
|00003a70| 62 61 74 69 6d 7d 0d 0a | 0d 0a 54 68 75 73 2c 20 |batim}..|..Thus, |
|00003a80| 6a 75 73 74 20 73 70 65 | 63 69 66 79 69 6e 67 20 |just spe|cifying |
|00003a90| 74 68 65 20 6e 75 6d 62 | 65 72 20 6f 66 20 70 61 |the numb|er of pa|
|00003aa0| 72 61 6d 65 74 65 72 73 | 20 73 65 65 6d 73 20 73 |rameters| seems s|
|00003ab0| 65 6e 73 69 62 6c 65 2e | 20 48 6f 77 65 76 65 72 |ensible.| However|
|00003ac0| 2c 0d 0a 70 65 72 68 61 | 70 73 20 74 68 65 20 73 |,..perha|ps the s|
|00003ad0| 79 6e 74 61 78 20 63 6f | 75 6c 64 20 62 65 20 74 |yntax co|uld be t|
|00003ae0| 72 69 6d 6d 65 64 20 74 | 6f 0d 0a 0d 0a 5c 62 65 |rimmed t|o....\be|
|00003af0| 67 69 6e 7b 76 65 72 62 | 61 74 69 6d 7d 0d 0a 40 |gin{verb|atim}..@|
|00003b00| 24 40 3c 50 75 74 20 6f | 75 74 20 74 68 65 20 63 |$@<Put o|ut the c|
|00003b10| 61 74 40 3e 40 33 3d 3d | 40 7b 40 2d 0d 0a 4f 70 |at@>@3==|@{@-..Op|
|00003b20| 65 6e 20 74 68 65 20 64 | 6f 6f 72 0d 0a 53 61 79 |en the d|oor..Say|
|00003b30| 20 6f 75 74 0d 0a 43 6c | 6f 73 65 20 74 68 65 20 | out..Cl|ose the |
|00003b40| 64 6f 6f 72 40 7d 0d 0a | 5c 65 6e 64 7b 76 65 72 |door@}..|\end{ver|
|00003b50| 62 61 74 69 6d 7d 0d 0a | 0d 0a 49 20 64 65 63 69 |batim}..|..I deci|
|00003b60| 64 65 64 20 74 6f 20 72 | 65 6a 65 63 74 20 74 68 |ded to r|eject th|
|00003b70| 69 73 20 69 6e 20 66 61 | 76 6f 75 72 20 6f 66 20 |is in fa|vour of |
|00003b80| 74 68 65 20 6f 6c 64 20 | 73 79 6e 74 61 78 2e 0d |the old |syntax..|
|00003b90| 0a 0d 0a 5c 74 68 69 6e | 67 7b 44 65 63 69 73 69 |...\thin|g{Decisi|
|00003ba0| 6f 6e 3a 7d 20 52 65 74 | 61 69 6e 20 74 68 65 20 |on:} Ret|ain the |
|00003bb0| 6f 6c 64 20 73 79 6e 74 | 61 78 20 6f 66 20 24 5c |old synt|ax of $\|
|00003bc0| 6c 64 6f 74 73 24 5c 70 | 7b 40 28 40 33 40 29 7d |ldots$\p|{@(@3@)}|
|00003bd0| 24 5c 6c 64 6f 74 73 24 | 0d 0a 0d 0a 5c 73 75 62 |$\ldots$|....\sub|
|00003be0| 73 65 63 74 69 6f 6e 7b | 52 65 76 69 65 77 20 6f |section{|Review o|
|00003bf0| 66 20 4d 61 63 72 6f 20 | 43 61 6c 6c 20 53 79 6e |f Macro |Call Syn|
|00003c00| 74 61 78 7d 0d 0a 5c 78 | 78 7b 6d 61 63 72 6f 20 |tax}..\x|x{macro |
|00003c10| 63 61 6c 6c 7d 7b 73 79 | 6e 74 61 78 7d 0d 0a 0d |call}{sy|ntax}...|
|00003c20| 0a 48 65 72 65 20 61 72 | 65 20 73 6f 6d 65 20 69 |.Here ar|e some i|
|00003c30| 64 65 61 73 20 66 6f 72 | 20 61 6c 74 65 72 6e 61 |deas for| alterna|
|00003c40| 74 69 76 65 73 20 74 6f | 20 74 68 65 20 46 75 6e |tives to| the Fun|
|00003c50| 6e 65 6c 57 65 62 7e 56 | 31 20 6d 61 63 72 6f 20 |nelWeb~V|1 macro |
|00003c60| 63 61 6c 6c 20 73 79 6e | 74 61 78 2e 0d 0a 0d 0a |call syn|tax.....|
|00003c70| 5c 62 65 67 69 6e 7b 76 | 65 72 62 61 74 69 6d 7d |\begin{v|erbatim}|
|00003c80| 0d 0a 4f 70 65 6e 20 74 | 68 65 20 64 6f 6f 72 0d |..Open t|he door.|
|00003c90| 0a 40 3c 53 61 79 20 4f | 75 74 40 3e 20 20 20 20 |.@<Say O|ut@> |
|00003ca0| 20 20 20 20 20 40 21 20 | 46 75 6e 6e 65 6c 57 65 | @! |FunnelWe|
|00003cb0| 62 7e 56 31 20 73 74 79 | 6c 65 2e 0d 0a 43 6c 6f |b~V1 sty|le...Clo|
|00003cc0| 73 65 20 74 68 65 20 64 | 6f 6f 72 0d 0a 0d 0a 4f |se the d|oor....O|
|00003cd0| 70 65 6e 20 74 68 65 20 | 64 6f 6f 72 0d 0a 40 3c |pen the |door..@<|
|00003ce0| 53 61 79 20 6f 75 74 3e | 40 0d 0a 43 6c 6f 73 65 |Say out>|@..Close|
|00003cf0| 20 74 68 65 20 64 6f 6f | 72 0d 0a 0d 0a 4f 70 65 | the doo|r....Ope|
|00003d00| 6e 20 74 68 65 20 64 6f | 6f 72 0d 0a 40 22 53 61 |n the do|or..@"Sa|
|00003d10| 79 20 6f 75 74 40 22 0d | 0a 43 6c 6f 73 65 20 74 |y out@".|.Close t|
|00003d20| 68 65 20 64 6f 6f 72 0d | 0a 0d 0a 4f 70 65 6e 20 |he door.|...Open |
|00003d30| 74 68 65 20 64 6f 6f 72 | 0d 0a 40 28 53 61 79 20 |the door|..@(Say |
|00003d40| 6f 75 74 40 29 0d 0a 43 | 6c 6f 73 65 20 74 68 65 |out@)..C|lose the|
|00003d50| 20 64 6f 6f 72 0d 0a 0d | 0a 4f 70 65 6e 20 74 68 | door...|.Open th|
|00003d60| 65 20 64 6f 6f 72 0d 0a | 40 3c 53 61 79 20 6f 75 |e door..|@<Say ou|
|00003d70| 74 3e 0d 0a 43 6c 6f 73 | 65 20 74 68 65 20 64 6f |t>..Clos|e the do|
|00003d80| 6f 72 0d 0a 5c 65 6e 64 | 7b 76 65 72 62 61 74 69 |or..\end|{verbati|
|00003d90| 6d 7d 0d 0a 0d 0a 5c 74 | 68 69 6e 67 7b 44 65 63 |m}....\t|hing{Dec|
|00003da0| 69 73 69 6f 6e 3a 7d 20 | 43 6f 6e 74 69 6e 75 65 |ision:} |Continue|
|00003db0| 20 77 69 74 68 20 74 68 | 65 20 6f 6c 64 20 6e 6f | with th|e old no|
|00003dc0| 74 61 74 69 6f 6e 2e 20 | 49 74 20 6d 61 79 20 6e |tation. |It may n|
|00003dd0| 6f 74 20 62 65 20 6e 65 | 61 74 2c 20 62 75 74 20 |ot be ne|at, but |
|00003de0| 61 74 0d 0a 6c 65 61 73 | 74 20 69 74 20 69 73 20 |at..leas|t it is |
|00003df0| 63 6c 65 61 72 20 61 6e | 64 20 63 6f 6e 73 69 73 |clear an|d consis|
|00003e00| 74 65 6e 74 2e 20 54 68 | 65 20 6d 61 69 6e 20 74 |tent. Th|e main t|
|00003e10| 65 6d 70 74 61 74 69 6f | 6e 20 69 73 20 74 68 65 |emptatio|n is the|
|00003e20| 20 66 6f 72 6d 61 74 0d | 0a 5c 70 7b 40 3c 73 61 | format.|.\p{@<sa|
|00003e30| 79 20 6f 75 74 3e 40 7d | 0d 0a 77 68 69 63 68 20 |y out>@}|..which |
|00003e40| 6c 6f 6f 6b 73 20 72 61 | 74 68 65 72 20 67 6f 6f |looks ra|ther goo|
|00003e50| 64 2e 20 48 6f 77 65 76 | 65 72 2c 20 69 74 20 62 |d. Howev|er, it b|
|00003e60| 72 65 61 6b 73 20 74 68 | 65 20 73 70 65 63 69 61 |reaks th|e specia|
|00003e70| 6c 20 73 65 71 75 65 6e | 63 65 0d 0a 72 61 74 69 |l sequen|ce..rati|
|00003e80| 6f 6e 61 6c 20 61 6e 64 | 20 68 65 6e 63 65 20 69 |onal and| hence i|
|00003e90| 73 20 74 6f 6f 20 63 6f | 6e 66 75 73 69 6e 67 2e |s too co|nfusing.|
|00003ea0| 0d 0a 0d 0a 5c 73 75 62 | 73 65 63 74 69 6f 6e 7b |....\sub|section{|
|00003eb0| 52 65 76 69 65 77 20 6f | 66 20 50 61 72 61 6d 65 |Review o|f Parame|
|00003ec0| 74 65 72 69 7a 65 64 20 | 4d 61 63 72 6f 20 43 61 |terized |Macro Ca|
|00003ed0| 6c 6c 20 53 79 6e 74 61 | 78 7d 0d 0a 5c 78 78 7b |ll Synta|x}..\xx{|
|00003ee0| 70 61 72 61 6d 65 74 65 | 72 69 7a 65 64 20 6d 61 |paramete|rized ma|
|00003ef0| 63 72 6f 20 63 61 6c 6c | 7d 7b 73 79 6e 74 61 78 |cro call|}{syntax|
|00003f00| 7d 0d 0a 0d 0a 46 75 6e | 6e 65 6c 57 65 62 7e 56 |}....Fun|nelWeb~V|
|00003f10| 31 20 70 72 6f 76 69 64 | 65 64 20 61 20 6d 65 73 |1 provid|ed a mes|
|00003f20| 73 79 20 70 61 72 61 6d | 65 74 65 72 69 7a 65 64 |sy param|eterized|
|00003f30| 20 6d 61 63 72 6f 20 63 | 61 6c 6c 20 73 79 6e 74 | macro c|all synt|
|00003f40| 61 78 3a 0d 0a 0d 0a 5c | 62 65 67 69 6e 7b 76 65 |ax:....\|begin{ve|
|00003f50| 72 62 61 74 69 6d 7d 0d | 0a 40 3c 53 61 79 20 4f |rbatim}.|.@<Say O|
|00003f60| 75 74 40 3e 40 28 40 22 | 66 69 72 73 74 70 61 72 |ut@>@(@"|firstpar|
|00003f70| 61 6d 40 22 20 40 2c 20 | 40 22 53 65 63 6f 6e 64 |am@" @, |@"Second|
|00003f80| 70 61 72 61 6d 40 22 20 | 40 2c 20 40 22 74 68 69 |param@" |@, @"thi|
|00003f90| 72 64 70 61 72 61 6d 40 | 22 20 40 29 0d 0a 5c 65 |rdparam@|" @)..\e|
|00003fa0| 6e 64 7b 76 65 72 62 61 | 74 69 6d 7d 0d 0a 0d 0a |nd{verba|tim}....|
|00003fb0| 54 68 69 73 20 73 79 6e | 74 61 78 20 63 61 6e 20 |This syn|tax can |
|00003fc0| 62 65 20 63 6c 65 61 6e | 65 64 20 75 70 20 63 6f |be clean|ed up co|
|00003fd0| 6e 73 69 64 65 72 61 62 | 6c 79 20 62 79 20 6d 61 |nsiderab|ly by ma|
|00003fe0| 6b 69 6e 67 20 74 68 65 | 20 5c 70 7b 40 22 7d 20 |king the| \p{@"} |
|00003ff0| 73 79 6d 62 6f 6c 73 0d | 0a 6f 70 74 69 6f 6e 61 |symbols.|.optiona|
|00004000| 6c 2e 20 54 68 69 73 20 | 72 65 73 75 6c 74 73 20 |l. This |results |
|00004010| 69 6e 20 63 61 6c 6c 73 | 20 73 75 63 68 20 61 73 |in calls| such as|
|00004020| 20 74 68 65 20 66 6f 6c | 6c 6f 77 69 6e 67 3a 0d | the fol|lowing:.|
|00004030| 0a 0d 0a 5c 62 65 67 69 | 6e 7b 76 65 72 62 61 74 |...\begi|n{verbat|
|00004040| 69 6d 7d 0d 0a 40 3c 53 | 61 79 20 4f 75 74 40 3e |im}..@<S|ay Out@>|
|00004050| 40 28 66 69 72 73 74 70 | 61 72 61 6d 40 2c 53 65 |@(firstp|aram@,Se|
|00004060| 63 6f 6e 64 70 61 72 61 | 6d 40 2c 74 68 69 72 64 |condpara|m@,third|
|00004070| 70 61 72 61 6d 40 29 0d | 0a 5c 65 6e 64 7b 76 65 |param@).|.\end{ve|
|00004080| 72 62 61 74 69 6d 7d 0d | 0a 0d 0a 41 73 20 74 68 |rbatim}.|...As th|
|00004090| 65 20 66 69 72 73 74 20 | 66 6f 72 6d 20 61 6c 6c |e first |form all|
|000040a0| 6f 77 73 20 74 68 65 20 | 61 6c 69 67 6e 6d 65 6e |ows the |alignmen|
|000040b0| 74 20 6f 66 20 63 6f 6d | 70 6c 69 63 61 74 65 64 |t of com|plicated|
|000040c0| 20 70 61 72 61 6d 65 74 | 65 72 73 20 62 79 0d 0a | paramet|ers by..|
|000040d0| 61 6c 6c 6f 77 69 6e 67 | 20 77 68 69 74 65 20 73 |allowing| white s|
|000040e0| 70 61 63 65 20 74 6f 20 | 62 65 20 69 6e 73 65 72 |pace to |be inser|
|000040f0| 74 65 64 20 6f 75 74 73 | 69 64 65 20 74 68 65 20 |ted outs|ide the |
|00004100| 5c 70 7b 40 22 7d 2c 20 | 61 6e 64 20 74 68 65 20 |\p{@"}, |and the |
|00004110| 73 65 63 6f 6e 64 0d 0a | 66 6f 72 6d 20 69 73 20 |second..|form is |
|00004120| 63 6c 65 61 6e 65 72 2c | 20 62 6f 74 68 20 61 72 |cleaner,| both ar|
|00004130| 65 20 72 65 74 61 69 6e | 65 64 20 73 69 6d 70 6c |e retain|ed simpl|
|00004140| 79 20 62 79 20 6d 61 6b | 69 6e 67 20 74 68 65 20 |y by mak|ing the |
|00004150| 71 75 6f 74 65 73 20 6f | 70 74 69 6f 6e 61 6c 2e |quotes o|ptional.|
|00004160| 0d 0a 0d 0a 5c 74 68 69 | 6e 67 7b 44 65 63 69 73 |....\thi|ng{Decis|
|00004170| 69 6f 6e 3a 7d 20 4d 61 | 6b 65 20 74 68 65 20 64 |ion:} Ma|ke the d|
|00004180| 6f 75 62 6c 65 20 71 75 | 6f 74 65 73 20 6f 70 74 |ouble qu|otes opt|
|00004190| 69 6f 6e 61 6c 2e 0d 0a | 0d 0a 5c 73 65 63 74 69 |ional...|..\secti|
|000041a0| 6f 6e 7b 44 6f 63 75 6d | 65 6e 74 20 53 74 72 75 |on{Docum|ent Stru|
|000041b0| 63 74 75 72 69 6e 67 7d | 0d 0a 5c 78 78 7b 64 6f |cturing}|..\xx{do|
|000041c0| 63 75 6d 65 6e 74 7d 7b | 73 74 72 75 63 74 75 72 |cument}{|structur|
|000041d0| 65 7d 5c 78 7b 68 65 61 | 64 69 6e 67 73 7d 5c 78 |e}\x{hea|dings}\x|
|000041e0| 7b 73 65 63 74 69 6f 6e | 73 7d 0d 0a 0d 0a 45 78 |{section|s}....Ex|
|000041f0| 70 65 72 69 65 6e 63 65 | 20 77 69 74 68 20 46 75 |perience| with Fu|
|00004200| 6e 6e 65 6c 57 65 62 7e | 56 31 2c 20 77 68 69 63 |nnelWeb~|V1, whic|
|00004210| 68 20 70 72 6f 76 69 64 | 65 64 20 6f 6e 6c 79 20 |h provid|ed only |
|00004220| 74 77 6f 20 6c 65 76 65 | 6c 73 20 6f 66 0d 0a 68 |two leve|ls of..h|
|00004230| 65 61 64 69 6e 67 73 20 | 28 6d 61 6a 6f 72 20 61 |eadings |(major a|
|00004240| 6e 64 20 6d 69 6e 6f 72 | 29 0d 0a 70 72 6f 76 65 |nd minor|)..prove|
|00004250| 64 20 74 68 61 74 20 74 | 68 65 72 65 20 77 61 73 |d that t|here was|
|00004260| 20 61 20 73 74 72 6f 6e | 67 20 6e 65 65 64 20 66 | a stron|g need f|
|00004270| 6f 72 20 66 75 6c 6c 79 | 20 68 69 65 72 61 72 63 |or fully| hierarc|
|00004280| 68 69 63 61 6c 0d 0a 6d | 75 6c 74 69 70 6c 65 2d |hical..m|ultiple-|
|00004290| 6c 65 76 65 6c 20 68 65 | 61 64 69 6e 67 73 2e 0d |level he|adings..|
|000042a0| 0a 54 68 65 20 6f 6e 6c | 79 20 71 75 65 73 74 69 |.The onl|y questi|
|000042b0| 6f 6e 20 77 61 73 20 68 | 6f 77 20 69 74 20 73 68 |on was h|ow it sh|
|000042c0| 6f 75 6c 64 20 62 65 20 | 64 6f 6e 65 2e 0d 0a 0d |ould be |done....|
|000042d0| 0a 48 65 72 65 20 61 72 | 65 20 73 6f 6d 65 20 69 |.Here ar|e some i|
|000042e0| 64 65 61 73 20 74 68 61 | 74 20 77 65 72 65 20 63 |deas tha|t were c|
|000042f0| 6f 6e 73 69 64 65 72 65 | 64 2e 0d 0a 0d 0a 5c 62 |onsidere|d.....\b|
|00004300| 65 67 69 6e 7b 76 65 72 | 62 61 74 69 6d 7d 0d 0a |egin{ver|batim}..|
|00004310| 40 2a 40 3c 4d 61 69 6e | 20 50 72 6f 67 72 61 6d |@*@<Main| Program|
|00004320| 40 3e 0d 0a 40 2a 2a 40 | 3c 52 65 61 64 20 74 68 |@>..@**@|<Read th|
|00004330| 65 20 4d 65 73 73 61 67 | 65 40 3e 0d 0a 40 2a 2a |e Messag|e@>..@**|
|00004340| 2a 40 3c 45 6e 63 72 79 | 70 74 20 74 68 65 20 42 |*@<Encry|pt the B|
|00004350| 75 66 66 65 72 40 3e 0d | 0a 0d 0a 40 2a 40 3c 4d |uffer@>.|...@*@<M|
|00004360| 61 69 6e 20 50 72 6f 67 | 72 61 6d 40 3e 0d 0a 40 |ain Prog|ram@>..@|
|00004370| 2a 40 2a 40 3c 52 65 61 | 64 20 74 68 65 20 4d 65 |*@*@<Rea|d the Me|
|00004380| 73 73 61 67 65 40 3e 0d | 0a 40 2a 40 2a 40 2a 40 |ssage@>.|.@*@*@*@|
|00004390| 3c 45 6e 63 72 79 70 74 | 20 74 68 65 20 42 75 66 |<Encrypt| the Buf|
|000043a0| 66 65 72 40 3e 0d 0a 0d | 0a 40 73 40 3c 4d 61 69 |fer@>...|.@s@<Mai|
|000043b0| 6e 20 50 72 6f 67 72 61 | 6d 40 3e 0d 0a 40 73 73 |n Progra|m@>..@ss|
|000043c0| 40 3c 52 65 61 64 20 74 | 68 65 20 4d 65 73 73 61 |@<Read t|he Messa|
|000043d0| 67 65 40 3e 0d 0a 40 73 | 73 73 40 3c 45 6e 63 72 |ge@>..@s|ss@<Encr|
|000043e0| 79 70 74 20 74 68 65 20 | 42 75 66 66 65 72 40 3e |ypt the |Buffer@>|
|000043f0| 0d 0a 0d 0a 40 73 40 3c | 4d 61 69 6e 20 50 72 6f |....@s@<|Main Pro|
|00004400| 67 72 61 6d 40 3e 0d 0a | 40 73 40 73 40 3c 52 65 |gram@>..|@s@s@<Re|
|00004410| 61 64 20 74 68 65 20 4d | 65 73 73 61 67 65 40 3e |ad the M|essage@>|
|00004420| 0d 0a 40 73 40 73 40 73 | 40 3c 45 6e 63 72 79 70 |..@s@s@s|@<Encryp|
|00004430| 74 20 74 68 65 20 42 75 | 66 66 65 72 40 3e 0d 0a |t the Bu|ffer@>..|
|00004440| 0d 0a 40 53 40 3c 4d 61 | 69 6e 20 50 72 6f 67 72 |..@S@<Ma|in Progr|
|00004450| 61 6d 40 3e 0d 0a 40 53 | 53 40 3c 52 65 61 64 20 |am@>..@S|S@<Read |
|00004460| 74 68 65 20 4d 65 73 73 | 61 67 65 40 3e 0d 0a 40 |the Mess|age@>..@|
|00004470| 53 53 53 40 3c 45 6e 63 | 72 79 70 74 20 74 68 65 |SSS@<Enc|rypt the|
|00004480| 20 42 75 66 66 65 72 40 | 3e 0d 0a 0d 0a 40 53 40 | Buffer@|>....@S@|
|00004490| 3c 4d 61 69 6e 20 50 72 | 6f 67 72 61 6d 40 3e 0d |<Main Pr|ogram@>.|
|000044a0| 0a 40 53 40 53 40 3c 52 | 65 61 64 20 74 68 65 20 |.@S@S@<R|ead the |
|000044b0| 4d 65 73 73 61 67 65 40 | 3e 0d 0a 40 53 40 53 40 |Message@|>..@S@S@|
|000044c0| 53 40 3c 45 6e 63 72 79 | 70 74 20 74 68 65 20 42 |S@<Encry|pt the B|
|000044d0| 75 66 66 65 72 40 3e 0d | 0a 0d 0a 40 41 40 3c 4d |uffer@>.|...@A@<M|
|000044e0| 61 69 6e 20 50 72 6f 67 | 72 61 6d 40 3e 20 20 20 |ain Prog|ram@> |
|000044f0| 20 20 20 20 20 20 20 20 | 2d 2d 20 54 68 65 20 73 | |-- The s|
|00004500| 79 6e 74 61 78 20 66 69 | 6e 61 6c 6c 79 20 63 68 |yntax fi|nally ch|
|00004510| 6f 73 65 6e 2e 0d 0a 40 | 42 40 3c 52 65 61 64 20 |osen...@|B@<Read |
|00004520| 74 68 65 20 4d 65 73 73 | 61 67 65 40 3e 0d 0a 40 |the Mess|age@>..@|
|00004530| 43 40 3c 45 6e 63 72 79 | 70 74 20 74 68 65 20 42 |C@<Encry|pt the B|
|00004540| 75 66 66 65 72 40 3e 0d | 0a 0d 0a 40 41 20 4d 61 |uffer@>.|...@A Ma|
|00004550| 69 6e 20 50 72 6f 67 72 | 61 6d 0d 0a 40 42 20 52 |in Progr|am..@B R|
|00004560| 65 61 64 20 74 68 65 20 | 4d 65 73 73 61 67 65 0d |ead the |Message.|
|00004570| 0a 40 43 20 45 6e 63 72 | 79 70 74 20 74 68 65 20 |.@C Encr|ypt the |
|00004580| 42 75 66 66 65 72 0d 0a | 0d 0a 40 2a 41 20 4d 61 |Buffer..|..@*A Ma|
|00004590| 69 6e 20 50 72 6f 67 72 | 61 6d 0d 0a 40 2a 42 20 |in Progr|am..@*B |
|000045a0| 52 65 61 64 20 74 68 65 | 20 4d 65 73 73 61 67 65 |Read the| Message|
|000045b0| 0d 0a 40 2a 43 20 45 6e | 63 72 79 70 74 20 74 68 |..@*C En|crypt th|
|000045c0| 65 20 42 75 66 66 65 72 | 0d 0a 0d 0a 40 31 40 3c |e Buffer|....@1@<|
|000045d0| 4d 61 69 6e 20 50 72 6f | 67 72 61 6d 40 3e 0d 0a |Main Pro|gram@>..|
|000045e0| 40 32 40 3c 52 65 61 64 | 20 74 68 65 20 4d 65 73 |@2@<Read| the Mes|
|000045f0| 73 61 67 65 40 3e 0d 0a | 40 33 40 3c 45 6e 63 72 |sage@>..|@3@<Encr|
|00004600| 79 70 74 20 74 68 65 20 | 42 75 66 66 65 72 40 3e |ypt the |Buffer@>|
|00004610| 0d 0a 28 75 73 69 6e 67 | 20 40 41 2e 2e 40 49 40 |..(using| @A..@I@|
|00004620| 20 61 73 20 6d 61 63 72 | 6f 20 70 61 72 61 6d 65 | as macr|o parame|
|00004630| 74 65 72 73 20 6f 72 20 | 6f 76 65 72 6c 6f 61 64 |ters or |overload|
|00004640| 20 40 31 2e 2e 40 39 29 | 0d 0a 0d 0a 40 2a 40 31 | @1..@9)|....@*@1|
|00004650| 40 3c 4d 61 69 6e 20 50 | 72 6f 67 72 61 6d 40 3e |@<Main P|rogram@>|
|00004660| 0d 0a 40 2a 40 32 40 3c | 52 65 61 64 20 74 68 65 |..@*@2@<|Read the|
|00004670| 20 4d 65 73 73 61 67 65 | 40 3e 0d 0a 40 2a 40 33 | Message|@>..@*@3|
|00004680| 40 3c 45 6e 63 72 79 70 | 74 20 74 68 65 20 42 75 |@<Encryp|t the Bu|
|00004690| 66 66 65 72 40 3e 0d 0a | 28 75 73 69 6e 67 20 40 |ffer@>..|(using @|
|000046a0| 41 2e 2e 40 49 40 20 61 | 73 20 6d 61 63 72 6f 20 |A..@I@ a|s macro |
|000046b0| 70 61 72 61 6d 65 74 65 | 72 73 20 6f 72 20 6f 76 |paramete|rs or ov|
|000046c0| 65 72 6c 6f 61 64 20 40 | 31 2e 2e 40 39 29 0d 0a |erload @|1..@9)..|
|000046d0| 5c 65 6e 64 7b 76 65 72 | 62 61 74 69 6d 7d 0d 0a |\end{ver|batim}..|
|000046e0| 0d 0a 43 68 6f 6f 73 69 | 6e 67 20 62 65 74 77 65 |..Choosi|ng betwe|
|000046f0| 65 6e 20 74 68 65 73 65 | 20 61 6c 74 65 72 6e 61 |en these| alterna|
|00004700| 74 69 76 65 73 20 77 61 | 73 20 6e 6f 74 20 65 61 |tives wa|s not ea|
|00004710| 73 79 2e 20 54 68 65 20 | 66 6f 6c 6c 6f 77 69 6e |sy. The |followin|
|00004720| 67 20 74 68 6f 75 67 68 | 74 73 0d 0a 63 6f 6e 74 |g though|ts..cont|
|00004730| 72 69 62 75 74 65 64 20 | 74 6f 20 74 68 65 20 64 |ributed |to the d|
|00004740| 65 63 69 73 69 6f 6e 2e | 0d 0a 0d 0a 5c 62 65 67 |ecision.|....\beg|
|00004750| 69 6e 7b 69 74 65 6d 69 | 7a 65 7d 0d 0a 0d 0a 5c |in{itemi|ze}....\|
|00004760| 69 74 65 6d 20 53 79 6e | 74 61 78 65 73 20 74 68 |item Syn|taxes th|
|00004770| 61 74 20 72 65 71 75 69 | 72 65 20 76 69 73 75 61 |at requi|re visua|
|00004780| 6c 20 63 6f 75 6e 74 69 | 6e 67 20 61 72 65 20 70 |l counti|ng are p|
|00004790| 72 6f 62 61 62 6c 79 20 | 6e 6f 74 20 61 20 67 6f |robably |not a go|
|000047a0| 6f 64 20 69 64 65 61 2e | 0d 0a 0d 0a 5c 69 74 65 |od idea.|....\ite|
|000047b0| 6d 20 53 79 6e 74 61 78 | 65 73 20 74 68 61 74 20 |m Syntax|es that |
|000047c0| 64 6f 20 6e 6f 74 20 64 | 65 6c 69 6d 69 74 20 74 |do not d|elimit t|
|000047d0| 68 65 20 68 65 61 64 69 | 6e 67 20 6e 61 6d 65 20 |he headi|ng name |
|000047e0| 73 6f 6d 65 68 6f 77 20 | 61 72 65 20 6c 69 6b 65 |somehow |are like|
|000047f0| 6c 79 0d 0a 74 6f 20 63 | 61 75 73 65 20 70 72 6f |ly..to c|ause pro|
|00004800| 62 6c 65 6d 73 20 77 68 | 65 72 65 20 68 65 61 64 |blems wh|ere head|
|00004810| 69 6e 67 20 6e 61 6d 65 | 73 20 61 72 65 20 6f 6d |ing name|s are om|
|00004820| 69 74 74 65 64 2e 20 55 | 73 65 72 73 20 77 69 6c |itted. U|sers wil|
|00004830| 6c 20 62 65 0d 0a 74 65 | 6d 70 74 65 64 20 74 6f |l be..te|mpted to|
|00004840| 20 73 74 61 72 74 20 70 | 61 72 61 67 72 61 70 68 | start p|aragraph|
|00004850| 73 20 61 66 74 65 72 20 | 74 68 65 20 73 74 61 72 |s after |the star|
|00004860| 74 20 6f 66 20 68 65 61 | 64 69 6e 67 20 73 79 6d |t of hea|ding sym|
|00004870| 62 6f 6c 20 61 6e 64 20 | 74 68 65 0d 0a 72 65 73 |bol and |the..res|
|00004880| 75 6c 74 20 69 73 20 74 | 68 61 74 20 74 68 65 20 |ult is t|hat the |
|00004890| 66 69 72 73 74 20 6c 69 | 6e 65 20 6f 66 20 74 68 |first li|ne of th|
|000048a0| 65 20 70 61 72 61 67 72 | 61 70 68 20 77 69 6c 6c |e paragr|aph will|
|000048b0| 20 62 65 20 73 75 63 6b | 65 64 20 69 6e 74 6f 20 | be suck|ed into |
|000048c0| 74 68 65 0d 0a 68 65 61 | 64 69 6e 67 2e 0d 0a 0d |the..hea|ding....|
|000048d0| 0a 5c 69 74 65 6d 20 4f | 76 65 72 6c 6f 61 64 69 |.\item O|verloadi|
|000048e0| 6e 67 20 74 68 65 20 5c | 70 7b 40 31 7d 2c 20 24 |ng the \|p{@1}, $|
|000048f0| 5c 6c 64 6f 74 73 24 2c | 20 5c 70 7b 40 39 7d 20 |\ldots$,| \p{@9} |
|00004900| 73 65 71 75 65 6e 63 65 | 73 20 69 73 20 75 6e 64 |sequence|s is und|
|00004910| 65 73 69 72 61 62 6c 65 | 2e 0d 0a 0d 0a 0d 0a 5c |esirable|.......\|
|00004920| 65 6e 64 7b 69 74 65 6d | 69 7a 65 7d 0d 0a 0d 0a |end{item|ize}....|
|00004930| 5c 74 68 69 6e 67 7b 44 | 65 63 69 73 69 6f 6e 3a |\thing{D|ecision:|
|00004940| 7d 20 55 73 65 20 5c 70 | 7b 40 41 7d 24 5c 6c 64 |} Use \p|{@A}$\ld|
|00004950| 6f 74 73 24 5c 70 7b 40 | 45 7d 20 77 69 74 68 20 |ots$\p{@|E} with |
|00004960| 6f 70 74 69 6f 6e 61 6c | 20 66 6f 6c 6c 6f 77 69 |optional| followi|
|00004970| 6e 67 0d 0a 6d 61 63 72 | 6f 20 6e 61 6d 65 20 73 |ng..macr|o name s|
|00004980| 79 6e 74 61 78 20 66 6f | 72 20 74 68 65 20 73 65 |yntax fo|r the se|
|00004990| 63 74 69 6f 6e 20 6e 61 | 6d 65 2e 0d 0a 4e 6f 74 |ction na|me...Not|
|000049a0| 65 3a 20 57 65 20 73 74 | 6f 70 20 61 74 20 5c 70 |e: We st|op at \p|
|000049b0| 7b 40 45 7d 20 62 65 63 | 61 75 73 65 20 66 69 76 |{@E} bec|ause fiv|
|000049c0| 65 20 6c 65 76 65 6c 73 | 20 69 73 20 70 72 6f 62 |e levels| is prob|
|000049d0| 61 62 6c 79 20 73 75 66 | 66 69 63 69 65 6e 74 2c |ably suf|ficient,|
|000049e0| 20 61 6e 64 20 77 65 0d | 0a 6d 61 79 20 77 69 73 | and we.|.may wis|
|000049f0| 68 20 6c 61 74 65 72 20 | 74 6f 20 75 73 65 20 5c |h later |to use \|
|00004a00| 70 7b 40 46 7d 20 66 6f | 72 20 5c 62 7b 46 7d 69 |p{@F} fo|r \b{F}i|
|00004a10| 6c 65 20 28 74 6f 20 61 | 75 67 6d 65 6e 74 20 6f |le (to a|ugment o|
|00004a20| 72 20 72 65 70 6c 61 63 | 65 20 5c 70 7b 40 4f 7d |r replac|e \p{@O}|
|00004a30| 29 2e 0d 0a 0d 0a 0d 0a | 5c 73 65 63 74 69 6f 6e |).......|\section|
|00004a40| 7b 44 69 73 63 75 73 73 | 69 6f 6e 20 6f 66 20 53 |{Discuss|ion of S|
|00004a50| 6f 6d 65 20 4d 69 73 63 | 65 6c 6c 61 6e 65 6f 75 |ome Misc|ellaneou|
|00004a60| 73 20 49 73 73 75 65 73 | 7d 0d 0a 5c 78 78 7b 6d |s Issues|}..\xx{m|
|00004a70| 69 73 63 65 6c 6c 61 6e | 65 6f 75 73 7d 7b 69 73 |iscellan|eous}{is|
|00004a80| 73 75 65 73 7d 0d 0a 0d | 0a 5c 74 68 69 6e 67 7b |sues}...|.\thing{|
|00004a90| 43 6f 6d 6d 65 6e 74 20 | 64 75 70 6c 69 63 61 74 |Comment |duplicat|
|00004aa0| 69 6f 6e 3a 7d 20 49 66 | 5c 78 78 7b 63 6f 6d 6d |ion:} If|\xx{comm|
|00004ab0| 65 6e 74 7d 7b 64 75 70 | 6c 69 63 61 74 69 6f 6e |ent}{dup|lication|
|00004ac0| 7d 0d 0a 74 68 65 20 46 | 75 6e 6e 65 6c 57 65 62 |}..the F|unnelWeb|
|00004ad0| 20 75 73 65 72 20 69 6e | 73 65 72 74 73 0d 0a 63 | user in|serts..c|
|00004ae0| 6f 6d 6d 65 6e 74 73 20 | 69 6e 74 6f 20 74 68 65 |omments |into the|
|00004af0| 20 74 61 72 67 65 74 20 | 63 6f 64 65 20 28 69 6e | target |code (in|
|00004b00| 20 74 68 65 20 5c 70 7b | 2e 66 77 7d 20 66 69 6c | the \p{|.fw} fil|
|00004b10| 65 29 20 61 73 20 77 65 | 6c 6c 20 61 73 20 69 6e |e) as we|ll as in|
|00004b20| 74 6f 20 74 68 65 0d 0a | 64 6f 63 75 6d 65 6e 74 |to the..|document|
|00004b30| 61 74 69 6f 6e 20 28 66 | 72 65 65 20 74 65 78 74 |ation (f|ree text|
|00004b40| 29 0d 0a 70 61 72 74 20 | 6f 66 20 74 68 65 20 5c |)..part |of the \|
|00004b50| 70 7b 2e 66 77 7d 20 66 | 69 6c 65 2c 20 74 68 65 |p{.fw} f|ile, the|
|00004b60| 6e 20 69 74 20 69 73 20 | 70 6f 73 73 69 62 6c 65 |n it is |possible|
|00004b70| 20 66 6f 72 20 74 68 65 | 0d 0a 73 69 74 75 61 74 | for the|..situat|
|00004b80| 69 6f 6e 20 74 6f 20 67 | 65 74 20 61 20 62 69 74 |ion to g|et a bit|
|00004b90| 20 73 69 6c 6c 79 2e 20 | 5c 62 7b 44 65 63 69 73 | silly. |\b{Decis|
|00004ba0| 69 6f 6e 3a 7d 20 54 68 | 69 73 20 69 73 20 61 20 |ion:} Th|is is a |
|00004bb0| 70 72 6f 62 6c 65 6d 20 | 66 6f 72 20 74 68 65 0d |problem |for the.|
|00004bc0| 0a 70 72 6f 67 72 61 6d | 6d 65 72 2c 20 6e 6f 74 |.program|mer, not|
|00004bd0| 20 66 6f 72 20 46 75 6e | 6e 65 6c 57 65 62 2e 0d | for Fun|nelWeb..|
|00004be0| 0a 0d 0a 5c 74 68 69 6e | 67 7b 4f 75 74 2d 6f 66 |...\thin|g{Out-of|
|00004bf0| 2d 64 61 74 65 20 64 6f | 63 75 6d 65 6e 74 61 74 |-date do|cumentat|
|00004c00| 69 6f 6e 3a 7d 20 53 6f | 6d 65 74 69 6d 65 73 5c |ion:} So|metimes\|
|00004c10| 78 78 7b 6f 75 74 20 6f | 66 20 64 61 74 65 7d 7b |xx{out o|f date}{|
|00004c20| 64 6f 63 75 6d 65 6e 74 | 61 74 69 6f 6e 7d 0d 0a |document|ation}..|
|00004c30| 69 74 20 69 73 20 61 6c | 6c 20 74 6f 6f 20 65 61 |it is al|l too ea|
|00004c40| 73 79 20 66 6f 72 20 74 | 68 65 0d 0a 70 72 6f 67 |sy for t|he..prog|
|00004c50| 72 61 6d 6d 65 72 20 74 | 6f 20 6d 6f 64 69 66 79 |rammer t|o modify|
|00004c60| 20 74 68 65 20 63 6f 64 | 65 20 77 69 74 68 6f 75 | the cod|e withou|
|00004c70| 74 20 75 70 64 61 74 69 | 6e 67 20 74 68 65 20 73 |t updati|ng the s|
|00004c80| 75 72 72 6f 75 6e 64 69 | 6e 67 20 64 6f 63 75 6d |urroundi|ng docum|
|00004c90| 65 6e 74 61 74 69 6f 6e | 2e 0d 0a 5c 62 7b 44 65 |entation|...\b{De|
|00004ca0| 63 69 73 69 6f 6e 3a 7d | 20 54 68 69 73 20 69 73 |cision:}| This is|
|00004cb0| 20 61 20 73 65 72 69 6f | 75 73 20 61 6e 64 20 6d | a serio|us and m|
|00004cc0| 61 6a 6f 72 20 70 72 6f | 62 6c 65 6d 2e 20 49 6e |ajor pro|blem. In|
|00004cd0| 20 61 6e 20 61 75 74 6f | 6d 61 74 65 64 20 65 6e | an auto|mated en|
|00004ce0| 76 69 72 6f 6e 6d 65 6e | 74 2c 0d 0a 69 74 20 6d |vironmen|t,..it m|
|00004cf0| 61 79 20 62 65 20 70 6f | 73 73 69 62 6c 65 20 74 |ay be po|ssible t|
|00004d00| 6f 20 63 72 65 61 74 65 | 20 61 20 73 79 73 74 65 |o create| a syste|
|00004d10| 6d 20 6f 66 20 64 65 70 | 65 6e 64 65 6e 63 69 65 |m of dep|endencie|
|00004d20| 73 20 62 65 74 77 65 65 | 6e 20 73 63 72 61 70 73 |s betwee|n scraps|
|00004d30| 20 6f 66 0d 0a 63 6f 64 | 65 20 61 6e 64 20 73 63 | of..cod|e and sc|
|00004d40| 72 61 70 73 20 6f 66 20 | 64 6f 63 75 6d 65 6e 74 |raps of |document|
|00004d50| 61 74 69 6f 6e 2e 20 48 | 6f 77 65 76 65 72 2c 20 |ation. H|owever, |
|00004d60| 69 74 20 69 73 20 68 61 | 72 64 20 74 6f 20 73 65 |it is ha|rd to se|
|00004d70| 65 20 68 6f 77 20 61 20 | 74 6f 6f 6c 0d 0a 73 75 |e how a |tool..su|
|00004d80| 63 68 20 61 73 20 46 75 | 6e 6e 65 6c 57 65 62 20 |ch as Fu|nnelWeb |
|00004d90| 63 6f 75 6c 64 20 70 72 | 6f 76 69 64 65 20 73 75 |could pr|ovide su|
|00004da0| 70 70 6f 72 74 20 66 6f | 72 20 70 72 65 76 65 6e |pport fo|r preven|
|00004db0| 74 69 6f 6e 20 6f 66 20 | 74 68 69 73 20 73 6f 72 |tion of |this sor|
|00004dc0| 74 20 6f 66 20 65 72 72 | 6f 72 2e 0d 0a 0d 0a 5c |t of err|or.....\|
|00004dd0| 74 68 69 6e 67 7b 4d 65 | 74 61 2d 6d 61 63 72 6f |thing{Me|ta-macro|
|00004de0| 2d 6c 65 76 65 6c 20 70 | 61 72 61 6d 65 74 65 72 |-level p|arameter|
|00004df0| 69 7a 61 74 69 6f 6e 3a | 7d 20 53 6f 6d 65 74 69 |ization:|} Someti|
|00004e00| 6d 65 73 2c 20 77 68 65 | 6e 20 75 73 69 6e 67 20 |mes, whe|n using |
|00004e10| 46 75 6e 6e 65 6c 57 65 | 62 2c 0d 0a 74 68 65 20 |FunnelWe|b,..the |
|00004e20| 66 61 63 69 6c 69 74 79 | 20 74 6f 20 75 73 65 20 |facility| to use |
|00004e30| 6f 6e 65 20 6d 61 63 72 | 6f 20 74 6f 20 63 6f 6e |one macr|o to con|
|00004e40| 73 74 72 75 63 74 20 74 | 68 65 20 6e 61 6d 65 20 |struct t|he name |
|00004e50| 6f 66 20 61 6e 6f 74 68 | 65 72 20 68 61 73 20 62 |of anoth|er has b|
|00004e60| 65 65 6e 0d 0a 6e 65 65 | 64 65 64 2e 20 5c 62 7b |een..nee|ded. \b{|
|00004e70| 44 65 63 69 73 69 6f 6e | 3a 7d 20 41 6c 6c 6f 77 |Decision|:} Allow|
|00004e80| 69 6e 67 20 6d 61 63 72 | 6f 20 6e 61 6d 65 73 0d |ing macr|o names.|
|00004e90| 0a 74 6f 20 62 65 20 63 | 6f 6e 73 74 72 75 63 74 |.to be c|onstruct|
|00004ea0| 65 64 20 77 6f 75 6c 64 | 20 6c 6f 73 65 20 74 68 |ed would| lose th|
|00004eb0| 65 20 73 69 6d 70 6c 65 | 0d 0a 6e 61 74 75 72 65 |e simple|..nature|
|00004ec0| 20 6f 66 20 74 68 65 20 | 70 72 65 70 72 6f 63 65 | of the |preproce|
|00004ed0| 73 73 6f 72 20 61 6e 64 | 20 73 6f 20 74 68 69 73 |ssor and| so this|
|00004ee0| 20 73 75 67 67 65 73 74 | 69 6f 6e 20 69 73 20 72 | suggest|ion is r|
|00004ef0| 65 6a 65 63 74 65 64 2e | 0d 0a 0d 0a 5c 74 68 69 |ejected.|....\thi|
|00004f00| 6e 67 7b 43 6c 75 6d 73 | 79 20 6e 6f 74 61 74 69 |ng{Clums|y notati|
|00004f10| 6f 6e 3a 7d 20 54 68 65 | 20 5c 70 7b 40 7d 20 6e |on:} The| \p{@} n|
|00004f20| 6f 74 61 74 69 6f 6e 20 | 63 61 6e 20 62 65 20 63 |otation |can be c|
|00004f30| 6c 75 6d 73 79 2e 0d 0a | 5c 62 7b 44 65 63 69 73 |lumsy...|\b{Decis|
|00004f40| 69 6f 6e 3a 7d 20 54 68 | 69 73 20 69 73 20 6e 65 |ion:} Th|is is ne|
|00004f50| 63 65 73 73 61 72 79 20 | 74 6f 20 6d 61 69 6e 74 |cessary |to maint|
|00004f60| 61 69 6e 20 74 68 65 20 | 73 69 6d 70 6c 69 63 69 |ain the |simplici|
|00004f70| 74 79 20 6f 66 20 74 68 | 65 20 74 72 61 6e 73 6c |ty of th|e transl|
|00004f80| 61 74 69 6f 6e 2e 0d 0a | 0d 0a 5c 73 65 63 74 69 |ation...|..\secti|
|00004f90| 6f 6e 7b 41 75 74 6f 6d | 61 74 65 64 20 52 65 67 |on{Autom|ated Reg|
|00004fa0| 72 65 73 73 69 6f 6e 20 | 54 65 73 74 69 6e 67 7d |ression |Testing}|
|00004fb0| 0d 0a 5c 78 78 7b 72 65 | 67 72 65 73 73 69 6f 6e |..\xx{re|gression|
|00004fc0| 7d 7b 74 65 73 74 69 6e | 67 7d 0d 0a 0d 0a 41 75 |}{testin|g}....Au|
|00004fd0| 74 6f 6d 61 74 65 64 20 | 72 65 67 72 65 73 73 69 |tomated |regressi|
|00004fe0| 6f 6e 20 74 65 73 74 69 | 6e 67 20 69 73 20 65 78 |on testi|ng is ex|
|00004ff0| 74 72 65 6d 65 6c 79 20 | 69 6d 70 6f 72 74 61 6e |tremely |importan|
|00005000| 74 20 66 6f 72 20 74 77 | 6f 20 72 65 61 73 6f 6e |t for tw|o reason|
|00005010| 73 3a 0d 0a 0d 0a 5c 62 | 65 67 69 6e 7b 65 6e 75 |s:....\b|egin{enu|
|00005020| 6d 65 72 61 74 65 7d 0d | 0a 0d 0a 5c 69 74 65 6d |merate}.|...\item|
|00005030| 20 49 74 20 70 72 6f 76 | 69 64 65 73 20 63 6f 6e | It prov|ides con|
|00005040| 66 69 64 65 6e 63 65 20 | 74 68 61 74 20 63 68 61 |fidence |that cha|
|00005050| 6e 67 65 73 20 6d 61 64 | 65 20 74 6f 20 74 68 65 |nges mad|e to the|
|00005060| 20 70 72 6f 67 72 61 6d | 20 68 61 76 65 0d 0a 6e | program| have..n|
|00005070| 6f 74 20 69 6e 74 72 6f | 64 75 63 65 64 20 62 75 |ot intro|duced bu|
|00005080| 67 73 2e 0d 0a 0d 0a 5c | 69 74 65 6d 20 49 74 20 |gs.....\|item It |
|00005090| 61 6c 6c 6f 77 73 20 70 | 6f 72 74 61 62 69 6c 69 |allows p|ortabili|
|000050a0| 74 79 20 70 72 6f 62 6c | 65 6d 73 20 74 6f 20 62 |ty probl|ems to b|
|000050b0| 65 20 70 69 6e 70 6f 69 | 6e 74 65 64 20 77 68 65 |e pinpoi|nted whe|
|000050c0| 6e 20 74 68 65 20 70 72 | 6f 67 72 61 6d 20 69 73 |n the pr|ogram is|
|000050d0| 0d 0a 6d 6f 76 65 64 20 | 74 6f 20 61 20 6e 65 77 |..moved |to a new|
|000050e0| 20 6d 61 63 68 69 6e 65 | 2e 0d 0a 0d 0a 5c 65 6e | machine|.....\en|
|000050f0| 64 7b 65 6e 75 6d 65 72 | 61 74 65 7d 0d 0a 0d 0a |d{enumer|ate}....|
|00005100| 54 68 65 20 73 69 6d 70 | 6c 65 73 74 20 77 61 79 |The simp|lest way|
|00005110| 20 74 6f 20 73 65 74 20 | 75 70 20 61 75 74 6f 6d | to set |up autom|
|00005120| 61 74 65 64 20 72 65 67 | 72 65 73 73 69 6f 6e 20 |ated reg|ression |
|00005130| 74 65 73 74 69 6e 67 20 | 69 73 20 74 6f 20 63 6f |testing |is to co|
|00005140| 6e 73 74 72 75 63 74 0d | 0a 61 20 73 75 69 74 65 |nstruct.|.a suite|
|00005150| 20 6f 66 20 74 65 73 74 | 20 63 61 73 65 73 20 28 | of test| cases (|
|00005160| 61 6e 64 20 74 68 65 69 | 72 20 73 6f 6c 75 74 69 |and thei|r soluti|
|00005170| 6f 6e 73 29 20 61 6e 64 | 20 74 68 65 6e 20 77 72 |ons) and| then wr|
|00005180| 69 74 65 20 61 0d 0a 73 | 63 72 69 70 74 20 69 6e |ite a..s|cript in|
|00005190| 20 74 68 65 20 74 61 72 | 67 65 74 20 6d 61 63 68 | the tar|get mach|
|000051a0| 69 6e 65 27 73 20 63 6f | 6d 6d 61 6e 64 20 6c 61 |ine's co|mmand la|
|000051b0| 6e 67 75 61 67 65 20 74 | 6f 20 72 75 6e 20 74 68 |nguage t|o run th|
|000051c0| 72 6f 75 67 68 20 74 68 | 65 20 73 75 69 74 65 2e |rough th|e suite.|
|000051d0| 0d 0a 55 6e 66 6f 72 74 | 75 6e 61 74 65 6c 79 2c |..Unfort|unately,|
|000051e0| 20 74 68 65 72 65 20 69 | 73 20 6e 6f 20 63 6f 6d | there i|s no com|
|000051f0| 6d 61 6e 64 20 6c 61 6e | 67 75 61 67 65 20 74 68 |mand lan|guage th|
|00005200| 61 74 20 69 73 20 73 68 | 61 72 65 64 20 61 6d 6f |at is sh|ared amo|
|00005210| 6e 67 20 74 68 65 0d 0a | 6d 61 63 68 69 6e 65 73 |ng the..|machines|
|00005220| 20 74 6f 20 77 68 69 63 | 68 20 46 75 6e 6e 65 6c | to whic|h Funnel|
|00005230| 57 65 62 20 6d 75 73 74 | 20 62 65 20 70 6f 72 74 |Web must| be port|
|00005240| 65 64 2e 20 54 68 65 73 | 65 20 6d 61 63 68 69 6e |ed. Thes|e machin|
|00005250| 65 73 20 61 72 65 20 61 | 74 20 6c 65 61 73 74 3a |es are a|t least:|
|00005260| 0d 0a 4d 61 63 69 6e 74 | 6f 73 68 2c 20 49 42 4d |..Macint|osh, IBM|
|00005270| 2d 50 43 2c 20 53 75 6e | 2c 20 56 4d 53 20 56 61 |-PC, Sun|, VMS Va|
|00005280| 78 2e 0d 0a 0d 0a 4f 6e | 65 20 6f 70 74 69 6f 6e |x.....On|e option|
|00005290| 20 69 73 20 73 69 6d 70 | 6c 79 20 74 6f 20 72 65 | is simp|ly to re|
|000052a0| 77 72 69 74 65 20 74 68 | 65 20 73 63 72 69 70 74 |write th|e script|
|000052b0| 20 69 6e 20 65 61 63 68 | 20 6d 61 63 68 69 6e 65 | in each| machine|
|000052c0| 27 73 20 70 61 72 74 69 | 63 75 6c 61 72 0d 0a 63 |'s parti|cular..c|
|000052d0| 6f 6d 6d 61 6e 64 20 6c | 61 6e 67 75 61 67 65 2e |ommand l|anguage.|
|000052e0| 20 54 68 69 73 20 77 6f | 75 6c 64 20 62 65 20 61 | This wo|uld be a|
|000052f0| 20 66 65 61 73 69 62 6c | 65 20 6f 70 74 69 6f 6e | feasibl|e option|
|00005300| 20 77 65 72 65 20 69 74 | 20 6e 6f 74 20 66 6f 72 | were it| not for|
|00005310| 20 74 68 65 20 66 61 63 | 74 0d 0a 74 68 61 74 20 | the fac|t..that |
|00005320| 74 68 65 20 4d 61 63 69 | 6e 74 6f 73 68 20 28 74 |the Maci|ntosh (t|
|00005330| 68 65 20 6d 61 63 68 69 | 6e 65 20 75 70 6f 6e 20 |he machi|ne upon |
|00005340| 77 68 69 63 68 20 46 75 | 6e 6e 65 6c 57 65 62 20 |which Fu|nnelWeb |
|00005350| 77 61 73 20 64 65 76 65 | 6c 6f 70 65 64 29 20 64 |was deve|loped) d|
|00005360| 6f 65 73 0d 0a 6e 6f 74 | 20 68 61 76 65 20 61 20 |oes..not| have a |
|00005370| 63 6f 6d 6d 61 6e 64 20 | 6c 61 6e 67 75 61 67 65 |command |language|
|00005380| 21 0d 0a 0d 0a 41 66 74 | 65 72 20 73 6f 6d 65 20 |!....Aft|er some |
|00005390| 74 68 6f 75 67 68 74 2c | 20 49 20 64 65 63 69 64 |thought,| I decid|
|000053a0| 65 64 20 74 68 61 74 20 | 74 68 65 20 62 65 73 74 |ed that |the best|
|000053b0| 20 73 6f 6c 75 74 69 6f | 6e 20 74 6f 20 74 68 65 | solutio|n to the|
|000053c0| 20 70 72 6f 62 6c 65 6d | 20 77 61 73 0d 0a 74 6f | problem| was..to|
|000053d0| 20 63 72 65 61 74 65 20 | 61 20 63 6f 6d 6d 61 6e | create |a comman|
|000053e0| 64 20 6c 61 6e 67 75 61 | 67 65 20 5c 69 7b 77 69 |d langua|ge \i{wi|
|000053f0| 74 68 69 6e 20 46 75 6e | 6e 65 6c 57 65 62 7d 2e |thin Fun|nelWeb}.|
|00005400| 20 46 75 6e 6e 65 6c 57 | 65 62 20 63 6f 75 6c 64 | FunnelW|eb could|
|00005410| 20 74 68 65 6e 0d 0a 62 | 65 20 69 6e 76 6f 6b 65 | then..b|e invoke|
|00005420| 64 20 69 6e 20 74 77 6f | 20 6d 6f 64 65 73 2c 20 |d in two| modes, |
|00005430| 6f 6e 65 2d 73 68 6f 74 | 20 63 6f 6d 6d 61 6e 64 |one-shot| command|
|00005440| 20 6c 69 6e 65 20 6f 72 | 20 69 6e 74 65 72 61 63 | line or| interac|
|00005450| 74 69 76 65 2f 73 63 72 | 69 70 74 2e 20 54 68 69 |tive/scr|ipt. Thi|
|00005460| 73 0d 0a 61 70 70 72 6f | 61 63 68 20 68 61 64 20 |s..appro|ach had |
|00005470| 74 68 65 20 62 65 6e 65 | 66 69 74 20 6f 66 20 70 |the bene|fit of p|
|00005480| 72 6f 76 69 64 69 6e 67 | 20 74 6f 74 61 6c 20 63 |roviding| total c|
|00005490| 6f 6e 74 72 6f 6c 20 6f | 76 65 72 20 74 68 65 20 |ontrol o|ver the |
|000054a0| 63 6f 6d 6d 61 6e 64 0d | 0a 6c 61 6e 67 75 61 67 |command.|.languag|
|000054b0| 65 20 61 6e 64 20 69 74 | 73 20 63 6f 6d 70 6c 65 |e and it|s comple|
|000054c0| 74 65 20 70 6f 72 74 61 | 62 69 6c 69 74 79 2e 0d |te porta|bility..|
|000054d0| 0a 0d 0a 54 68 65 20 72 | 65 73 75 6c 74 20 69 73 |...The r|esult is|
|000054e0| 20 64 65 73 63 72 69 62 | 65 64 20 69 6e 20 74 68 | describ|ed in th|
|000054f0| 65 20 5c 69 7b 46 75 6e | 6e 65 6c 57 65 62 20 55 |e \i{Fun|nelWeb U|
|00005500| 73 65 72 27 73 20 4d 61 | 6e 75 61 6c 7d 2e 0d 0a |ser's Ma|nual}...|
|00005510| 0d 0a 5c 73 65 63 74 69 | 6f 6e 7b 43 6f 6d 6d 61 |..\secti|on{Comma|
|00005520| 6e 64 20 4c 69 6e 65 20 | 49 6e 74 65 72 66 61 63 |nd Line |Interfac|
|00005530| 65 7d 0d 0a 5c 78 78 7b | 63 6f 6d 6d 61 6e 64 20 |e}..\xx{|command |
|00005540| 6c 69 6e 65 7d 7b 69 6e | 74 65 72 66 61 63 65 7d |line}{in|terface}|
|00005550| 0d 0a 0d 0a 46 75 6e 6e | 65 6c 57 65 62 7e 56 31 |....Funn|elWeb~V1|
|00005560| 20 77 61 73 20 69 6d 70 | 6c 65 6d 65 6e 74 65 64 | was imp|lemented|
|00005570| 20 69 6e 20 41 64 61 5c | 78 7b 41 64 61 7d 20 61 | in Ada\|x{Ada} a|
|00005580| 6e 64 20 72 75 6e 73 20 | 6f 6e 20 61 20 56 4d 53 |nd runs |on a VMS|
|00005590| 20 56 41 58 2e 5c 78 78 | 7b 76 6d 73 7d 7b 76 61 | VAX.\xx|{vms}{va|
|000055a0| 78 7d 0d 0a 41 73 20 73 | 75 63 68 20 69 74 0d 0a |x}..As s|uch it..|
|000055b0| 68 61 73 20 61 20 66 75 | 6c 6c 20 56 4d 53 20 44 |has a fu|ll VMS D|
|000055c0| 43 4c 20 63 6f 6d 6d 61 | 6e 64 20 6c 69 6e 65 20 |CL comma|nd line |
|000055d0| 69 6e 74 65 72 66 61 63 | 65 2e 20 48 65 72 65 20 |interfac|e. Here |
|000055e0| 69 73 20 74 68 65 20 5c | 64 71 70 7b 2e 43 4c 44 |is the \|dqp{.CLD|
|000055f0| 7d 0d 0a 66 69 6c 65 5c | 78 78 7b 2e 63 6c 64 7d |}..file\|xx{.cld}|
|00005600| 7b 66 69 6c 65 7d 20 66 | 6f 72 20 74 68 65 0d 0a |{file} f|or the..|
|00005610| 44 43 4c 20 63 6f 6d 6d | 61 6e 64 20 6c 69 6e 65 |DCL comm|and line|
|00005620| 20 69 6e 74 65 72 66 61 | 63 65 2e 0d 0a 0d 0a 5c | interfa|ce.....\|
|00005630| 62 65 67 69 6e 73 6d 61 | 6c 6c 0d 0a 5c 62 65 67 |beginsma|ll..\beg|
|00005640| 69 6e 7b 76 65 72 62 61 | 74 69 6d 7d 0d 0a 21 20 |in{verba|tim}..! |
|00005650| 46 55 4e 4e 45 4c 57 45 | 42 20 43 6f 6d 6d 61 6e |FUNNELWE|B Comman|
|00005660| 64 20 44 65 66 69 6e 69 | 74 69 6f 6e 0d 0a 21 20 |d Defini|tion..! |
|00005670| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00005680| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 0d 0a 21 20 |========|====..! |
|00005690| 52 6f 73 73 20 57 69 6c | 6c 69 61 6d 73 2e 20 32 |Ross Wil|liams. 2|
|000056a0| 38 20 41 70 72 69 6c 20 | 31 39 38 37 2e 0d 0a 0d |8 April |1987....|
|000056b0| 0a 6d 6f 64 75 6c 65 20 | 63 6f 6d 6d 61 6e 64 5f |.module |command_|
|000056c0| 74 61 62 6c 65 0d 0a 20 | 20 20 64 65 66 69 6e 65 |table.. | define|
|000056d0| 20 76 65 72 62 20 64 75 | 6d 6d 79 5f 63 6f 6d 6d | verb du|mmy_comm|
|000056e0| 61 6e 64 0d 0a 20 20 20 | 70 61 72 61 6d 65 74 65 |and.. |paramete|
|000056f0| 72 20 70 31 20 20 20 20 | 20 20 20 20 20 20 20 2c |r p1 | ,|
|00005700| 20 6c 61 62 65 6c 3d 69 | 6e 70 75 74 5f 66 69 6c | label=i|nput_fil|
|00005710| 65 20 20 20 2c 76 61 6c | 75 65 28 72 65 71 75 69 |e ,val|ue(requi|
|00005720| 72 65 64 2c 74 79 70 65 | 3d 24 66 69 6c 65 29 0d |red,type|=$file).|
|00005730| 0a 20 20 20 71 75 61 6c | 69 66 69 65 72 20 69 6e |. qual|ifier in|
|00005740| 63 6c 75 64 65 5f 66 69 | 6c 65 73 2c 20 6c 61 62 |clude_fi|les, lab|
|00005750| 65 6c 3d 69 6e 63 6c 75 | 64 65 5f 66 69 6c 65 73 |el=inclu|de_files|
|00005760| 2c 76 61 6c 75 65 28 74 | 79 70 65 3d 24 66 69 6c |,value(t|ype=$fil|
|00005770| 65 29 20 2c 64 65 66 61 | 75 6c 74 0d 0a 20 20 20 |e) ,defa|ult.. |
|00005780| 71 75 61 6c 69 66 69 65 | 72 20 6f 75 74 70 75 74 |qualifie|r output|
|00005790| 5f 66 69 6c 65 73 20 2c | 20 6c 61 62 65 6c 3d 6f |_files ,| label=o|
|000057a0| 75 74 70 75 74 5f 66 69 | 6c 65 73 20 2c 76 61 6c |utput_fi|les ,val|
|000057b0| 75 65 28 74 79 70 65 3d | 24 66 69 6c 65 29 20 2c |ue(type=|$file) ,|
|000057c0| 64 65 66 61 75 6c 74 0d | 0a 20 20 20 71 75 61 6c |default.|. qual|
|000057d0| 69 66 69 65 72 20 64 65 | 6c 65 74 65 20 20 20 20 |ifier de|lete |
|000057e0| 20 20 20 2c 20 6c 61 62 | 65 6c 3d 64 65 6c 65 74 | , lab|el=delet|
|000057f0| 65 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |e | |
|00005800| 20 20 20 20 20 20 20 20 | 20 20 20 2c 64 65 66 61 | | ,defa|
|00005810| 75 6c 74 0d 0a 20 20 20 | 71 75 61 6c 69 66 69 65 |ult.. |qualifie|
|00005820| 72 20 74 65 78 5f 66 69 | 6c 65 20 20 20 20 20 2c |r tex_fi|le ,|
|00005830| 20 6c 61 62 65 6c 3d 74 | 65 78 5f 66 69 6c 65 20 | label=t|ex_file |
|00005840| 20 20 20 20 2c 76 61 6c | 75 65 28 74 79 70 65 3d | ,val|ue(type=|
|00005850| 24 66 69 6c 65 29 20 2c | 64 65 66 61 75 6c 74 0d |$file) ,|default.|
|00005860| 0a 20 20 20 71 75 61 6c | 69 66 69 65 72 20 6c 69 |. qual|ifier li|
|00005870| 73 74 69 6e 67 5f 66 69 | 6c 65 20 2c 20 6c 61 62 |sting_fi|le , lab|
|00005880| 65 6c 3d 6c 69 73 74 69 | 6e 67 5f 66 69 6c 65 20 |el=listi|ng_file |
|00005890| 2c 76 61 6c 75 65 28 74 | 79 70 65 3d 24 66 69 6c |,value(t|ype=$fil|
|000058a0| 65 29 20 2c 64 65 66 61 | 75 6c 74 0d 0a 20 20 20 |e) ,defa|ult.. |
|000058b0| 71 75 61 6c 69 66 69 65 | 72 20 62 72 69 65 66 20 |qualifie|r brief |
|000058c0| 20 20 20 20 20 20 20 2c | 20 6c 61 62 65 6c 3d 62 | ,| label=b|
|000058d0| 72 69 65 66 2c 76 61 6c | 75 65 28 74 79 70 65 3d |rief,val|ue(type=|
|000058e0| 24 6e 75 6d 62 65 72 2c | 64 65 66 61 75 6c 74 3d |$number,|default=|
|000058f0| 35 29 2c 64 65 66 61 75 | 6c 74 0d 0a 20 20 20 71 |5),defau|lt.. q|
|00005900| 75 61 6c 69 66 69 65 72 | 20 73 63 72 65 65 6e 20 |ualifier| screen |
|00005910| 20 20 20 20 20 20 2c 20 | 6c 61 62 65 6c 3d 73 63 | , |label=sc|
|00005920| 72 65 65 6e 20 20 20 20 | 20 20 20 2c 76 61 6c 75 |reen | ,valu|
|00005930| 65 28 74 79 70 65 3d 24 | 6e 75 6d 62 65 72 2c 64 |e(type=$|number,d|
|00005940| 65 66 61 75 6c 74 3d 30 | 29 0d 0a 20 20 20 71 75 |efault=0|).. qu|
|00005950| 61 6c 69 66 69 65 72 20 | 74 72 61 63 65 20 20 20 |alifier |trace |
|00005960| 20 20 20 20 20 2c 20 6c | 61 62 65 6c 3d 74 72 61 | , l|abel=tra|
|00005970| 63 65 0d 0a 20 20 20 71 | 75 61 6c 69 66 69 65 72 |ce.. q|ualifier|
|00005980| 20 66 69 6c 65 5f 73 70 | 65 63 20 20 20 20 2c 20 | file_sp|ec , |
|00005990| 6c 61 62 65 6c 3d 66 69 | 6c 65 5f 73 70 65 63 0d |label=fi|le_spec.|
|000059a0| 0a 20 20 20 71 75 61 6c | 69 66 69 65 72 20 63 6f |. qual|ifier co|
|000059b0| 6d 70 61 72 65 0d 0a 5c | 65 6e 64 7b 76 65 72 62 |mpare..\|end{verb|
|000059c0| 61 74 69 6d 7d 0d 0a 5c | 65 6e 64 73 6d 61 6c 6c |atim}..\|endsmall|
|000059d0| 0d 0a 0d 0a 41 73 20 70 | 6f 72 74 61 62 69 6c 69 |....As p|ortabili|
|000059e0| 74 79 20 77 61 73 20 61 | 20 6b 65 79 20 67 6f 61 |ty was a| key goa|
|000059f0| 6c 20 6f 66 20 46 75 6e | 6e 65 6c 57 65 62 7e 56 |l of Fun|nelWeb~V|
|00005a00| 33 2c 20 69 74 20 77 61 | 73 20 6f 62 76 69 6f 75 |3, it wa|s obviou|
|00005a10| 73 20 74 68 61 74 20 74 | 68 65 0d 0a 63 6f 6d 6d |s that t|he..comm|
|00005a20| 61 6e 64 20 6c 69 6e 65 | 20 69 6e 74 65 72 66 61 |and line| interfa|
|00005a30| 63 65 20 77 6f 75 6c 64 | 20 68 61 76 65 20 74 6f |ce would| have to|
|00005a40| 20 62 65 20 72 65 64 65 | 73 69 67 6e 65 64 2e 20 | be rede|signed. |
|00005a50| 54 68 65 20 64 65 73 69 | 67 6e 20 67 6f 61 6c 73 |The desi|gn goals|
|00005a60| 20 66 6f 72 20 74 68 65 | 0d 0a 6e 65 77 20 63 6f | for the|..new co|
|00005a70| 6d 6d 61 6e 64 20 6c 69 | 6e 65 20 69 6e 74 65 72 |mmand li|ne inter|
|00005a80| 66 61 63 65 20 77 65 72 | 65 3a 5c 78 78 7b 64 65 |face wer|e:\xx{de|
|00005a90| 73 69 67 6e 20 67 6f 61 | 6c 73 7d 7b 63 6f 6d 6d |sign goa|ls}{comm|
|00005aa0| 61 6e 64 20 6c 69 6e 65 | 20 69 6e 74 65 72 66 61 |and line| interfa|
|00005ab0| 63 65 7d 0d 0a 0d 0a 5c | 62 65 67 69 6e 7b 65 6e |ce}....\|begin{en|
|00005ac0| 75 6d 65 72 61 74 65 7d | 0d 0a 0d 0a 5c 69 74 65 |umerate}|....\ite|
|00005ad0| 6d 20 54 68 65 20 69 6e | 74 65 72 66 61 63 65 20 |m The in|terface |
|00005ae0| 73 68 6f 75 6c 64 20 6e | 6f 74 20 5c 69 7b 64 65 |should n|ot \i{de|
|00005af0| 70 65 6e 64 7d 20 6f 6e | 20 63 61 73 65 2e 20 48 |pend} on| case. H|
|00005b00| 6f 77 65 76 65 72 2c 20 | 69 74 20 6d 75 73 74 20 |owever, |it must |
|00005b10| 61 6c 6c 6f 77 0d 0a 20 | 20 20 20 20 20 63 61 73 |allow.. | cas|
|00005b20| 65 2d 73 65 6e 73 69 74 | 69 76 65 20 66 69 6c 65 |e-sensit|ive file|
|00005b30| 6e 61 6d 65 73 20 74 6f | 20 62 65 20 74 72 61 6e |names to| be tran|
|00005b40| 73 6d 69 74 74 65 64 20 | 6f 6e 20 73 79 73 74 65 |smitted |on syste|
|00005b50| 6d 73 20 74 68 61 74 20 | 68 61 76 65 0d 0a 20 20 |ms that |have.. |
|00005b60| 20 20 20 20 63 61 73 65 | 2d 73 65 6e 73 69 74 69 | case|-sensiti|
|00005b70| 76 65 20 66 69 6c 65 6e | 61 6d 65 73 2e 0d 0a 0d |ve filen|ames....|
|00005b80| 0a 5c 69 74 65 6d 20 45 | 61 63 68 20 6f 70 74 69 |.\item E|ach opti|
|00005b90| 6f 6e 20 6d 75 73 74 20 | 68 61 76 65 20 61 20 73 |on must |have a s|
|00005ba0| 79 6d 6d 65 74 72 69 63 | 20 70 6f 73 69 74 69 76 |ymmetric| positiv|
|00005bb0| 65 20 61 6e 64 20 6e 65 | 67 61 74 69 76 65 20 66 |e and ne|gative f|
|00005bc0| 6f 72 6d 2e 20 46 6f 72 | 0d 0a 20 20 20 20 20 20 |orm. For|.. |
|00005bd0| 65 78 61 6d 70 6c 65 2c | 20 69 74 20 69 73 20 63 |example,| it is c|
|00005be0| 6f 6e 66 75 73 69 6e 67 | 20 66 6f 72 20 5c 70 7b |onfusing| for \p{|
|00005bf0| 2d 58 7d 20 74 6f 20 74 | 75 72 6e 20 6f 6e 20 61 |-X} to t|urn on a|
|00005c00| 20 66 65 61 74 75 72 65 | 20 61 6e 64 20 5c 70 7b | feature| and \p{|
|00005c10| 2d 51 7d 0d 0a 20 20 20 | 20 20 20 74 6f 20 74 75 |-Q}.. | to tu|
|00005c20| 72 6e 20 69 74 20 6f 66 | 66 2e 0d 0a 0d 0a 5c 69 |rn it of|f.....\i|
|00005c30| 74 65 6d 20 54 68 65 20 | 69 6e 74 65 72 66 61 63 |tem The |interfac|
|00005c40| 65 20 6d 75 73 74 20 62 | 65 20 65 78 74 65 6e 73 |e must b|e extens|
|00005c50| 69 62 6c 65 20 74 6f 20 | 61 6c 6c 6f 77 20 69 6e |ible to |allow in|
|00005c60| 63 6c 75 73 69 6f 6e 20 | 6f 66 20 6d 6f 72 65 20 |clusion |of more |
|00005c70| 66 65 61 74 75 72 65 73 | 0d 0a 20 20 20 20 20 20 |features|.. |
|00005c80| 61 74 20 61 20 6c 61 74 | 65 72 20 64 61 74 65 2e |at a lat|er date.|
|00005c90| 0d 0a 0d 0a 5c 69 74 65 | 6d 20 4f 70 74 69 6f 6e |....\ite|m Option|
|00005ca0| 73 20 73 68 6f 75 6c 64 | 20 62 65 20 63 6f 6e 73 |s should| be cons|
|00005cb0| 69 73 74 65 6e 74 20 61 | 6e 64 20 6d 65 6d 6f 72 |istent a|nd memor|
|00005cc0| 61 62 6c 65 2e 0d 0a 0d | 0a 5c 65 6e 64 7b 65 6e |able....|.\end{en|
|00005cd0| 75 6d 65 72 61 74 65 7d | 0d 0a 0d 0a 54 68 65 20 |umerate}|....The |
|00005ce0| 72 65 73 75 6c 74 20 69 | 73 20 64 65 73 63 72 69 |result i|s descri|
|00005cf0| 62 65 64 20 69 6e 20 74 | 68 65 20 5c 69 7b 46 75 |bed in t|he \i{Fu|
|00005d00| 6e 6e 65 6c 57 65 62 20 | 55 73 65 72 27 73 20 4d |nnelWeb |User's M|
|00005d10| 61 6e 75 61 6c 7d 2e 0d | 0a 0d 0a 5c 73 65 63 74 |anual}..|...\sect|
|00005d20| 69 6f 6e 7b 46 69 6c 65 | 20 4e 61 6d 65 20 4d 61 |ion{File| Name Ma|
|00005d30| 6e 61 67 65 6d 65 6e 74 | 7d 0d 0a 5c 78 78 7b 66 |nagement|}..\xx{f|
|00005d40| 69 6c 65 7d 7b 6e 61 6d | 65 73 7d 0d 0a 0d 0a 46 |ile}{nam|es}....F|
|00005d50| 69 6c 65 20 6e 61 6d 65 | 73 20 70 72 65 73 65 6e |ile name|s presen|
|00005d60| 74 20 61 20 68 6f 73 74 | 20 6f 66 20 70 72 6f 62 |t a host| of prob|
|00005d70| 6c 65 6d 73 20 66 6f 72 | 20 61 20 70 72 6f 67 72 |lems for| a progr|
|00005d80| 61 6d 20 6c 69 6b 65 20 | 46 75 6e 6e 65 6c 57 65 |am like |FunnelWe|
|00005d90| 62 2e 0d 0a 46 69 72 73 | 74 2c 20 46 75 6e 6e 65 |b...Firs|t, Funne|
|00005da0| 6c 57 65 62 20 63 61 6e | 20 67 65 6e 65 72 61 74 |lWeb can| generat|
|00005db0| 65 20 73 6f 20 6d 61 6e | 79 20 64 69 66 66 65 72 |e so man|y differ|
|00005dc0| 65 6e 74 20 6b 69 6e 64 | 73 20 6f 66 20 66 69 6c |ent kind|s of fil|
|00005dd0| 65 73 20 74 68 61 74 0d | 0a 63 6f 6e 76 65 6e 74 |es that.|.convent|
|00005de0| 69 6f 6e 73 20 6d 75 73 | 74 20 62 65 20 61 64 6f |ions mus|t be ado|
|00005df0| 70 74 65 64 20 74 6f 20 | 70 72 65 76 65 6e 74 20 |pted to |prevent |
|00005e00| 74 68 65 6d 20 66 72 6f | 6d 20 62 65 63 6f 6d 69 |them fro|m becomi|
|00005e10| 6e 67 20 75 6e 6d 61 6e | 61 67 65 61 62 6c 65 2e |ng unman|ageable.|
|00005e20| 0d 0a 53 65 63 6f 6e 64 | 2c 20 74 68 65 20 63 6f |..Second|, the co|
|00005e30| 6e 73 74 72 61 69 6e 74 | 73 20 6f 6e 20 66 69 6c |nstraint|s on fil|
|00005e40| 65 20 6e 61 6d 65 73 2c | 20 61 6e 64 20 65 76 65 |e names,| and eve|
|00005e50| 6e 20 74 68 65 20 73 74 | 72 75 63 74 75 72 65 20 |n the st|ructure |
|00005e60| 6f 66 20 66 69 6c 65 0d | 0a 6e 61 6d 65 73 20 74 |of file.|.names t|
|00005e70| 68 65 6d 73 65 6c 76 65 | 73 20 76 61 72 69 65 73 |hemselve|s varies|
|00005e80| 20 63 6f 6e 73 69 64 65 | 72 61 62 6c 79 20 66 72 | conside|rably fr|
|00005e90| 6f 6d 20 6d 61 63 68 69 | 6e 65 20 74 6f 20 6d 61 |om machi|ne to ma|
|00005ea0| 63 68 69 6e 65 2e 20 54 | 68 65 73 65 20 74 77 6f |chine. T|hese two|
|00005eb0| 0d 0a 70 72 6f 62 6c 65 | 6d 73 20 68 61 76 65 20 |..proble|ms have |
|00005ec0| 63 6f 6d 62 69 6e 65 64 | 20 74 6f 20 72 65 73 75 |combined| to resu|
|00005ed0| 6c 74 20 69 6e 20 74 68 | 65 20 73 6f 70 68 69 73 |lt in th|e sophis|
|00005ee0| 74 69 63 61 74 65 64 20 | 61 6e 64 0d 0a 72 61 74 |ticated |and..rat|
|00005ef0| 68 65 72 20 63 6f 6d 70 | 6c 69 63 61 74 65 64 20 |her comp|licated |
|00005f00| 77 61 79 20 69 6e 20 77 | 68 69 63 68 20 46 75 6e |way in w|hich Fun|
|00005f10| 6e 65 6c 57 65 62 7e 56 | 33 20 68 61 6e 64 6c 65 |nelWeb~V|3 handle|
|00005f20| 73 20 66 69 6c 65 6e 61 | 6d 65 73 2e 0d 0a 0d 0a |s filena|mes.....|
|00005f30| 54 6f 20 73 75 6d 6d 61 | 72 69 7a 65 2c 20 74 68 |To summa|rize, th|
|00005f40| 65 20 74 68 72 65 65 20 | 70 72 6f 62 6c 65 6d 73 |e three |problems|
|00005f50| 20 61 72 65 3a 0d 0a 0d | 0a 5c 62 65 67 69 6e 7b | are:...|.\begin{|
|00005f60| 65 6e 75 6d 65 72 61 74 | 65 7d 0d 0a 5c 69 74 65 |enumerat|e}..\ite|
|00005f70| 6d 20 57 68 61 74 20 66 | 69 6c 65 6e 61 6d 65 20 |m What f|ilename |
|00005f80| 65 78 74 65 6e 73 69 6f | 6e 73 20 73 68 6f 75 6c |extensio|ns shoul|
|00005f90| 64 20 62 65 20 63 68 6f | 73 65 6e 20 66 6f 72 20 |d be cho|sen for |
|00005fa0| 76 61 72 69 6f 75 73 20 | 6b 69 6e 64 73 20 6f 66 |various |kinds of|
|00005fb0| 20 66 69 6c 65 3f 0d 0a | 5c 69 74 65 6d 20 57 68 | file?..|\item Wh|
|00005fc0| 61 74 20 66 69 6c 65 6e | 61 6d 65 20 69 6e 68 65 |at filen|ame inhe|
|00005fd0| 72 69 74 61 6e 63 65 20 | 73 68 6f 75 6c 64 20 74 |ritance |should t|
|00005fe0| 61 6b 65 20 70 6c 61 63 | 65 3f 0d 0a 5c 69 74 65 |ake plac|e?..\ite|
|00005ff0| 6d 20 48 6f 77 20 73 68 | 6f 75 6c 64 20 46 75 6e |m How sh|ould Fun|
|00006000| 6e 65 6c 57 65 62 20 63 | 6f 70 65 20 77 69 74 68 |nelWeb c|ope with|
|00006010| 20 74 68 65 20 76 61 72 | 69 61 74 69 6f 6e 73 20 | the var|iations |
|00006020| 69 6e 20 66 69 6c 65 6e | 61 6d 65 20 73 74 72 75 |in filen|ame stru|
|00006030| 63 74 75 72 65 0d 0a 62 | 65 74 77 65 65 6e 20 6d |cture..b|etween m|
|00006040| 61 63 68 69 6e 65 73 3f | 0d 0a 5c 65 6e 64 7b 65 |achines?|..\end{e|
|00006050| 6e 75 6d 65 72 61 74 65 | 7d 0d 0a 0d 0a 54 68 65 |numerate|}....The|
|00006060| 20 66 6f 6c 6c 6f 77 69 | 6e 67 20 74 68 72 65 65 | followi|ng three|
|00006070| 20 73 65 63 74 69 6f 6e | 73 20 61 64 64 72 65 73 | section|s addres|
|00006080| 73 20 74 68 65 73 65 20 | 71 75 65 73 74 69 6f 6e |s these |question|
|00006090| 73 2e 0d 0a 0d 0a 5c 73 | 75 62 73 65 63 74 69 6f |s.....\s|ubsectio|
|000060a0| 6e 7b 46 69 6c 65 6e 61 | 6d 65 20 45 78 74 65 6e |n{Filena|me Exten|
|000060b0| 73 69 6f 6e 73 7d 0d 0a | 5c 78 78 7b 66 69 6c 65 |sions}..|\xx{file|
|000060c0| 6e 61 6d 65 7d 7b 65 78 | 74 65 6e 73 69 6f 6e 73 |name}{ex|tensions|
|000060d0| 7d 0d 0a 0d 0a 46 75 6e | 6e 65 6c 57 65 62 20 69 |}....Fun|nelWeb i|
|000060e0| 73 20 63 61 70 61 62 6c | 65 20 6f 66 20 72 65 61 |s capabl|e of rea|
|000060f0| 64 69 6e 67 20 61 6e 64 | 20 77 72 69 74 69 6e 67 |ding and| writing|
|00006100| 20 61 20 76 61 72 69 65 | 74 79 20 6f 66 20 64 69 | a varie|ty of di|
|00006110| 66 66 65 72 65 6e 74 20 | 6b 69 6e 64 73 0d 0a 6f |fferent |kinds..o|
|00006120| 66 20 66 69 6c 65 73 2e | 20 49 6e 20 70 61 72 74 |f files.| In part|
|00006130| 69 63 75 6c 61 72 2c 20 | 46 75 6e 6e 65 6c 57 65 |icular, |FunnelWe|
|00006140| 62 20 6d 75 73 74 20 6f | 66 74 65 6e 20 6f 70 65 |b must o|ften ope|
|00006150| 72 61 74 65 73 20 69 6e | 20 61 6e 20 65 6e 76 69 |rates in| an envi|
|00006160| 72 6f 6e 6d 65 6e 74 20 | 77 68 65 72 65 0d 0a 74 |ronment |where..t|
|00006170| 68 65 20 73 61 6d 65 20 | 69 6e 66 6f 72 6d 61 74 |he same |informat|
|00006180| 69 6f 6e 20 69 73 20 73 | 74 6f 72 65 64 20 69 6e |ion is s|tored in|
|00006190| 20 6d 61 6e 79 20 66 6f | 72 6d 73 20 28 5c 65 67 | many fo|rms (\eg|
|000061a0| 7b 7d 70 72 6f 67 2e 66 | 77 2c 20 70 72 6f 67 2e |{}prog.f|w, prog.|
|000061b0| 63 2c 20 70 72 6f 63 2e | 65 78 65 29 2e 0d 0a 46 |c, proc.|exe)...F|
|000061c0| 69 6c 65 20 65 78 74 65 | 6e 73 69 6f 6e 73 20 61 |ile exte|nsions a|
|000061d0| 72 65 20 61 6e 20 65 73 | 73 65 6e 74 69 61 6c 20 |re an es|sential |
|000061e0| 74 6f 6f 6c 20 69 6e 20 | 6d 61 6e 61 67 69 6e 67 |tool in |managing|
|000061f0| 20 74 68 69 73 20 73 69 | 74 75 61 74 69 6f 6e 2e | this si|tuation.|
|00006200| 0d 0a 54 68 65 20 66 69 | 6c 65 6e 61 6d 65 20 65 |..The fi|lename e|
|00006210| 78 74 65 6e 73 69 6f 6e | 73 20 63 68 6f 73 65 6e |xtension|s chosen|
|00006220| 20 66 6f 72 20 46 75 6e | 6e 65 6c 57 65 62 20 61 | for Fun|nelWeb a|
|00006230| 72 65 3a 0d 0a 0d 0a 5c | 62 65 67 69 6e 7b 76 65 |re:....\|begin{ve|
|00006240| 72 62 61 74 69 6d 7d 0d | 0a 46 75 6e 6e 65 6c 57 |rbatim}.|.FunnelW|
|00006250| 65 62 20 20 20 20 20 3a | 20 2e 66 77 0d 0a 50 72 |eb :| .fw..Pr|
|00006260| 6f 64 75 63 74 20 20 20 | 20 20 20 20 3a 20 4e 6f |oduct | : No|
|00006270| 6e 65 2e 0d 0a 44 6f 63 | 75 6d 65 6e 74 61 74 69 |ne...Doc|umentati|
|00006280| 6f 6e 20 3a 20 2e 74 65 | 78 0d 0a 4c 69 73 74 69 |on : .te|x..Listi|
|00006290| 6e 67 20 20 20 20 20 20 | 20 3a 20 2e 6c 69 73 0d |ng | : .lis.|
|000062a0| 0a 4a 6f 75 72 6e 61 6c | 20 20 20 20 20 20 20 3a |.Journal| :|
|000062b0| 20 2e 6a 72 6e 0d 0a 5c | 65 6e 64 7b 76 65 72 62 | .jrn..\|end{verb|
|000062c0| 61 74 69 6d 7d 0d 0a 0d | 0a 4c 6f 77 65 72 63 61 |atim}...|.Lowerca|
|000062d0| 73 65 20 77 69 6c 6c 20 | 62 65 20 75 73 65 64 20 |se will |be used |
|000062e0| 69 6e 20 73 79 73 74 65 | 6d 73 20 74 68 61 74 20 |in syste|ms that |
|000062f0| 61 72 65 20 63 61 73 65 | 20 73 65 6e 73 69 74 69 |are case| sensiti|
|00006300| 76 65 2e 0d 0a 0d 0a 52 | 65 61 64 65 72 73 20 77 |ve.....R|eaders w|
|00006310| 68 6f 20 61 72 65 20 77 | 6f 6e 64 65 72 69 6e 67 |ho are w|ondering|
|00006320| 20 68 6f 77 20 46 75 6e | 6e 65 6c 57 65 62 20 63 | how Fun|nelWeb c|
|00006330| 6f 70 65 73 20 69 6e 20 | 65 6e 76 69 72 6f 6e 6d |opes in |environm|
|00006340| 65 6e 74 73 20 73 75 63 | 68 20 61 73 20 55 4e 49 |ents suc|h as UNI|
|00006350| 58 0d 0a 77 68 65 72 65 | 20 74 68 65 72 65 20 61 |X..where| there a|
|00006360| 72 65 20 6e 6f 20 66 69 | 6c 65 20 65 78 74 65 6e |re no fi|le exten|
|00006370| 73 69 6f 6e 73 20 73 68 | 6f 75 6c 64 20 72 65 66 |sions sh|ould ref|
|00006380| 65 72 20 74 6f 0d 0a 53 | 65 63 74 69 6f 6e 7e 5c |er to..S|ection~\|
|00006390| 72 65 66 7b 70 6f 72 74 | 61 62 6c 65 66 69 6c 65 |ref{port|ablefile|
|000063a0| 6e 61 6d 65 73 7d 2e 0d | 0a 0d 0a 5c 73 75 62 73 |names}..|...\subs|
|000063b0| 65 63 74 69 6f 6e 7b 46 | 69 6c 65 6e 61 6d 65 20 |ection{F|ilename |
|000063c0| 49 6e 68 65 72 69 74 61 | 6e 63 65 7d 0d 0a 5c 78 |Inherita|nce}..\x|
|000063d0| 78 7b 66 69 6c 65 6e 61 | 6d 65 7d 7b 69 6e 68 65 |x{filena|me}{inhe|
|000063e0| 72 69 74 61 6e 63 65 7d | 0d 0a 0d 0a 49 6e 68 65 |ritance}|....Inhe|
|000063f0| 72 69 74 61 6e 63 65 20 | 69 6e 20 66 69 6c 65 6e |ritance |in filen|
+--------+-------------------------+-------------------------+--------+--------+
Only 25.0 KB of data is shown above.
