home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / program / funnel / u_ch2.tex < prev    next >
LaTeX Document  |  1993-10-23  |  66.8 KB

open in: MacOS 8.1     |     Win98     |     DOS

browse contents    |     view JSON data     |     view as text


This file was processed as: LaTeX Document (document/latex).

ConfidenceProgramDetectionMatch TypeSupport
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% 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 20 20 53 74 61 72 74 | 20 6f 66 20 43 68 32 2e | Start| of Ch2.|
|00000080| 74 65 78 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |tex | |
|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 55 73 65 72 27 | FunnelW|eb User'|
|00000170| 73 20 4d 61 6e 75 61 6c | 2e 0d 0a 25 20 53 65 65 |s Manual|...% See|
|00000180| 20 74 68 65 20 6d 61 69 | 6e 20 54 65 58 20 66 69 | the mai|n TeX fi|
|00000190| 6c 65 20 66 6f 72 20 74 | 68 69 73 20 6d 61 6e 75 |le for t|his manu|
|000001a0| 61 6c 20 66 6f 72 20 66 | 75 72 74 68 65 72 20 69 |al for f|urther i|
|000001b0| 6e 66 6f 72 6d 61 74 69 | 6f 6e 2e 0d 0a 25 0d 0a |nformati|on...%..|
|000001c0| 25 3d 3d 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 25 |========|=======%|
|00000210| 0d 0a 0d 0a 5c 63 68 61 | 70 74 65 72 7b 46 75 6e |....\cha|pter{Fun|
|00000220| 6e 65 6c 57 65 62 20 48 | 69 6e 74 73 7d 0d 0a 5c |nelWeb H|ints}..\|
|00000230| 6c 61 62 65 6c 7b 63 68 | 61 70 61 64 76 61 6e 63 |label{ch|apadvanc|
|00000240| 65 64 7d 5c 78 78 7b 46 | 75 6e 6e 65 6c 57 65 62 |ed}\xx{F|unnelWeb|
|00000250| 7d 7b 68 69 6e 74 73 7d | 0d 0a 0d 0a 57 68 65 72 |}{hints}|....Wher|
|00000260| 65 61 73 20 43 68 61 70 | 74 65 72 7e 5c 72 65 66 |eas Chap|ter~\ref|
|00000270| 7b 63 68 61 70 69 6e 74 | 72 6f 64 75 63 74 69 6f |{chapint|roductio|
|00000280| 6e 7d 20 70 72 6f 76 69 | 64 65 73 20 61 6e 20 69 |n} provi|des an i|
|00000290| 6e 74 72 6f 64 75 63 74 | 69 6f 6e 20 74 6f 0d 0a |ntroduct|ion to..|
|000002a0| 46 75 6e 6e 65 6c 57 65 | 62 20 61 6e 64 20 43 68 |FunnelWe|b and Ch|
|000002b0| 61 70 74 65 72 7e 5c 72 | 65 66 7b 63 68 61 70 64 |apter~\r|ef{chapd|
|000002c0| 65 66 69 6e 69 74 69 6f | 6e 7d 20 61 20 64 65 66 |efinitio|n} a def|
|000002d0| 69 6e 69 74 69 6f 6e 2c | 20 5c 69 7b 74 68 69 73 |inition,| \i{this|
|000002e0| 7d 20 63 68 61 70 74 65 | 72 0d 0a 63 6f 6e 74 61 |} chapte|r..conta|
|000002f0| 69 6e 73 20 68 69 6e 74 | 73 20 61 62 6f 75 74 20 |ins hint|s about |
|00000300| 68 6f 77 0d 0a 46 75 6e | 6e 65 6c 57 65 62 20 63 |how..Fun|nelWeb c|
|00000310| 61 6e 20 62 65 20 75 73 | 65 64 2e 20 54 68 69 73 |an be us|ed. This|
|00000320| 20 63 68 61 70 74 65 72 | 20 70 72 6f 62 61 62 6c | chapter| probabl|
|00000330| 79 20 73 68 6f 75 6c 64 | 20 6e 6f 74 20 62 65 20 |y should| not be |
|00000340| 72 65 61 64 20 75 6e 74 | 69 6c 0d 0a 74 68 65 20 |read unt|il..the |
|00000350| 72 65 61 64 65 72 20 68 | 61 73 20 61 6c 72 65 61 |reader h|as alrea|
|00000360| 64 79 20 63 6f 6d 6d 65 | 6e 63 65 64 20 75 73 69 |dy comme|nced usi|
|00000370| 6e 67 20 46 75 6e 6e 65 | 6c 57 65 62 2c 20 6f 72 |ng Funne|lWeb, or|
|00000380| 20 61 74 20 74 68 65 20 | 76 65 72 79 20 6c 65 61 | at the |very lea|
|00000390| 73 74 2c 0d 0a 74 72 69 | 65 64 20 6f 75 74 20 73 |st,..tri|ed out s|
|000003a0| 6f 6d 65 20 6f 66 20 74 | 68 65 20 65 78 61 6d 70 |ome of t|he examp|
|000003b0| 6c 65 73 20 69 6e 20 43 | 68 61 70 74 65 72 7e 5c |les in C|hapter~\|
|000003c0| 72 65 66 7b 63 68 61 70 | 69 6e 74 72 6f 64 75 63 |ref{chap|introduc|
|000003d0| 74 69 6f 6e 7d 2e 0d 0a | 54 68 6f 73 65 20 77 68 |tion}...|Those wh|
|000003e0| 6f 20 66 69 6e 64 20 74 | 68 65 6d 73 65 6c 76 65 |o find t|hemselve|
|000003f0| 73 20 75 73 69 6e 67 20 | 46 75 6e 6e 65 6c 57 65 |s using |FunnelWe|
|00000400| 62 20 66 72 65 71 75 65 | 6e 74 6c 79 0d 0a 73 68 |b freque|ntly..sh|
|00000410| 6f 75 6c 64 20 72 65 61 | 64 20 74 68 69 73 20 63 |ould rea|d this c|
|00000420| 68 61 70 74 65 72 20 61 | 74 20 73 6f 6d 65 20 73 |hapter a|t some s|
|00000430| 74 61 67 65 0d 0a 73 6f | 20 61 73 20 74 6f 20 65 |tage..so| as to e|
|00000440| 6e 73 75 72 65 20 74 68 | 61 74 20 74 68 65 79 20 |nsure th|at they |
|00000450| 61 72 65 20 67 65 74 74 | 69 6e 67 20 74 68 65 20 |are gett|ing the |
|00000460| 6d 6f 73 74 20 6f 75 74 | 20 6f 66 20 69 74 2e 0d |most out| of it..|
|00000470| 0a 0d 0a 4d 6f 73 74 20 | 6f 66 20 74 68 65 20 65 |...Most |of the e|
|00000480| 78 61 6d 70 6c 65 73 20 | 69 6e 20 74 68 69 73 20 |xamples |in this |
|00000490| 63 68 61 70 74 65 72 20 | 68 61 76 65 20 62 65 65 |chapter |have bee|
|000004a0| 6e 0d 0a 70 6c 61 63 65 | 64 20 69 6e 20 74 68 65 |n..place|d in the|
|000004b0| 20 46 75 6e 6e 65 6c 57 | 65 62 20 72 65 67 72 65 | FunnelW|eb regre|
|000004c0| 73 73 69 6f 6e 20 74 65 | 73 74 20 73 75 69 74 65 |ssion te|st suite|
|000004d0| 20 77 68 69 63 68 20 73 | 68 6f 75 6c 64 20 62 65 | which s|hould be|
|000004e0| 0d 0a 61 76 61 69 6c 61 | 62 6c 65 20 69 6e 20 61 |..availa|ble in a|
|000004f0| 20 64 69 72 65 63 74 6f | 72 79 20 63 61 6c 6c 65 | directo|ry calle|
|00000500| 64 20 5c 70 7b 2f 66 77 | 64 69 72 2f 74 65 73 74 |d \p{/fw|dir/test|
|00000510| 73 2f 7d 2e 0d 0a 54 68 | 65 20 66 69 6c 65 73 20 |s/}...Th|e files |
|00000520| 74 6f 20 65 78 61 6d 69 | 6e 65 20 61 72 65 20 5c |to exami|ne are \|
|00000530| 70 7b 68 69 30 31 2e 66 | 77 7d 20 74 68 72 6f 75 |p{hi01.f|w} throu|
|00000540| 67 68 20 5c 70 7b 68 69 | 31 30 2e 66 77 7d 2e 0d |gh \p{hi|10.fw}..|
|00000550| 0a 0d 0a 5c 73 65 63 74 | 69 6f 6e 7b 4d 61 63 72 |...\sect|ion{Macr|
|00000560| 6f 20 4e 61 6d 65 73 7d | 0d 0a 5c 78 78 7b 6d 61 |o Names}|..\xx{ma|
|00000570| 63 72 6f 7d 7b 6e 61 6d | 65 73 7d 5c 78 78 7b 6d |cro}{nam|es}\xx{m|
|00000580| 61 63 72 6f 7d 7b 69 64 | 65 6e 74 69 66 69 65 72 |acro}{id|entifier|
|00000590| 73 7d 0d 0a 0d 0a 57 68 | 65 6e 20 75 73 69 6e 67 |s}....Wh|en using|
|000005a0| 20 46 75 6e 6e 65 6c 57 | 65 62 2c 20 74 68 65 20 | FunnelW|eb, the |
|000005b0| 63 68 6f 69 63 65 20 6f | 66 20 6d 61 63 72 6f 20 |choice o|f macro |
|000005c0| 6e 61 6d 65 73 20 63 61 | 6e 20 62 65 20 61 73 0d |names ca|n be as.|
|000005d0| 0a 69 6d 70 6f 72 74 61 | 6e 74 20 74 6f 20 74 68 |.importa|nt to th|
|000005e0| 65 20 72 65 61 64 61 62 | 69 6c 69 74 79 20 6f 66 |e readab|ility of|
|000005f0| 20 61 20 70 72 6f 67 72 | 61 6d 20 61 73 20 74 68 | a progr|am as th|
|00000600| 65 20 63 68 6f 69 63 65 | 20 6f 66 20 70 72 6f 67 |e choice| of prog|
|00000610| 72 61 6d 0d 0a 69 64 65 | 6e 74 69 66 69 65 72 73 |ram..ide|ntifiers|
|00000620| 2c 0d 0a 61 6e 64 20 69 | 74 20 69 73 20 69 6d 70 |,..and i|t is imp|
|00000630| 6f 72 74 61 6e 74 20 74 | 68 61 74 20 74 68 65 20 |ortant t|hat the |
|00000640| 75 73 65 72 20 6b 6e 6f | 77 20 74 68 65 20 72 61 |user kno|w the ra|
|00000650| 6e 67 65 20 6f 66 20 6f | 70 74 69 6f 6e 73 20 61 |nge of o|ptions a|
|00000660| 76 61 69 6c 61 62 6c 65 | 2e 0d 0a 0d 0a 5c 6e 61 |vailable|.....\na|
|00000670| 72 72 6f 77 74 68 69 6e | 67 7b 4e 61 6d 65 73 20 |rrowthin|g{Names |
|00000680| 61 72 65 20 63 61 73 65 | 20 73 65 6e 73 69 74 69 |are case| sensiti|
|00000690| 76 65 20 61 6e 64 20 65 | 78 61 63 74 20 6d 61 74 |ve and e|xact mat|
|000006a0| 63 68 69 6e 67 3a 7d 7b | 4d 61 63 72 6f 20 6e 61 |ching:}{|Macro na|
|000006b0| 6d 65 73 20 61 72 65 20 | 63 61 73 65 0d 0a 73 65 |mes are |case..se|
|000006c0| 6e 73 69 74 69 76 65 20 | 61 6e 64 20 61 72 65 20 |nsitive |and are |
|000006d0| 6d 61 74 63 68 65 64 20 | 65 78 61 63 74 6c 79 2e |matched |exactly.|
|000006e0| 20 54 68 65 20 73 74 72 | 69 6e 67 73 20 75 73 65 | The str|ings use|
|000006f0| 64 20 61 73 20 61 20 6d | 61 63 72 6f 20 6e 61 6d |d as a m|acro nam|
|00000700| 65 0d 0a 61 74 20 74 68 | 65 20 70 6f 69 6e 74 20 |e..at th|e point |
|00000710| 6f 66 20 64 65 66 69 6e | 69 74 69 6f 6e 20 61 6e |of defin|ition an|
|00000720| 64 20 63 61 6c 6c 20 6d | 75 73 74 20 62 65 0d 0a |d call m|ust be..|
|00000730| 5c 69 7b 69 64 65 6e 74 | 69 63 61 6c 7d 20 66 6f |\i{ident|ical} fo|
|00000740| 72 20 74 68 65 20 63 6f | 6e 6e 65 63 74 69 6f 6e |r the co|nnection|
|00000750| 20 74 6f 20 62 65 20 6d | 61 64 65 2e 7d 0d 0a 0d | to be m|ade.}...|
|00000760| 0a 5c 6e 61 72 72 6f 77 | 74 68 69 6e 67 7b 4e 61 |.\narrow|thing{Na|
|00000770| 6d 65 73 20 63 61 6e 20 | 63 6f 6e 74 61 69 6e 20 |mes can |contain |
|00000780| 61 6e 79 20 70 72 69 6e | 74 61 62 6c 65 20 63 68 |any prin|table ch|
|00000790| 61 72 61 63 74 65 72 3a | 7d 7b 46 75 6e 6e 65 6c |aracter:|}{Funnel|
|000007a0| 57 65 62 20 69 73 20 6c | 65 73 73 0d 0a 72 65 73 |Web is l|ess..res|
|000007b0| 74 72 69 63 74 69 76 65 | 20 61 62 6f 75 74 20 69 |trictive| about i|
|000007c0| 74 73 20 6d 61 63 72 6f | 20 6e 61 6d 65 73 20 74 |ts macro| names t|
|000007d0| 68 61 6e 20 6d 6f 73 74 | 20 70 72 6f 67 72 61 6d |han most| program|
|000007e0| 6d 69 6e 67 20 6c 61 6e | 67 75 61 67 65 73 20 61 |ming lan|guages a|
|000007f0| 72 65 0d 0a 61 62 6f 75 | 74 20 74 68 65 69 72 20 |re..abou|t their |
|00000800| 69 64 65 6e 74 69 66 69 | 65 72 73 2e 20 41 20 46 |identifi|ers. A F|
|00000810| 75 6e 6e 65 6c 57 65 62 | 20 6d 61 63 72 6f 20 6e |unnelWeb| macro n|
|00000820| 61 6d 65 20 63 61 6e 20 | 63 6f 6e 74 61 69 6e 20 |ame can |contain |
|00000830| 61 6e 79 0d 0a 73 65 71 | 75 65 6e 63 65 20 6f 66 |any..seq|uence of|
|00000840| 20 70 72 69 6e 74 61 62 | 6c 65 20 63 68 61 72 61 | printab|le chara|
|00000850| 63 74 65 72 73 2c 20 69 | 6e 63 6c 75 64 69 6e 67 |cters, i|ncluding|
|00000860| 20 62 6c 61 6e 6b 73 20 | 61 6e 64 20 70 75 6e 63 | blanks |and punc|
|00000870| 74 75 61 74 69 6f 6e 2e | 20 4e 61 6d 65 73 0d 0a |tuation.| Names..|
|00000880| 63 61 6e 20 73 74 61 72 | 74 20 61 6e 64 20 65 6e |can star|t and en|
|00000890| 64 20 77 69 74 68 20 61 | 6e 79 20 63 68 61 72 61 |d with a|ny chara|
|000008a0| 63 74 65 72 2e 20 4e 61 | 6d 65 73 20 63 61 6e 6e |cter. Na|mes cann|
|000008b0| 6f 74 20 63 72 6f 73 73 | 20 6c 69 6e 65 20 62 6f |ot cross| line bo|
|000008c0| 75 6e 64 61 72 69 65 73 | 2e 20 54 68 65 0d 0a 66 |undaries|. The..f|
|000008d0| 6f 6c 6c 6f 77 69 6e 67 | 20 61 72 65 20 61 6c 6c |ollowing| are all|
|000008e0| 20 6c 65 67 61 6c 20 6d | 61 63 72 6f 20 6e 61 6d | legal m|acro nam|
|000008f0| 65 73 3a 7d 0d 0a 0d 0a | 5c 62 65 67 69 6e 7b 76 |es:}....|\begin{v|
|00000900| 65 72 62 61 74 69 6d 7d | 0d 0a 20 20 20 20 20 20 |erbatim}|.. |
|00000910| 20 20 40 3c 54 68 69 73 | 20 6d 61 63 72 6f 20 65 | @<This| macro e|
|00000920| 78 70 61 6e 64 73 20 74 | 6f 20 73 6f 6d 65 20 72 |xpands t|o some r|
|00000930| 65 61 6c 6c 79 20 62 61 | 64 20 63 6f 64 65 40 3e |eally ba|d code@>|
|00000940| 0d 0a 20 20 20 20 20 20 | 20 20 40 3c 40 3e 0d 0a |.. | @<@>..|
|00000950| 20 20 20 20 20 20 20 20 | 40 3c 34 35 33 20 23 24 | |@<453 #$|
|00000960| 20 25 26 23 20 2d 2d 3d | 3d 3d 7e 7e 31 22 3e 3e | %&# --=|==~~1">>|
|00000970| 3e 40 3e 0d 0a 20 20 20 | 20 20 20 20 20 40 3c 3c |>@>.. | @<<|
|00000980| 40 3e 0d 0a 20 20 20 20 | 20 20 20 20 40 3c 3c 3e |@>.. | @<<>|
|00000990| 40 3e 0d 0a 20 20 20 20 | 20 20 20 20 40 3c 61 20 |@>.. | @<a |
|000009a0| 62 20 63 20 64 20 65 20 | 66 20 67 40 3e 0d 0a 20 |b c d e |f g@>.. |
|000009b0| 20 20 20 20 20 20 20 40 | 3c 20 20 20 20 20 20 20 | @|< |
|000009c0| 21 20 20 20 20 20 40 3e | 0d 0a 20 20 20 20 20 20 |! @>|.. |
|000009d0| 20 20 40 3c 3f 3f 20 2e | 2e 2e 40 3e 0d 0a 20 20 | @<?? .|..@>.. |
|000009e0| 20 20 20 20 20 20 40 3c | 22 57 68 6f 27 73 20 62 | @<|"Who's b|
|000009f0| 65 65 6e 20 68 61 63 6b | 69 6e 67 20 4d 59 20 70 |een hack|ing MY p|
|00000a00| 72 6f 67 72 61 6d 22 20 | 73 61 69 64 20 46 61 74 |rogram" |said Fat|
|00000a10| 68 65 72 20 42 65 61 72 | 2e 40 3e 0d 0a 20 20 20 |her Bear|.@>.. |
|00000a20| 20 20 20 20 20 40 3c 55 | 70 64 61 74 65 20 74 68 | @<U|pdate th|
|00000a30| 65 20 6d 61 78 69 6d 75 | 6d 20 61 6e 64 20 72 65 |e maximu|m and re|
|00000a40| 74 75 72 6e 20 66 6f 72 | 20 6d 6f 72 65 20 64 61 |turn for| more da|
|00000a50| 74 61 40 3e 0d 0a 5c 65 | 6e 64 7b 76 65 72 62 61 |ta@>..\e|nd{verba|
|00000a60| 74 69 6d 7d 0d 0a 0d 0a | 5c 6e 61 72 72 6f 77 74 |tim}....|\narrowt|
|00000a70| 68 69 6e 67 7b 4e 61 6d | 65 73 20 6d 75 73 74 20 |hing{Nam|es must |
|00000a80| 62 65 20 6e 6f 20 6d 6f | 72 65 20 74 68 61 6e 20 |be no mo|re than |
|00000a90| 61 20 6d 61 78 69 6d 75 | 6d 20 6c 69 6d 69 74 20 |a maximu|m limit |
|00000aa0| 69 6e 20 6c 65 6e 67 74 | 68 3a 7d 7b 4e 61 6d 65 |in lengt|h:}{Name|
|00000ab0| 73 0d 0a 63 61 6e 20 62 | 65 0d 0a 6e 6f 20 6c 6f |s..can b|e..no lo|
|00000ac0| 6e 67 65 72 20 74 68 61 | 6e 20 61 20 70 72 65 64 |nger tha|n a pred|
|00000ad0| 65 66 69 6e 65 64 20 6d | 61 78 69 6d 75 6d 20 6c |efined m|aximum l|
|00000ae0| 65 6e 67 74 68 2e 20 43 | 75 72 72 65 6e 74 6c 79 |ength. C|urrently|
|00000af0| 20 74 68 69 73 20 6c 65 | 6e 67 74 68 20 63 61 6e | this le|ngth can|
|00000b00| 6e 6f 74 0d 0a 62 65 20 | 6d 6f 64 69 66 69 65 64 |not..be |modified|
|00000b10| 2e 7d 0d 0a 0d 0a 54 79 | 70 69 63 61 6c 6c 79 2c |.}....Ty|pically,|
|00000b20| 20 6d 61 63 72 6f 20 6e | 61 6d 65 73 20 77 69 6c | macro n|ames wil|
|00000b30| 6c 20 63 6f 6e 73 69 73 | 74 20 6f 66 20 61 20 73 |l consis|t of a s|
|00000b40| 68 6f 72 74 20 45 6e 67 | 6c 69 73 68 20 70 68 72 |hort Eng|lish phr|
|00000b50| 61 73 65 20 6f 72 20 73 | 65 6e 74 65 6e 63 65 0d |ase or s|entence.|
|00000b60| 0a 74 68 61 74 20 64 65 | 73 63 72 69 62 65 73 20 |.that de|scribes |
|00000b70| 74 68 65 20 63 6f 6e 74 | 65 6e 74 73 20 6f 66 20 |the cont|ents of |
|00000b80| 74 68 65 20 6d 61 63 72 | 6f 2e 0d 0a 0d 0a 5c 73 |the macr|o.....\s|
|00000b90| 65 63 74 69 6f 6e 7b 51 | 75 69 63 6b 20 4e 61 6d |ection{Q|uick Nam|
|00000ba0| 65 73 7d 0d 0a 5c 78 78 | 7b 71 75 69 63 6b 7d 7b |es}..\xx|{quick}{|
|00000bb0| 6e 61 6d 65 73 7d 0d 0a | 0d 0a 53 6f 6d 65 74 69 |names}..|..Someti|
|00000bc0| 6d 65 73 20 61 20 70 61 | 72 74 69 63 75 6c 61 72 |mes a pa|rticular|
|00000bd0| 20 6d 61 63 72 6f 20 6d | 75 73 74 20 62 65 20 75 | macro m|ust be u|
|00000be0| 73 65 64 20 65 78 74 72 | 65 6d 65 6c 79 20 6f 66 |sed extr|emely of|
|00000bf0| 74 65 6e 2e 20 57 68 65 | 6e 20 74 68 69 73 20 68 |ten. Whe|n this h|
|00000c00| 61 70 70 65 6e 73 0d 0a | 69 74 20 69 73 20 64 65 |appens..|it is de|
|00000c10| 73 69 72 61 62 6c 65 20 | 74 6f 20 6d 61 6b 65 20 |sirable |to make |
|00000c20| 74 68 65 20 6d 61 63 72 | 6f 27 73 20 6e 61 6d 65 |the macr|o's name|
|00000c30| 20 61 73 20 73 68 6f 72 | 74 20 61 73 20 70 6f 73 | as shor|t as pos|
|00000c40| 73 69 62 6c 65 2e 0d 0a | 54 68 65 20 73 68 6f 72 |sible...|The shor|
|00000c50| 74 65 73 74 20 6f 72 64 | 69 6e 61 72 79 20 46 75 |test ord|inary Fu|
|00000c60| 6e 6e 65 6c 57 65 62 20 | 6d 61 63 72 6f 20 6e 61 |nnelWeb |macro na|
|00000c70| 6d 65 20 69 73 20 74 68 | 65 20 65 6d 70 74 79 20 |me is th|e empty |
|00000c80| 6e 61 6d 65 5c 78 78 7b | 65 6d 70 74 79 7d 7b 6e |name\xx{|empty}{n|
|00000c90| 61 6d 65 7d 0d 0a 5c 64 | 71 70 7b 40 3c 40 3e 7d |ame}..\d|qp{@<@>}|
|00000ca0| 2c 20 77 68 69 63 68 20 | 69 73 20 66 6f 75 72 20 |, which |is four |
|00000cb0| 63 68 61 72 61 63 74 65 | 72 73 20 6c 6f 6e 67 2e |characte|rs long.|
|00000cc0| 20 53 69 6e 67 6c 65 2d | 63 68 61 72 61 63 74 65 | Single-|characte|
|00000cd0| 72 20 6e 61 6d 65 73 20 | 61 72 65 0d 0a 66 69 76 |r names |are..fiv|
|00000ce0| 65 20 63 68 61 72 61 63 | 74 65 72 73 20 6c 6f 6e |e charac|ters lon|
|00000cf0| 67 2e 0d 0a 0d 0a 54 6f | 20 63 61 74 65 72 20 66 |g.....To| cater f|
|00000d00| 6f 72 20 74 68 65 20 63 | 61 73 65 73 20 77 68 65 |or the c|ases whe|
|00000d10| 72 65 20 72 65 61 6c 6c | 79 20 73 68 6f 72 74 20 |re reall|y short |
|00000d20| 6e 61 6d 65 73 20 61 72 | 65 20 6e 65 65 64 65 64 |names ar|e needed|
|00000d30| 2c 20 46 75 6e 6e 65 6c | 57 65 62 20 70 72 6f 76 |, Funnel|Web prov|
|00000d40| 69 64 65 73 0d 0a 61 20 | 5c 6e 65 77 74 65 72 6d |ides..a |\newterm|
|00000d50| 7b 71 75 69 63 6b 20 6e | 61 6d 65 7d 20 73 79 6e |{quick n|ame} syn|
|00000d60| 74 61 78 20 74 68 61 74 | 20 61 6c 6c 6f 77 73 20 |tax that| allows |
|00000d70| 6f 6e 65 2d 63 68 61 72 | 61 63 74 65 72 20 6d 61 |one-char|acter ma|
|00000d80| 63 72 6f 20 6e 61 6d 65 | 73 20 74 6f 20 62 65 0d |cro name|s to be.|
|00000d90| 0a 73 70 65 63 69 66 69 | 65 64 20 69 6e 20 74 77 |.specifi|ed in tw|
|00000da0| 6f 20 6c 65 73 73 20 63 | 68 61 72 61 63 74 65 72 |o less c|haracter|
|00000db0| 73 2e 20 51 75 69 63 6b | 20 6e 61 6d 65 73 20 74 |s. Quick| names t|
|00000dc0| 61 6b 65 20 74 68 65 20 | 66 6f 72 6d 20 6f 66 20 |ake the |form of |
|00000dd0| 74 68 65 20 73 70 65 63 | 69 61 6c 0d 0a 63 68 61 |the spec|ial..cha|
|00000de0| 72 61 63 74 65 72 2c 20 | 66 6f 6c 6c 6f 77 65 64 |racter, |followed|
|00000df0| 20 62 79 20 61 20 68 61 | 73 68 20 28 5c 70 7b 5c | by a ha|sh (\p{\|
|00000e00| 23 7d 29 20 66 6f 6c 6c | 6f 77 65 64 20 62 79 20 |#}) foll|owed by |
|00000e10| 61 20 73 69 6e 67 6c 65 | 20 63 68 61 72 61 63 74 |a single| charact|
|00000e20| 65 72 2e 0d 0a 45 78 61 | 6d 70 6c 65 73 3a 0d 0a |er...Exa|mples:..|
|00000e30| 0d 0a 5c 62 65 67 69 6e | 7b 76 65 72 62 61 74 69 |..\begin|{verbati|
|00000e40| 6d 7d 0d 0a 40 23 41 20 | 20 20 20 20 40 23 7c 20 |m}..@#A | @#| |
|00000e50| 20 20 20 20 40 23 26 20 | 20 20 20 20 40 23 6d 0d | @#& | @#m.|
|00000e60| 0a 5c 65 6e 64 7b 76 65 | 72 62 61 74 69 6d 7d 0d |.\end{ve|rbatim}.|
|00000e70| 0a 0d 0a 54 68 69 73 20 | 66 6f 72 6d 20 6f 66 20 |...This |form of |
|00000e80| 6d 61 63 72 6f 20 6e 61 | 6d 65 20 68 61 73 20 74 |macro na|me has t|
|00000e90| 68 65 20 73 61 6d 65 20 | 73 79 6e 74 61 63 74 69 |he same |syntacti|
|00000ea0| 63 20 66 75 6e 63 74 69 | 6f 6e 61 6c 69 74 79 20 |c functi|onality |
|00000eb0| 61 73 20 61 6e 20 6f 72 | 64 69 6e 61 72 79 0d 0a |as an or|dinary..|
|00000ec0| 6e 61 6d 65 20 61 6e 64 | 20 63 61 6e 20 62 65 20 |name and| can be |
|00000ed0| 73 75 62 73 74 69 74 75 | 74 65 64 20 77 68 65 72 |substitu|ted wher|
|00000ee0| 65 76 65 72 20 61 6e 20 | 6f 72 64 69 6e 61 72 79 |ever an |ordinary|
|00000ef0| 20 6e 61 6d 65 20 63 61 | 6e 20 62 65 2e 20 49 6e | name ca|n be. In|
|00000f00| 20 66 61 63 74 0d 0a 71 | 75 69 63 6b 20 6e 61 6d | fact..q|uick nam|
|00000f10| 65 73 20 6c 69 76 65 20 | 69 6e 20 74 68 65 20 73 |es live |in the s|
|00000f20| 61 6d 65 20 6e 61 6d 65 | 73 70 61 63 65 20 61 73 |ame name|space as|
|00000f30| 20 6f 72 64 69 6e 61 72 | 79 20 6d 61 63 72 6f 20 | ordinar|y macro |
|00000f40| 6e 61 6d 65 73 2e 20 46 | 6f 72 20 65 78 61 6d 70 |names. F|or examp|
|00000f50| 6c 65 0d 0a 74 68 65 20 | 71 75 69 63 6b 6e 61 6d |le..the |quicknam|
|00000f60| 65 20 5c 70 7b 40 5c 23 | 41 7d 20 69 73 20 74 68 |e \p{@\#|A} is th|
|00000f70| 65 20 5c 69 7b 73 61 6d | 65 20 6e 61 6d 65 7d 20 |e \i{sam|e name} |
|00000f80| 28 72 65 66 65 72 73 20 | 74 6f 20 74 68 65 20 73 |(refers |to the s|
|00000f90| 61 6d 65 20 6d 61 63 72 | 6f 29 0d 0a 61 73 20 74 |ame macr|o)..as t|
|00000fa0| 68 65 20 6f 72 64 69 6e | 61 72 79 20 6e 61 6d 65 |he ordin|ary name|
|00000fb0| 20 5c 70 7b 40 3c 41 40 | 3e 7d 2e 0d 0a 0d 0a 42 | \p{@<A@|>}.....B|
|00000fc0| 65 63 61 75 73 65 20 71 | 75 69 63 6b 20 6e 61 6d |ecause q|uick nam|
|00000fd0| 65 73 20 6c 6f 6f 6b 20 | 73 79 6e 74 61 63 74 69 |es look |syntacti|
|00000fe0| 63 61 6c 6c 79 20 5c 64 | 71 7b 6f 70 65 6e 7d 20 |cally \d|q{open} |
|00000ff0| 28 5c 69 65 7b 7d 74 68 | 65 79 20 64 6f 20 6e 6f |(\ie{}th|ey do no|
|00001000| 74 20 68 61 76 65 0d 0a | 61 20 63 6c 6f 73 69 6e |t have..|a closin|
|00001010| 67 5c 70 7b 40 3e 7d 20 | 61 73 20 6f 72 64 69 6e |g\p{@>} |as ordin|
|00001020| 61 72 79 20 6e 61 6d 65 | 73 20 64 6f 29 2c 20 69 |ary name|s do), i|
|00001030| 74 20 69 73 20 62 65 73 | 74 20 74 6f 20 61 76 6f |t is bes|t to avo|
|00001040| 69 64 20 74 68 65 6d 20 | 65 78 63 65 70 74 0d 0a |id them |except..|
|00001050| 77 68 65 72 65 20 61 20 | 6d 61 63 72 6f 20 6d 75 |where a |macro mu|
|00001060| 73 74 20 62 65 20 63 61 | 6c 6c 65 64 20 76 65 72 |st be ca|lled ver|
|00001070| 79 20 6f 66 74 65 6e 2e | 0d 0a 0d 0a 5c 73 65 63 |y often.|....\sec|
|00001080| 74 69 6f 6e 7b 46 75 6e | 6e 65 6c 57 65 62 20 74 |tion{Fun|nelWeb t|
|00001090| 68 65 20 4d 61 72 74 69 | 6e 65 74 7d 0d 0a 5c 78 |he Marti|net}..\x|
|000010a0| 78 7b 46 75 6e 6e 65 6c | 57 65 62 7d 7b 72 75 6c |x{Funnel|Web}{rul|
|000010b0| 65 73 7d 5c 78 78 7b 46 | 75 6e 6e 65 6c 57 65 62 |es}\xx{F|unnelWeb|
|000010c0| 7d 7b 6d 61 72 74 69 6e | 65 74 7d 0d 0a 0d 0a 54 |}{martin|et}....T|
|000010d0| 68 65 72 65 20 61 72 65 | 20 6d 61 6e 79 20 77 61 |here are| many wa|
|000010e0| 79 73 20 69 6e 20 77 68 | 69 63 68 20 61 20 6d 61 |ys in wh|ich a ma|
|000010f0| 63 72 6f 20 70 72 65 70 | 72 6f 63 65 73 73 6f 72 |cro prep|rocessor|
|00001100| 20 63 61 6e 20 63 61 75 | 73 65 20 75 6e 65 78 70 | can cau|se unexp|
|00001110| 65 63 74 65 64 0d 0a 64 | 69 66 66 69 63 75 6c 74 |ected..d|ifficult|
|00001120| 69 65 73 2e 20 46 75 6e | 6e 65 6c 57 65 62 20 73 |ies. Fun|nelWeb s|
|00001130| 65 65 6b 73 20 74 6f 20 | 61 76 6f 69 64 20 6d 61 |eeks to |avoid ma|
|00001140| 6e 79 20 6f 66 20 74 68 | 65 73 65 20 70 72 6f 62 |ny of th|ese prob|
|00001150| 6c 65 6d 73 20 62 79 20 | 70 65 72 66 6f 72 6d 69 |lems by |performi|
|00001160| 6e 67 0d 0a 61 20 6e 75 | 6d 62 65 72 20 6f 66 20 |ng..a nu|mber of |
|00001170| 63 68 65 63 6b 73 2e 20 | 54 68 69 73 20 73 65 63 |checks. |This sec|
|00001180| 74 69 6f 6e 20 64 65 73 | 63 72 69 62 65 73 20 73 |tion des|cribes s|
|00001190| 6f 6d 65 20 6f 66 20 74 | 68 65 20 63 68 65 63 6b |ome of t|he check|
|000011a0| 73 20 74 68 61 74 0d 0a | 46 75 6e 6e 65 6c 57 65 |s that..|FunnelWe|
|000011b0| 62 20 70 65 72 66 6f 72 | 6d 73 2e 0d 0a 0d 0a 5c |b perfor|ms.....\|
|000011c0| 6e 61 72 72 6f 77 74 68 | 69 6e 67 7b 54 72 61 69 |narrowth|ing{Trai|
|000011d0| 6c 69 6e 67 20 62 6c 61 | 6e 6b 73 20 69 6e 20 74 |ling bla|nks in t|
|000011e0| 68 65 20 69 6e 70 75 74 | 20 66 69 6c 65 3a 7d 7b |he input| file:}{|
|000011f0| 54 72 61 69 6c 69 6e 67 | 0d 0a 62 6c 61 6e 6b 73 |Trailing|..blanks|
|00001200| 5c 78 78 7b 74 72 61 69 | 6c 69 6e 67 7d 7b 62 6c |\xx{trai|ling}{bl|
|00001210| 61 6e 6b 73 7d 20 61 72 | 65 20 75 73 75 61 6c 6c |anks} ar|e usuall|
|00001220| 79 0d 0a 6e 6f 74 20 64 | 61 6e 67 65 72 6f 75 73 |y..not d|angerous|
|00001230| 2c 20 62 75 74 0d 0a 46 | 75 6e 6e 65 6c 57 65 62 |, but..F|unnelWeb|
|00001240| 20 64 69 73 61 6c 6c 6f | 77 73 20 74 68 65 6d 20 | disallo|ws them |
|00001250| 61 6e 79 77 61 79 2e 20 | 41 6c 6c 20 74 72 61 69 |anyway. |All trai|
|00001260| 6c 69 6e 67 20 62 6c 61 | 6e 6b 73 20 69 6e 20 74 |ling bla|nks in t|
|00001270| 68 65 0d 0a 5c 69 7b 69 | 6e 70 75 74 7d 20 28 5c |he..\i{i|nput} (\|
|00001280| 70 7b 2e 66 77 7d 20 66 | 69 6c 65 29 20 61 72 65 |p{.fw} f|ile) are|
|00001290| 20 66 6c 61 67 67 65 64 | 20 61 73 20 65 72 72 6f | flagged| as erro|
|000012a0| 72 73 20 62 79 20 46 75 | 6e 6e 65 6c 57 65 62 2e |rs by Fu|nnelWeb.|
|000012b0| 0d 0a 46 75 6e 6e 65 6c | 57 65 62 20 64 6f 65 73 |..Funnel|Web does|
|000012c0| 20 6e 6f 74 20 66 6c 61 | 67 20 74 72 61 69 6c 69 | not fla|g traili|
|000012d0| 6e 67 20 62 6c 61 6e 6b | 73 20 69 6e 20 61 6e 79 |ng blank|s in any|
|000012e0| 20 6f 66 20 69 74 73 20 | 6f 75 74 70 75 74 20 66 | of its |output f|
|000012f0| 69 6c 65 73 2e 7d 0d 0a | 0d 0a 5c 6e 61 72 72 6f |iles.}..|..\narro|
|00001300| 77 74 68 69 6e 67 7b 49 | 6e 70 75 74 20 6c 69 6e |wthing{I|nput lin|
|00001310| 65 20 6c 65 6e 67 74 68 | 3a 7d 7b 46 75 6e 6e 65 |e length|:}{Funne|
|00001320| 6c 57 65 62 20 68 61 73 | 20 61 20 6d 61 78 69 6d |lWeb has| a maxim|
|00001330| 75 6d 20 69 6e 70 75 74 | 20 6c 69 6e 65 0d 0a 6c |um input| line..l|
|00001340| 65 6e 67 74 68 2e 5c 78 | 78 7b 69 6e 70 75 74 20 |ength.\x|x{input |
|00001350| 6c 69 6e 65 7d 7b 6c 65 | 6e 67 74 68 7d 0d 0a 49 |line}{le|ngth}..I|
|00001360| 66 20 46 75 6e 6e 65 6c | 57 65 62 20 72 65 61 64 |f Funnel|Web read|
|00001370| 73 20 61 6e 20 69 6e 70 | 75 74 20 6c 69 6e 65 20 |s an inp|ut line |
|00001380| 6c 6f 6e 67 65 72 20 74 | 68 61 6e 20 74 68 69 73 |longer t|han this|
|00001390| 20 6c 65 6e 67 74 68 2c | 20 69 74 20 66 6c 61 67 | length,| it flag|
|000013a0| 73 20 74 68 65 0d 0a 6c | 69 6e 65 20 77 69 74 68 |s the..l|ine with|
|000013b0| 20 61 6e 20 65 72 72 6f | 72 20 6d 65 73 73 61 67 | an erro|r messag|
|000013c0| 65 2e 20 54 68 65 20 6d | 61 78 69 6d 75 6d 20 6c |e. The m|aximum l|
|000013d0| 65 6e 67 74 68 20 63 61 | 6e 20 62 65 20 63 68 61 |ength ca|n be cha|
|000013e0| 6e 67 65 64 20 75 73 69 | 6e 67 20 61 0d 0a 70 72 |nged usi|ng a..pr|
|000013f0| 61 67 6d 61 20 28 73 65 | 65 20 43 68 61 70 74 65 |agma (se|e Chapte|
|00001400| 72 7e 5c 72 65 66 7b 63 | 68 61 70 64 65 66 69 6e |r~\ref{c|hapdefin|
|00001410| 69 74 69 6f 6e 7d 29 2e | 7d 0d 0a 0d 0a 5c 6e 61 |ition}).|}....\na|
|00001420| 72 72 6f 77 74 68 69 6e | 67 7b 50 72 6f 64 75 63 |rrowthin|g{Produc|
|00001430| 74 20 66 69 6c 65 20 6c | 69 6e 65 20 6c 65 6e 67 |t file l|ine leng|
|00001440| 74 68 3a 7d 7b 46 75 6e | 6e 65 6c 57 65 62 0d 0a |th:}{Fun|nelWeb..|
|00001450| 77 61 74 63 68 65 73 20 | 74 68 65 20 6c 65 6e 67 |watches |the leng|
|00001460| 74 68 20 6f 66 20 6f 75 | 74 70 75 74 20 6c 69 6e |th of ou|tput lin|
|00001470| 65 73 5c 78 78 7b 6f 75 | 74 70 75 74 20 6c 69 6e |es\xx{ou|tput lin|
|00001480| 65 7d 7b 6c 65 6e 67 74 | 68 7d 0d 0a 61 6e 64 20 |e}{lengt|h}..and |
|00001490| 61 6c 6c 20 6f 75 74 70 | 75 74 20 6c 69 6e 65 73 |all outp|ut lines|
|000014a0| 20 6c 6f 6e 67 65 72 20 | 74 68 61 6e 20 74 68 65 | longer |than the|
|000014b0| 20 6c 69 6d 69 74 20 61 | 72 65 20 66 6c 61 67 67 | limit a|re flagg|
|000014c0| 65 64 20 77 69 74 68 20 | 65 72 72 6f 72 0d 0a 6d |ed with |error..m|
|000014d0| 65 73 73 61 67 65 73 2e | 0d 0a 54 68 65 20 6d 61 |essages.|..The ma|
|000014e0| 78 69 6d 75 6d 20 6c 65 | 6e 67 74 68 20 63 61 6e |ximum le|ngth can|
|000014f0| 20 62 65 20 63 68 61 6e | 67 65 64 20 75 73 69 6e | be chan|ged usin|
|00001500| 67 20 61 0d 0a 70 72 61 | 67 6d 61 20 28 73 65 65 |g a..pra|gma (see|
|00001510| 20 43 68 61 70 74 65 72 | 7e 5c 72 65 66 7b 63 68 | Chapter|~\ref{ch|
|00001520| 61 70 64 65 66 69 6e 69 | 74 69 6f 6e 7d 29 2e 0d |apdefini|tion})..|
|00001530| 0a 54 68 61 74 20 46 75 | 6e 6e 65 6c 57 65 62 20 |.That Fu|nnelWeb |
|00001540| 70 6f 6c 69 63 65 73 20 | 6f 75 74 70 75 74 20 6c |polices |output l|
|00001550| 69 6e 65 73 20 69 73 20 | 76 65 72 79 20 69 6d 70 |ines is |very imp|
|00001560| 6f 72 74 61 6e 74 2e 20 | 53 6f 6d 65 20 70 72 6f |ortant. |Some pro|
|00001570| 67 72 61 6d 73 0d 0a 63 | 61 6e 20 62 65 68 61 76 |grams..c|an behav|
|00001580| 65 20 76 65 72 79 20 73 | 74 72 61 6e 67 65 6c 79 |e very s|trangely|
|00001590| 20 69 66 20 74 68 65 79 | 20 67 65 74 20 61 6e 20 | if they| get an |
|000015a0| 69 6e 70 75 74 20 6c 69 | 6e 65 20 74 68 61 74 20 |input li|ne that |
|000015b0| 69 73 20 74 6f 6f 20 6c | 6f 6e 67 0d 0a 28 5c 65 |is too l|ong..(\e|
|000015c0| 67 7b 7d 46 6f 72 74 72 | 61 6e 20 63 6f 6d 70 69 |g{}Fortr|an compi|
|000015d0| 6c 65 72 73 5c 78 78 7b | 46 6f 72 74 72 61 6e 7d |lers\xx{|Fortran}|
|000015e0| 7b 63 6f 6d 70 69 6c 65 | 72 73 7d 0d 0a 63 61 6e |{compile|rs}..can|
|000015f0| 20 73 69 6d 70 6c 79 20 | 69 67 6e 6f 72 65 20 74 | simply |ignore t|
|00001600| 65 78 74 20 70 61 73 74 | 20 61 20 63 65 72 74 61 |ext past| a certa|
|00001610| 69 6e 20 63 6f 6c 75 6d | 6e 21 29 0d 0a 61 6e 64 |in colum|n!)..and|
|00001620| 20 6f 6e 63 65 20 46 75 | 6e 6e 65 6c 57 65 62 20 | once Fu|nnelWeb |
|00001630| 73 74 61 72 74 73 20 65 | 78 70 61 6e 64 69 6e 67 |starts e|xpanding|
|00001640| 20 6d 61 63 72 6f 73 20 | 75 73 69 6e 67 20 69 6e | macros |using in|
|00001650| 64 65 6e 74 61 74 69 6f | 6e 2c 20 69 74 20 69 73 |dentatio|n, it is|
|00001660| 20 73 6f 6d 65 74 69 6d | 65 73 0d 0a 6e 6f 74 20 | sometim|es..not |
|00001670| 6f 62 76 69 6f 75 73 20 | 68 6f 77 20 77 69 64 65 |obvious |how wide|
|00001680| 20 74 68 65 20 70 72 6f | 64 75 63 74 20 66 69 6c | the pro|duct fil|
|00001690| 65 20 77 69 6c 6c 20 62 | 65 2e 7d 0d 0a 0d 0a 5c |e will b|e.}....\|
|000016a0| 6e 61 72 72 6f 77 74 68 | 69 6e 67 7b 43 6f 6e 74 |narrowth|ing{Cont|
|000016b0| 72 6f 6c 20 63 68 61 72 | 61 63 74 65 72 73 3a 7d |rol char|acters:}|
|000016c0| 7b 54 68 65 20 70 72 65 | 73 65 6e 63 65 20 6f 66 |{The pre|sence of|
|000016d0| 20 63 6f 6e 74 72 6f 6c | 0d 0a 63 68 61 72 61 63 | control|..charac|
|000016e0| 74 65 72 73 5c 78 78 7b | 63 6f 6e 74 72 6f 6c 7d |ters\xx{|control}|
|000016f0| 7b 63 68 61 72 61 63 74 | 65 72 73 7d 20 69 6e 20 |{charact|ers} in |
|00001700| 61 20 74 65 78 74 20 66 | 69 6c 65 0d 0a 63 61 6e |a text f|ile..can|
|00001710| 20 72 65 73 75 6c 74 20 | 69 6e 20 73 6f 6d 65 20 | result |in some |
|00001720| 63 6f 6e 66 75 73 69 6e | 67 20 62 65 68 61 76 69 |confusin|g behavi|
|00001730| 6f 75 72 20 64 6f 77 6e | 73 74 72 65 61 6d 20 77 |our down|stream w|
|00001740| 68 65 6e 20 74 68 65 20 | 66 69 6c 65 20 69 73 0d |hen the |file is.|
|00001750| 0a 70 72 65 73 65 6e 74 | 65 64 20 74 6f 20 76 61 |.present|ed to va|
|00001760| 72 69 6f 75 73 20 70 72 | 6f 67 72 61 6d 73 2e 20 |rious pr|ograms. |
|00001770| 55 6e 66 6f 72 74 75 6e | 61 74 65 6c 79 2c 20 73 |Unfortun|ately, s|
|00001780| 6f 6d 65 20 74 65 78 74 | 0d 0a 65 64 69 74 6f 72 |ome text|..editor|
|00001790| 73 5c 78 78 7b 74 65 78 | 74 7d 7b 65 64 69 74 6f |s\xx{tex|t}{edito|
|000017a0| 72 73 7d 20 61 6c 6c 6f | 77 0d 0a 63 6f 6e 74 72 |rs} allo|w..contr|
|000017b0| 6f 6c 20 63 68 61 72 61 | 63 74 65 72 73 20 74 6f |ol chara|cters to|
|000017c0| 20 62 65 20 69 6e 73 65 | 72 74 65 64 20 69 6e 74 | be inse|rted int|
|000017d0| 6f 20 74 68 65 20 74 65 | 78 74 20 72 61 74 68 65 |o the te|xt rathe|
|000017e0| 72 20 74 6f 6f 20 65 61 | 73 69 6c 79 2c 20 61 6e |r too ea|sily, an|
|000017f0| 64 20 69 74 20 69 73 0d | 0a 61 6c 6c 20 74 6f 6f |d it is.|.all too|
|00001800| 20 65 61 73 79 20 74 6f | 20 62 65 20 74 72 69 70 | easy to| be trip|
|00001810| 70 65 64 20 75 70 2e 20 | 46 75 6e 6e 65 6c 57 65 |ped up. |FunnelWe|
|00001820| 62 20 70 72 65 76 65 6e | 74 73 20 74 68 65 73 65 |b preven|ts these|
|00001830| 20 70 72 6f 62 6c 65 6d | 73 20 62 79 20 66 6c 61 | problem|s by fla|
|00001840| 67 67 69 6e 67 0d 0a 77 | 69 74 68 20 64 69 61 67 |gging..w|ith diag|
|00001850| 6e 6f 73 74 69 63 73 20 | 61 6c 6c 20 6e 6f 6e 2d |nostics |all non-|
|00001860| 65 6e 64 2d 6f 66 2d 6c | 69 6e 65 20 63 6f 6e 74 |end-of-l|ine cont|
|00001870| 72 6f 6c 20 63 68 61 72 | 61 63 74 65 72 73 20 64 |rol char|acters d|
|00001880| 65 74 65 63 74 65 64 0d | 0a 69 6e 20 74 68 65 20 |etected.|.in the |
|00001890| 69 6e 70 75 74 20 28 5c | 70 7b 2e 66 77 7d 29 20 |input (\|p{.fw}) |
|000018a0| 66 69 6c 65 20 28 65 76 | 65 6e 20 54 41 42 73 5c |file (ev|en TABs\|
|000018b0| 78 7b 74 61 62 73 7d 29 | 2e 0d 0a 54 68 65 20 72 |x{tabs})|...The r|
|000018c0| 65 73 75 6c 74 20 69 73 | 20 74 68 61 74 20 74 68 |esult is| that th|
|000018d0| 65 20 75 73 65 72 20 69 | 73 0d 0a 67 75 61 72 61 |e user i|s..guara|
|000018e0| 6e 74 65 65 64 20 74 68 | 61 74 20 70 72 6f 64 75 |nteed th|at produ|
|000018f0| 63 74 20 66 69 6c 65 73 | 20 67 65 6e 65 72 61 74 |ct files| generat|
|00001900| 65 64 20 66 72 6f 6d 20 | 46 75 6e 6e 65 6c 57 65 |ed from |FunnelWe|
|00001910| 62 20 63 6f 6e 74 61 69 | 6e 20 6e 6f 0d 0a 75 6e |b contai|n no..un|
|00001920| 69 6e 74 65 6e 74 69 6f | 6e 61 6c 20 63 6f 6e 74 |intentio|nal cont|
|00001930| 72 6f 6c 20 63 68 61 72 | 61 63 74 65 72 73 2e 20 |rol char|acters. |
|00001940| 54 68 69 73 20 73 61 69 | 64 2c 20 46 75 6e 6e 65 |This sai|d, Funne|
|00001950| 6c 57 65 62 20 64 6f 65 | 73 20 61 6c 6c 6f 77 20 |lWeb doe|s allow |
|00001960| 74 68 65 0d 0a 69 6e 73 | 65 72 74 69 6f 6e 20 6f |the..ins|ertion o|
|00001970| 66 20 63 6f 6e 74 72 6f | 6c 20 63 68 61 72 61 63 |f contro|l charac|
|00001980| 74 65 72 73 20 69 6e 20 | 74 68 65 20 6f 75 74 70 |ters in |the outp|
|00001990| 75 74 20 66 69 6c 65 20 | 62 79 20 65 78 70 6c 69 |ut file |by expli|
|000019a0| 63 69 74 6c 79 0d 0a 73 | 70 65 63 69 66 79 69 6e |citly..s|pecifyin|
|000019b0| 67 0d 0a 74 68 65 6d 20 | 69 6e 20 74 68 65 20 74 |g..them |in the t|
|000019c0| 65 78 74 20 75 73 69 6e | 67 20 61 20 5c 70 7b 40 |ext usin|g a \p{@|
|000019d0| 5c 63 69 72 63 75 6d 66 | 6c 65 78 7b 7d 7d 20 63 |\circumf|lex{}} c|
|000019e0| 6f 6e 74 72 6f 6c 20 73 | 65 71 75 65 6e 63 65 2e |ontrol s|equence.|
|000019f0| 7d 0d 0a 0d 0a 5c 6e 61 | 72 72 6f 77 74 68 69 6e |}....\na|rrowthin|
|00001a00| 67 7b 4e 75 6d 62 65 72 | 20 6f 66 20 69 6e 76 6f |g{Number| of invo|
|00001a10| 63 61 74 69 6f 6e 73 3a | 7d 7b 46 75 6e 6e 65 6c |cations:|}{Funnel|
|00001a20| 57 65 62 0d 0a 63 68 65 | 63 6b 73 20 74 68 65 20 |Web..che|cks the |
|00001a30| 6e 75 6d 62 65 72 20 6f | 66 20 74 69 6d 65 73 20 |number o|f times |
|00001a40| 74 68 61 74 5c 78 78 7b | 69 6e 76 6f 63 61 74 69 |that\xx{|invocati|
|00001a50| 6f 6e 73 7d 7b 6e 75 6d | 62 65 72 7d 0d 0a 65 61 |ons}{num|ber}..ea|
|00001a60| 63 68 20 6d 61 63 72 6f | 20 69 73 20 63 61 6c 6c |ch macro| is call|
|00001a70| 65 64 20 61 6e 64 20 69 | 73 73 75 65 73 20 61 6e |ed and i|ssues an|
|00001a80| 20 65 72 72 6f 72 20 69 | 66 20 74 68 65 20 74 6f | error i|f the to|
|00001a90| 74 61 6c 20 69 73 20 6e | 6f 74 20 6f 6e 65 2e 20 |tal is n|ot one. |
|00001aa0| 54 68 65 0d 0a 5c 70 7b | 40 5a 7d 20 28 66 6f 72 |The..\p{|@Z} (for|
|00001ab0| 20 7a 65 72 6f 29 20 61 | 6e 64 20 5c 70 7b 40 4d | zero) a|nd \p{@M|
|00001ac0| 7d 20 28 66 6f 72 20 6d | 61 6e 79 29 20 6d 61 63 |} (for m|any) mac|
|00001ad0| 72 6f 20 61 74 74 72 69 | 62 75 74 65 73 20 63 61 |ro attri|butes ca|
|00001ae0| 6e 20 62 65 20 75 73 65 | 64 0d 0a 74 6f 20 62 79 |n be use|d..to by|
|00001af0| 70 61 73 73 20 74 68 65 | 73 65 20 63 68 65 63 6b |pass the|se check|
|00001b00| 73 2e 7d 0d 0a 0d 0a 5c | 6e 61 72 72 6f 77 74 68 |s.}....\|narrowth|
|00001b10| 69 6e 67 7b 52 65 63 75 | 72 73 69 6f 6e 3a 7d 7b |ing{Recu|rsion:}{|
|00001b20| 42 65 63 61 75 73 65 5c | 78 78 7b 72 65 63 75 72 |Because\|xx{recur|
|00001b30| 73 69 6f 6e 7d 7b 6d 61 | 63 72 6f 7d 0d 0a 46 75 |sion}{ma|cro}..Fu|
|00001b40| 6e 6e 65 6c 57 65 62 20 | 64 6f 65 73 20 6e 6f 74 |nnelWeb |does not|
|00001b50| 20 70 72 6f 76 69 64 65 | 20 61 6e 79 20 63 6f 6e | provide| any con|
|00001b60| 64 69 74 69 6f 6e 61 6c | 0d 0a 63 6f 6e 73 74 72 |ditional|..constr|
|00001b70| 75 63 74 73 2c 20 61 6c | 6c 20 72 65 63 75 72 73 |ucts, al|l recurs|
|00001b80| 69 76 65 6c 79 20 64 65 | 66 69 6e 65 64 20 6d 61 |ively de|fined ma|
|00001b90| 63 72 6f 73 20 6d 75 73 | 74 2c 20 62 79 0d 0a 64 |cros mus|t, by..d|
|00001ba0| 65 66 69 6e 69 74 69 6f | 6e 2c 20 65 78 70 61 6e |efinitio|n, expan|
|00001bb0| 64 20 69 6e 66 69 6e 69 | 74 65 6c 79 2c 5c 66 6f |d infini|tely,\fo|
|00001bc0| 6f 74 6e 6f 74 65 7b 41 | 20 73 70 65 63 69 61 6c |otnote{A| special|
|00001bd0| 20 63 61 73 65 20 65 78 | 69 73 74 73 20 77 68 65 | case ex|ists whe|
|00001be0| 72 65 0d 0a 74 68 65 72 | 65 20 69 73 20 72 65 63 |re..ther|e is rec|
|00001bf0| 75 72 73 69 6f 6e 20 62 | 75 74 20 6e 6f 20 63 6f |ursion b|ut no co|
|00001c00| 6e 74 65 6e 74 2e 20 49 | 6e 20 74 68 69 73 20 63 |ntent. I|n this c|
|00001c10| 61 73 65 2c 20 74 68 65 | 20 65 78 70 61 6e 73 69 |ase, the| expansi|
|00001c20| 6f 6e 20 69 73 20 66 69 | 6e 69 74 65 0d 0a 28 74 |on is fi|nite..(t|
|00001c30| 68 65 20 65 6d 70 74 79 | 20 73 74 72 69 6e 67 29 |he empty| string)|
|00001c40| 20 65 76 65 6e 20 74 68 | 6f 75 67 68 20 74 68 65 | even th|ough the|
|00001c50| 20 6f 70 65 72 61 74 69 | 6f 6e 20 6f 66 20 65 78 | operati|on of ex|
|00001c60| 70 61 6e 64 69 6e 67 20 | 69 73 20 69 6e 66 69 6e |panding |is infin|
|00001c70| 69 74 65 2e 0d 0a 46 75 | 6e 6e 65 6c 57 65 62 20 |ite...Fu|nnelWeb |
|00001c80| 64 6f 65 73 20 6e 6f 74 | 20 74 72 65 61 74 20 74 |does not| treat t|
|00001c90| 68 69 73 20 63 61 73 65 | 20 73 70 65 63 69 61 6c |his case| special|
|00001ca0| 6c 79 2e 7d 20 61 6e 64 | 20 61 72 65 20 74 68 65 |ly.} and| are the|
|00001cb0| 72 65 66 6f 72 65 0d 0a | 75 6e 61 63 63 65 70 74 |refore..|unaccept|
|00001cc0| 61 62 6c 65 2e 20 46 75 | 6e 6e 65 6c 57 65 62 20 |able. Fu|nnelWeb |
|00001cd0| 70 65 72 66 6f 72 6d 73 | 20 5c 69 7b 73 74 61 74 |performs| \i{stat|
|00001ce0| 69 63 7d 20 63 68 65 63 | 6b 73 20 74 6f 20 64 65 |ic} chec|ks to de|
|00001cf0| 74 65 63 74 20 72 65 63 | 75 72 73 69 6f 6e 2c 0d |tect rec|ursion,.|
|00001d00| 0a 64 65 74 65 63 74 69 | 6e 67 20 69 74 20 62 65 |.detecti|ng it be|
|00001d10| 66 6f 72 65 20 6d 61 63 | 72 6f 20 65 78 70 61 6e |fore mac|ro expan|
|00001d20| 73 69 6f 6e 20 63 6f 6d | 6d 65 6e 63 65 73 2e 20 |sion com|mences. |
|00001d30| 54 68 65 20 75 73 65 72 | 20 6e 65 65 64 20 6e 6f |The user| need no|
|00001d40| 74 20 66 65 61 72 20 74 | 68 61 74 0d 0a 46 75 6e |t fear t|hat..Fun|
|00001d50| 6e 65 6c 57 65 62 20 77 | 69 6c 6c 20 6c 6f 63 6b |nelWeb w|ill lock|
|00001d60| 20 75 70 20 6f 72 20 73 | 70 65 77 20 66 6f 72 74 | up or s|pew fort|
|00001d70| 68 0d 0a 69 66 20 61 20 | 72 65 63 75 72 73 69 76 |h..if a |recursiv|
|00001d80| 65 20 6d 61 63 72 6f 20 | 69 73 20 61 63 63 69 64 |e macro |is accid|
|00001d90| 65 6e 74 61 6c 6c 79 20 | 73 70 65 63 69 66 69 65 |entally |specifie|
|00001da0| 64 2e 7d 0d 0a 0d 0a 5c | 73 65 63 74 69 6f 6e 7b |d.}....\|section{|
|00001db0| 46 69 64 64 6c 69 6e 67 | 20 57 69 74 68 20 45 6e |Fiddling| With En|
|00001dc0| 64 20 6f 66 20 4c 69 6e | 65 73 7d 0d 0a 5c 78 78 |d of Lin|es}..\xx|
|00001dd0| 7b 45 4f 4c 7d 7b 66 69 | 64 64 6c 69 6e 67 20 77 |{EOL}{fi|ddling w|
|00001de0| 69 74 68 7d 5c 78 78 7b | 65 6e 64 2d 6f 66 2d 6c |ith}\xx{|end-of-l|
|00001df0| 69 6e 65 7d 7b 66 69 64 | 64 6c 69 6e 67 20 77 69 |ine}{fid|dling wi|
|00001e00| 74 68 7d 5c 78 7b 73 70 | 61 63 69 6e 67 7d 0d 0a |th}\x{sp|acing}..|
|00001e10| 0d 0a 4f 6e 65 20 6f 66 | 20 74 68 65 20 20 66 69 |..One of| the fi|
|00001e20| 64 64 6c 79 20 61 73 70 | 65 63 74 73 20 6f 66 20 |ddly asp|ects of |
|00001e30| 70 72 6f 67 72 61 6d 6d | 69 6e 67 20 20 77 69 74 |programm|ing wit|
|00001e40| 68 20 46 75 6e 6e 65 6c | 57 65 62 20 69 73 20 63 |h Funnel|Web is c|
|00001e50| 6f 70 69 6e 67 20 20 77 | 69 74 68 20 65 6e 64 20 |oping w|ith end |
|00001e60| 6f 66 0d 0a 6c 69 6e 65 | 73 2e 20 49 66 20 20 79 |of..line|s. If y|
|00001e70| 6f 75 20 77 61 6e 74 20 | 20 79 6f 75 72 20 70 72 |ou want | your pr|
|00001e80| 6f 64 75 63 74 20 66 69 | 6c 65 20 74 6f 20 62 65 |oduct fi|le to be|
|00001e90| 20 20 77 65 6c 6c 20 69 | 6e 64 65 6e 74 65 64 20 | well i|ndented |
|00001ea0| 77 69 74 68 6f 75 74 0d | 0a 6d 75 6c 74 69 70 6c |without.|.multipl|
|00001eb0| 65 20 62 6c 61 6e 6b 20 | 6c 69 6e 65 73 20 20 6f |e blank |lines o|
|00001ec0| 72 20 63 6f 64 65 20 72 | 75 6e 2d 6f 6e 73 2c 20 |r code r|un-ons, |
|00001ed0| 20 79 6f 75 20 68 61 76 | 65 20 74 6f 20 73 70 65 | you hav|e to spe|
|00001ee0| 6e 64 20 61 20 20 6c 69 | 74 74 6c 65 20 74 69 6d |nd a li|ttle tim|
|00001ef0| 65 20 77 6f 72 6b 69 6e | 67 0d 0a 6f 75 74 20 68 |e workin|g..out h|
|00001f00| 6f 77 20 74 68 65 20 65 | 6e 64 20 6f 66 20 6c 69 |ow the e|nd of li|
|00001f10| 6e 65 20 6d 61 72 6b 65 | 72 73 20 67 65 74 20 6d |ne marke|rs get m|
|00001f20| 6f 76 65 64 20 61 72 6f | 75 6e 64 2e 0d 0a 0d 0a |oved aro|und.....|
|00001f30| 54 68 65 20 72 75 6c 65 | 20 20 74 6f 20 72 65 6d |The rule| to rem|
|00001f40| 65 6d 62 65 72 20 69 73 | 20 74 68 61 74 2c 0d 0a |ember is| that,..|
|00001f50| 64 69 73 72 65 67 61 72 | 64 69 6e 67 20 74 68 65 |disregar|ding the|
|00001f60| 20 20 65 66 66 65 63 74 | 73 20 6f 66 20 20 73 70 | effect|s of sp|
|00001f70| 65 63 69 61 6c 20 73 65 | 71 75 65 6e 63 65 73 0d |ecial se|quences.|
|00001f80| 0a 77 69 74 68 69 6e 20 | 61 20 6d 61 63 72 6f 20 |.within |a macro |
|00001f90| 62 6f 64 79 2c 20 5c 69 | 7b 74 68 65 20 62 6f 64 |body, \i|{the bod|
|00001fa0| 79 20 6f 66 20 61 20 6d | 61 63 72 6f 20 63 6f 6e |y of a m|acro con|
|00001fb0| 73 69 73 74 73 20 6f 66 | 20 65 78 61 63 74 6c 79 |sists of| exactly|
|00001fc0| 20 74 68 65 20 74 65 78 | 74 0d 0a 62 65 74 77 65 | the tex|t..betwe|
|00001fd0| 65 6e 20 74 68 65 20 6f | 70 65 6e 69 6e 67 20 5c |en the o|pening \|
|00001fe0| 70 7b 40 5c 7b 7d 20 61 | 6e 64 20 74 68 65 20 20 |p{@\{} a|nd the |
|00001ff0| 63 6c 6f 73 69 6e 67 20 | 5c 70 7b 40 5c 7d 7d 7d |closing |\p{@\}}}|
|00002000| 2e 20 54 68 69 73 20 74 | 65 78 74 20 69 6e 63 6c |. This t|ext incl|
|00002010| 75 64 65 73 20 65 6e 64 | 20 6f 66 0d 0a 6c 69 6e |udes end| of..lin|
|00002020| 65 20 6d 61 72 6b 65 72 | 73 2e 0d 0a 0d 0a 49 66 |e marker|s.....If|
|00002030| 20 66 6f 72 20 65 78 61 | 6d 70 6c 65 20 79 6f 75 | for exa|mple you|
|00002040| 20 63 61 6c 6c 20 61 20 | 6d 61 63 72 6f 20 69 6e | call a |macro in|
|00002050| 20 61 20 73 65 71 75 65 | 6e 63 65 20 6f 66 20 63 | a seque|nce of c|
|00002060| 6f 64 65 24 5c 6c 64 6f | 74 73 24 0d 0a 0d 0a 5c |ode$\ldo|ts$....\|
|00002070| 62 65 67 69 6e 7b 76 65 | 72 62 61 74 69 6d 7d 0d |begin{ve|rbatim}.|
|00002080| 0a 77 68 69 6c 65 20 74 | 68 65 5f 77 61 6c 72 75 |.while t|he_walru|
|00002090| 73 5f 69 73 5f 73 6c 65 | 65 70 79 20 64 6f 0d 0a |s_is_sle|epy do..|
|000020a0| 20 20 20 62 65 67 69 6e | 0d 0a 20 20 20 77 72 69 | begin|.. wri|
|000020b0| 74 65 6c 6e 28 27 7a 7a | 7a 7a 7a 7a 7a 27 29 3b |teln('zz|zzzzz');|
|000020c0| 0d 0a 20 20 20 40 3c 57 | 61 6b 65 20 75 70 20 74 |.. @<W|ake up t|
|000020d0| 68 65 20 77 61 6c 72 75 | 73 40 3e 0d 0a 20 20 20 |he walru|s@>.. |
|000020e0| 77 72 69 74 65 6c 6e 28 | 27 55 6d 70 68 61 72 75 |writeln(|'Umpharu|
|000020f0| 6d 70 68 61 2e 2e 2e 27 | 29 3b 0d 0a 20 20 20 65 |mpha...'|);.. e|
|00002100| 6e 64 3b 0d 0a 5c 65 6e | 64 7b 76 65 72 62 61 74 |nd;..\en|d{verbat|
|00002110| 69 6d 7d 0d 0a 0d 0a 77 | 68 65 72 65 20 5c 70 7b |im}....w|here \p{|
|00002120| 3c 77 61 6b 65 20 75 70 | 20 74 68 65 20 77 61 6c |<wake up| the wal|
|00002130| 72 75 73 3e 7d 20 69 73 | 20 64 65 66 69 6e 65 64 |rus>} is| defined|
|00002140| 20 61 73 20 66 6f 6c 6c | 6f 77 73 0d 0a 0d 0a 5c | as foll|ows....\|
|00002150| 62 65 67 69 6e 7b 76 65 | 72 62 61 74 69 6d 7d 0d |begin{ve|rbatim}.|
|00002160| 0a 40 24 40 3c 57 61 6b | 65 20 75 70 20 74 68 65 |.@$@<Wak|e up the|
|00002170| 20 77 61 6c 72 75 73 40 | 3e 3d 3d 40 7b 0d 0a 77 | walrus@|>==@{..w|
|00002180| 61 6b 65 5f 75 70 5f 74 | 68 65 5f 77 61 6c 72 75 |ake_up_t|he_walru|
|00002190| 73 28 74 68 65 5f 77 61 | 6c 72 75 73 29 3b 0d 0a |s(the_wa|lrus);..|
|000021a0| 40 7d 0d 0a 5c 65 6e 64 | 7b 76 65 72 62 61 74 69 |@}..\end|{verbati|
|000021b0| 6d 7d 0d 0a 0d 0a 74 68 | 65 6e 20 77 68 65 6e 20 |m}....th|en when |
|000021c0| 5c 70 7b 3c 57 61 6b 65 | 20 75 70 20 74 68 65 20 |\p{<Wake| up the |
|000021d0| 77 61 6c 72 75 73 3e 7d | 20 69 73 20 65 78 70 61 |walrus>}| is expa|
|000021e0| 6e 64 65 64 20 79 6f 75 | 20 77 69 6c 6c 20 67 65 |nded you| will ge|
|000021f0| 74 0d 0a 0d 0a 5c 62 65 | 67 69 6e 7b 76 65 72 62 |t....\be|gin{verb|
|00002200| 61 74 69 6d 7d 0d 0a 77 | 68 69 6c 65 20 74 68 65 |atim}..w|hile the|
|00002210| 5f 77 61 6c 72 75 73 5f | 69 73 5f 73 6c 65 65 70 |_walrus_|is_sleep|
|00002220| 79 20 64 6f 0d 0a 20 20 | 20 62 65 67 69 6e 0d 0a |y do.. | begin..|
|00002230| 20 20 20 77 72 69 74 65 | 6c 6e 28 22 7a 7a 7a 7a | write|ln("zzzz|
|00002240| 7a 7a 7a 22 29 3b 0d 0a | 0d 0a 20 20 20 77 61 6b |zzz");..|.. wak|
|00002250| 65 5f 75 70 5f 74 68 65 | 5f 77 61 6c 72 75 73 28 |e_up_the|_walrus(|
|00002260| 74 68 65 5f 77 61 6c 72 | 75 73 29 3b 0d 0a 0d 0a |the_walr|us);....|
|00002270| 20 20 20 77 72 69 74 65 | 6c 6e 28 22 55 6d 70 68 | write|ln("Umph|
|00002280| 61 72 75 6d 70 68 61 2e | 2e 2e 22 29 3b 0d 0a 20 |arumpha.|..");.. |
|00002290| 20 20 65 6e 64 3b 0d 0a | 5c 65 6e 64 7b 76 65 72 | end;..|\end{ver|
|000022a0| 62 61 74 69 6d 7d 0d 0a | 0d 0a 54 68 65 20 62 6c |batim}..|..The bl|
|000022b0| 61 6e 6b 20 20 6c 69 6e | 65 73 20 77 65 72 65 20 |ank lin|es were |
|000022c0| 20 69 6e 74 72 6f 64 75 | 63 65 64 20 62 79 20 20 | introdu|ced by |
|000022d0| 74 68 65 20 65 6e 64 20 | 20 6f 6e 20 6c 69 6e 65 |the end | on line|
|000022e0| 20 20 6d 61 72 6b 65 72 | 73 20 69 6e 63 6c 75 64 | marker|s includ|
|000022f0| 65 64 20 20 69 6e 20 74 | 68 65 0d 0a 64 65 66 69 |ed in t|he..defi|
|00002300| 6e 69 74 69 6f 6e 20 6f | 66 20 5c 70 7b 3c 57 61 |nition o|f \p{<Wa|
|00002310| 6b 65 20 20 75 70 20 74 | 68 65 20 77 61 6c 72 75 |ke up t|he walru|
|00002320| 73 3e 7d 2e 20 41 20 20 | 67 6f 6f 64 20 73 6f 6c |s>}. A |good sol|
|00002330| 75 74 69 6f 6e 20 74 6f | 20 74 68 69 73 20 20 70 |ution to| this p|
|00002340| 72 6f 62 6c 65 6d 20 69 | 73 20 74 6f 0d 0a 73 75 |roblem i|s to..su|
|00002350| 70 70 72 65 73 73 20 74 | 68 65 20 65 6e 64 20 6f |ppress t|he end o|
|00002360| 66 20 6c 69 6e 65 20 6d | 61 72 6b 65 72 73 20 62 |f line m|arkers b|
|00002370| 79 20 64 65 66 69 6e 69 | 6e 67 20 74 68 65 20 6d |y defini|ng the m|
|00002380| 61 63 72 6f 20 61 73 20 | 66 6f 6c 6c 6f 77 73 0d |acro as |follows.|
|00002390| 0a 0d 0a 5c 62 65 67 69 | 6e 7b 76 65 72 62 61 74 |...\begi|n{verbat|
|000023a0| 69 6d 7d 0d 0a 40 24 40 | 3c 57 61 6b 65 20 75 70 |im}..@$@|<Wake up|
|000023b0| 20 74 68 65 20 77 61 6c | 72 75 73 40 3e 3d 3d 40 | the wal|rus@>==@|
|000023c0| 7b 40 2d 0d 0a 77 61 6b | 65 5f 75 70 5f 74 68 65 |{@-..wak|e_up_the|
|000023d0| 5f 77 61 6c 72 75 73 28 | 74 68 65 5f 77 61 6c 72 |_walrus(|the_walr|
|000023e0| 75 73 29 3b 40 7d 0d 0a | 5c 65 6e 64 7b 76 65 72 |us);@}..|\end{ver|
|000023f0| 62 61 74 69 6d 7d 0d 0a | 0d 0a 54 68 69 73 20 69 |batim}..|..This i|
|00002400| 73 20 74 68 65 20 75 73 | 75 61 6c 20 66 6f 72 6d |s the us|ual form|
|00002410| 20 6f 66 20 6d 61 63 72 | 6f 20 64 65 66 69 6e 69 | of macr|o defini|
|00002420| 74 69 6f 6e 73 20 69 6e | 20 46 75 6e 6e 65 6c 57 |tions in| FunnelW|
|00002430| 65 62 20 66 69 6c 65 73 | 2e 0d 0a 0d 0a 49 6e 20 |eb files|.....In |
|00002440| 61 64 64 69 74 69 76 65 | 20 6d 61 63 72 6f 73 2c |additive| macros,|
|00002450| 20 74 68 69 73 20 66 6f | 72 6d 61 74 20 20 64 6f | this fo|rmat do|
|00002460| 65 73 20 6e 6f 74 0d 0a | 77 6f 72 6b 20 70 72 6f |es not..|work pro|
|00002470| 70 65 72 6c 79 20 62 65 | 63 61 75 73 65 20 74 68 |perly be|cause th|
|00002480| 65 20 65 6e 64 20 6f 66 | 20 6c 69 6e 65 20 74 68 |e end of| line th|
|00002490| 61 74 20 69 73 20 73 75 | 70 70 72 65 73 73 65 64 |at is su|ppressed|
|000024a0| 20 62 79 20 74 68 65 20 | 74 72 61 69 6c 69 6e 67 | by the |trailing|
|000024b0| 20 5c 70 7b 40 5c 7d 7d | 0d 0a 64 6f 65 73 20 6e | \p{@\}}|..does n|
|000024c0| 6f 74 20 67 65 74 20 72 | 65 70 6c 61 63 65 64 20 |ot get r|eplaced |
|000024d0| 62 79 20 74 68 65 20 65 | 6e 64 20 6f 66 20 6c 69 |by the e|nd of li|
|000024e0| 6e 65 20 61 74 20 74 68 | 65 20 65 6e 64 20 6f 66 |ne at th|e end of|
|000024f0| 20 74 68 65 20 6d 61 63 | 72 6f 20 69 6e 76 6f 63 | the mac|ro invoc|
|00002500| 61 74 69 6f 6e 2e 20 46 | 6f 72 0d 0a 65 78 61 6d |ation. F|or..exam|
|00002510| 70 6c 65 20 74 68 65 20 | 64 65 66 69 6e 69 74 69 |ple the |definiti|
|00002520| 6f 6e 0d 0a 0d 0a 5c 62 | 65 67 69 6e 7b 76 65 72 |on....\b|egin{ver|
|00002530| 62 61 74 69 6d 7d 0d 0a | 40 24 40 3c 57 61 6b 65 |batim}..|@$@<Wake|
|00002540| 20 75 70 20 74 68 65 20 | 77 61 6c 72 75 73 40 3e | up the |walrus@>|
|00002550| 2b 3d 40 7b 40 2d 0d 0a | 77 61 6b 65 5f 75 70 5f |+=@{@-..|wake_up_|
|00002560| 74 68 65 5f 77 61 6c 72 | 75 73 5f 6f 6e 63 65 28 |the_walr|us_once(|
|00002570| 74 68 65 5f 77 61 6c 72 | 75 73 29 3b 40 7d 0d 0a |the_walr|us);@}..|
|00002580| 5c 65 6e 64 7b 76 65 72 | 62 61 74 69 6d 7d 0d 0a |\end{ver|batim}..|
|00002590| 0d 0a 6c 61 74 65 72 20 | 66 6f 6c 6c 6f 77 65 64 |..later |followed|
|000025a0| 20 62 79 0d 0a 0d 0a 5c | 62 65 67 69 6e 7b 76 65 | by....\|begin{ve|
|000025b0| 72 62 61 74 69 6d 7d 0d | 0a 40 24 40 3c 57 61 6b |rbatim}.|.@$@<Wak|
|000025c0| 65 20 75 70 20 74 68 65 | 20 77 61 6c 72 75 73 40 |e up the| walrus@|
|000025d0| 3e 2b 3d 40 7b 40 2d 0d | 0a 77 61 6b 65 5f 75 70 |>+=@{@-.|.wake_up|
|000025e0| 5f 74 68 65 5f 77 61 6c | 72 75 73 5f 61 67 61 69 |_the_wal|rus_agai|
|000025f0| 6e 28 74 68 65 5f 77 61 | 6c 72 75 73 29 3b 40 7d |n(the_wa|lrus);@}|
|00002600| 0d 0a 5c 65 6e 64 7b 76 | 65 72 62 61 74 69 6d 7d |..\end{v|erbatim}|
|00002610| 0d 0a 0d 0a 69 73 20 65 | 71 75 69 76 61 6c 65 6e |....is e|quivalen|
|00002620| 74 20 74 6f 20 74 68 65 | 20 73 69 6e 67 6c 65 20 |t to the| single |
|00002630| 64 65 66 69 6e 69 74 69 | 6f 6e 0d 0a 0d 0a 5c 62 |definiti|on....\b|
|00002640| 65 67 69 6e 7b 76 65 72 | 62 61 74 69 6d 7d 0d 0a |egin{ver|batim}..|
|00002650| 40 24 40 3c 57 61 6b 65 | 20 75 70 20 74 68 65 20 |@$@<Wake| up the |
|00002660| 77 61 6c 72 75 73 40 3e | 3d 3d 40 7b 40 2d 0d 0a |walrus@>|==@{@-..|
|00002670| 77 61 6b 65 5f 75 70 5f | 74 68 65 5f 77 61 6c 72 |wake_up_|the_walr|
|00002680| 75 73 5f 6f 6e 63 65 28 | 74 68 65 5f 77 61 6c 72 |us_once(|the_walr|
|00002690| 75 73 29 3b 77 61 6b 65 | 5f 75 70 5f 74 68 65 5f |us);wake|_up_the_|
|000026a0| 77 61 6c 72 75 73 5f 61 | 67 61 69 6e 28 74 68 65 |walrus_a|gain(the|
|000026b0| 5f 77 61 6c 72 75 73 29 | 3b 40 7d 0d 0a 5c 65 6e |_walrus)|;@}..\en|
|000026c0| 64 7b 76 65 72 62 61 74 | 69 6d 7d 0d 0a 0d 0a 50 |d{verbat|im}....P|
|000026d0| 75 74 74 69 6e 67 20 74 | 68 65 20 74 72 61 69 6c |utting t|he trail|
|000026e0| 69 6e 67 20 5c 70 7b 40 | 5c 7d 7d 20 20 6f 6e 20 |ing \p{@|\}} on |
|000026f0| 61 20 6e 65 77 20 6c 69 | 6e 65 20 61 74 20 74 68 |a new li|ne at th|
|00002700| 65 20 65 6e 64 20 6f 66 | 20 20 74 68 65 20 6d 61 |e end of| the ma|
|00002710| 63 72 6f 20 28 65 78 63 | 65 70 74 20 66 6f 72 0d |cro (exc|ept for.|
|00002720| 0a 74 68 65 20 6c 61 73 | 74 20 64 65 66 69 6e 69 |.the las|t defini|
|00002730| 74 69 6f 6e 20 70 61 72 | 74 29 20 73 6f 6c 76 65 |tion par|t) solve|
|00002740| 73 20 74 68 65 20 70 72 | 6f 62 6c 65 6d 2e 0d 0a |s the pr|oblem...|
|00002750| 0d 0a 5c 62 65 67 69 6e | 7b 76 65 72 62 61 74 69 |..\begin|{verbati|
|00002760| 6d 7d 0d 0a 40 24 40 3c | 57 61 6b 65 20 75 70 20 |m}..@$@<|Wake up |
|00002770| 74 68 65 20 77 61 6c 72 | 75 73 40 3e 2b 3d 40 7b |the walr|us@>+=@{|
|00002780| 40 2d 0d 0a 77 61 6b 65 | 5f 75 70 5f 74 68 65 5f |@-..wake|_up_the_|
|00002790| 77 61 6c 72 75 73 5f 6f | 6e 63 65 28 74 68 65 5f |walrus_o|nce(the_|
|000027a0| 77 61 6c 72 75 73 29 3b | 0d 0a 40 7d 0d 0a 5c 65 |walrus);|..@}..\e|
|000027b0| 6e 64 7b 76 65 72 62 61 | 74 69 6d 7d 0d 0a 0d 0a |nd{verba|tim}....|
|000027c0| 6c 61 74 65 72 20 66 6f | 6c 6c 6f 77 65 64 20 62 |later fo|llowed b|
|000027d0| 79 0d 0a 0d 0a 5c 62 65 | 67 69 6e 7b 76 65 72 62 |y....\be|gin{verb|
|000027e0| 61 74 69 6d 7d 0d 0a 40 | 24 40 3c 57 61 6b 65 20 |atim}..@|$@<Wake |
|000027f0| 75 70 20 74 68 65 20 77 | 61 6c 72 75 73 40 3e 2b |up the w|alrus@>+|
|00002800| 3d 40 7b 40 2d 0d 0a 77 | 61 6b 65 5f 75 70 5f 74 |=@{@-..w|ake_up_t|
|00002810| 68 65 5f 77 61 6c 72 75 | 73 5f 61 67 61 69 6e 28 |he_walru|s_again(|
|00002820| 74 68 65 5f 77 61 6c 72 | 75 73 29 3b 40 7d 0d 0a |the_walr|us);@}..|
|00002830| 5c 65 6e 64 7b 76 65 72 | 62 61 74 69 6d 7d 0d 0a |\end{ver|batim}..|
|00002840| 0d 0a 69 73 20 65 71 75 | 69 76 61 6c 65 6e 74 20 |..is equ|ivalent |
|00002850| 74 6f 20 74 68 65 20 73 | 69 6e 67 6c 65 20 64 65 |to the s|ingle de|
|00002860| 66 69 6e 69 74 69 6f 6e | 0d 0a 0d 0a 5c 62 65 67 |finition|....\beg|
|00002870| 69 6e 7b 76 65 72 62 61 | 74 69 6d 7d 0d 0a 40 24 |in{verba|tim}..@$|
|00002880| 40 3c 57 61 6b 65 20 75 | 70 20 74 68 65 20 77 61 |@<Wake u|p the wa|
|00002890| 6c 72 75 73 40 3e 3d 3d | 40 7b 40 2d 0d 0a 77 61 |lrus@>==|@{@-..wa|
|000028a0| 6b 65 5f 75 70 5f 74 68 | 65 5f 77 61 6c 72 75 73 |ke_up_th|e_walrus|
|000028b0| 5f 6f 6e 63 65 28 74 68 | 65 5f 77 61 6c 72 75 73 |_once(th|e_walrus|
|000028c0| 29 3b 0d 0a 77 61 6b 65 | 5f 75 70 5f 74 68 65 5f |);..wake|_up_the_|
|000028d0| 77 61 6c 72 75 73 5f 61 | 67 61 69 6e 28 74 68 65 |walrus_a|gain(the|
|000028e0| 5f 77 61 6c 72 75 73 29 | 3b 40 7d 0d 0a 5c 65 6e |_walrus)|;@}..\en|
|000028f0| 64 7b 76 65 72 62 61 74 | 69 6d 7d 0d 0a 0d 0a 4d |d{verbat|im}....M|
|00002900| 61 6e 61 67 69 6e 67 20 | 65 6e 64 20 6f 66 20 6c |anaging |end of l|
|00002910| 69 6e 65 20 6d 61 72 6b | 65 72 73 20 69 73 20 74 |ine mark|ers is t|
|00002920| 72 69 63 6b 79 2c 0d 0a | 62 75 74 20 6f 6e 63 65 |ricky,..|but once|
|00002930| 20 79 6f 75 20 65 73 74 | 61 62 6c 69 73 68 20 20 | you est|ablish |
|00002940| 61 20 63 6f 6e 76 65 6e | 74 69 6f 6e 20 66 6f 72 |a conven|tion for|
|00002950| 20 63 6f 70 69 6e 67 0d | 0a 77 69 74 68 20 74 68 | coping.|.with th|
|00002960| 65 6d 2c 20 74 68 65 20 | 70 72 6f 62 6c 65 6d 20 |em, the |problem |
|00002970| 64 69 73 61 70 70 65 61 | 72 73 20 69 6e 74 6f 20 |disappea|rs into |
|00002980| 74 68 65 20 62 61 63 6b | 67 72 6f 75 6e 64 2e 0d |the back|ground..|
|00002990| 0a 0d 0a 5c 73 65 63 74 | 69 6f 6e 7b 46 75 64 67 |...\sect|ion{Fudg|
|000029a0| 69 6e 67 20 43 6f 6e 64 | 69 74 69 6f 6e 61 6c 73 |ing Cond|itionals|
|000029b0| 7d 0d 0a 5c 78 78 7b 66 | 75 64 67 69 6e 67 7d 7b |}..\xx{f|udging}{|
|000029c0| 63 6f 6e 64 69 74 69 6f | 6e 61 6c 73 7d 0d 0a 0d |conditio|nals}...|
|000029d0| 0a 41 73 20 61 20 6d 61 | 63 72 6f 20 70 72 65 70 |.As a ma|cro prep|
|000029e0| 72 6f 63 65 73 73 6f 72 | 2c 20 74 68 65 20 66 61 |rocessor|, the fa|
|000029f0| 63 69 6c 69 74 79 20 74 | 68 61 74 20 46 75 6e 6e |cility t|hat Funn|
|00002a00| 65 6c 57 65 62 20 6d 6f | 73 74 20 6f 62 76 69 6f |elWeb mo|st obvio|
|00002a10| 75 73 6c 79 20 6c 61 63 | 6b 73 0d 0a 69 73 20 61 |usly lac|ks..is a|
|00002a20| 20 63 6f 6e 64 69 74 69 | 6f 6e 61 6c 20 66 61 63 | conditi|onal fac|
|00002a30| 69 6c 69 74 79 20 28 73 | 75 63 68 20 61 73 20 43 |ility (s|uch as C|
|00002a40| 27 73 20 5c 70 7b 5c 23 | 69 66 64 65 66 7d 29 2e |'s \p{\#|ifdef}).|
|00002a50| 20 49 74 20 6d 69 67 68 | 74 2c 20 74 68 65 72 65 | It migh|t, there|
|00002a60| 66 6f 72 65 2c 0d 0a 63 | 6f 6d 65 20 61 73 20 61 |fore,..c|ome as a|
|00002a70| 20 73 75 72 70 72 69 73 | 65 20 74 6f 20 6b 6e 6f | surpris|e to kno|
|00002a80| 77 20 74 68 61 74 20 74 | 68 65 20 66 69 72 73 74 |w that t|he first|
|00002a90| 20 76 65 72 73 69 6f 6e | 20 20 6f 66 20 46 75 6e | version| of Fun|
|00002aa0| 6e 65 6c 57 65 62 0d 0a | 61 63 74 75 61 6c 6c 79 |nelWeb..|actually|
|00002ab0| 20 68 61 64 20 61 20 62 | 75 69 6c 74 20 69 6e 20 | had a b|uilt in |
|00002ac0| 63 6f 6e 64 69 74 69 6f | 6e 61 6c 20 66 61 63 69 |conditio|nal faci|
|00002ad0| 6c 69 74 79 2e 20 54 68 | 65 20 66 61 63 69 6c 69 |lity. Th|e facili|
|00002ae0| 74 79 20 61 6c 6c 6f 77 | 65 64 0d 0a 74 68 65 20 |ty allow|ed..the |
|00002af0| 70 72 6f 67 72 61 6d 6d | 65 72 20 74 6f 20 73 70 |programm|er to sp|
|00002b00| 65 63 69 66 79 20 61 20 | 63 6f 6e 73 74 72 75 63 |ecify a |construc|
|00002b10| 74 20 74 68 61 74 20 77 | 6f 75 6c 64 20 73 65 6c |t that w|ould sel|
|00002b20| 65 63 74 20 66 72 6f 6d | 20 6f 6e 65 20 6f 66 20 |ect from| one of |
|00002b30| 61 20 6e 75 6d 62 65 72 | 0d 0a 6f 66 20 6d 61 63 |a number|..of mac|
|00002b40| 72 6f 20 65 78 70 72 65 | 73 73 69 6f 6e 73 20 64 |ro expre|ssions d|
|00002b50| 65 70 65 6e 64 69 6e 67 | 20 6f 6e 20 74 68 65 20 |epending| on the |
|00002b60| 76 61 6c 75 65 20 6f 66 | 20 61 20 63 6f 6e 74 72 |value of| a contr|
|00002b70| 6f 6c 6c 69 6e 67 20 6d | 61 63 72 6f 20 65 78 70 |olling m|acro exp|
|00002b80| 72 65 73 73 69 6f 6e 2e | 0d 0a 0d 0a 49 6e 20 74 |ression.|....In t|
|00002b90| 68 72 65 65 20 79 65 61 | 72 73 20 74 68 65 20 63 |hree yea|rs the c|
|00002ba0| 6f 6e 73 74 72 75 63 74 | 20 77 61 73 20 6e 65 76 |onstruct| was nev|
|00002bb0| 65 72 20 75 73 65 64 2e | 0d 0a 0d 0a 54 68 65 20 |er used.|....The |
|00002bc0| 72 65 61 73 6f 6e 20 77 | 61 73 20 74 68 61 74 20 |reason w|as that |
|00002bd0| 63 6f 6e 64 69 74 69 6f | 6e 61 6c 20 63 6f 6e 73 |conditio|nal cons|
|00002be0| 74 72 75 63 74 73 20 63 | 6f 75 6c 64 20 62 65 20 |tructs c|ould be |
|00002bf0| 66 75 64 67 65 64 20 6e | 65 61 72 6c 79 0d 0a 61 |fudged n|early..a|
|00002c00| 73 20 65 61 73 69 6c 79 | 20 61 73 20 74 68 65 79 |s easily| as they|
|00002c10| 20 63 6f 75 6c 64 20 62 | 65 20 75 73 65 64 2e 20 | could b|e used. |
|00002c20| 42 65 63 61 75 73 65 20 | 6f 66 20 74 68 69 73 2c |Because |of this,|
|00002c30| 20 74 68 65 20 69 6e 62 | 75 69 6c 74 20 63 6f 6e | the inb|uilt con|
|00002c40| 64 69 74 69 6f 6e 61 6c | 0d 0a 66 65 61 74 75 72 |ditional|..featur|
|00002c50| 65 20 77 61 73 20 72 65 | 6d 6f 76 65 64 20 69 6e |e was re|moved in|
|00002c60| 20 74 68 65 20 63 75 72 | 72 65 6e 74 20 76 65 72 | the cur|rent ver|
|00002c70| 73 69 6f 6e 20 6f 66 20 | 46 75 6e 6e 65 6c 57 65 |sion of |FunnelWe|
|00002c80| 62 2e 20 4e 6f 74 20 6f | 6e 6c 79 20 64 69 64 20 |b. Not o|nly did |
|00002c90| 74 68 69 73 0d 0a 73 69 | 6d 70 6c 69 66 79 20 74 |this..si|mplify t|
|00002ca0| 68 65 20 70 72 6f 67 72 | 61 6d 2c 20 62 75 74 20 |he progr|am, but |
|00002cb0| 69 73 20 61 6c 73 6f 20 | 61 6c 6c 6f 77 65 64 20 |is also |allowed |
|00002cc0| 72 65 63 75 72 73 69 76 | 65 20 6d 61 63 72 6f 73 |recursiv|e macros|
|00002cd0| 20 74 6f 20 62 65 20 64 | 65 74 65 63 74 65 64 0d | to be d|etected.|
|00002ce0| 0a 74 68 72 6f 75 67 68 | 20 73 74 61 74 69 63 20 |.through| static |
|00002cf0| 61 6e 61 6c 79 73 69 73 | 20 72 61 74 68 65 72 20 |analysis| rather |
|00002d00| 74 68 61 6e 20 64 75 72 | 69 6e 67 20 6d 61 63 72 |than dur|ing macr|
|00002d10| 6f 20 65 78 70 61 6e 73 | 69 6f 6e 2e 0d 0a 0d 0a |o expans|ion.....|
|00002d20| 54 68 65 72 65 20 61 72 | 65 20 74 77 6f 20 62 61 |There ar|e two ba|
|00002d30| 73 69 63 20 77 61 79 73 | 20 74 6f 20 66 75 64 67 |sic ways| to fudg|
|00002d40| 65 20 61 20 63 6f 6e 64 | 69 74 69 6f 6e 61 6c 2e |e a cond|itional.|
|00002d50| 20 46 69 72 73 74 2c 20 | 74 68 65 20 63 6f 6d 6d | First, |the comm|
|00002d60| 65 6e 74 0d 0a 66 61 63 | 69 6c 69 74 79 20 6f 66 |ent..fac|ility of|
|00002d70| 20 74 68 65 20 74 61 72 | 67 65 74 20 70 72 6f 67 | the tar|get prog|
|00002d80| 72 61 6d 6d 69 6e 67 20 | 6c 61 6e 67 75 61 67 65 |ramming |language|
|00002d90| 20 6d 61 79 20 62 65 20 | 65 6d 70 6c 6f 79 65 64 | may be |employed|
|00002da0| 2e 20 46 6f 72 20 65 78 | 61 6d 70 6c 65 2c 0d 0a |. For ex|ample,..|
|00002db0| 69 6e 20 41 64 61 2c 5c | 78 7b 41 64 61 7d 0d 0a |in Ada,\|x{Ada}..|
|00002dc0| 63 6f 6d 6d 65 6e 74 73 | 20 63 6f 6d 6d 65 6e 63 |comments| commenc|
|00002dd0| 65 20 77 69 74 68 20 5c | 64 71 70 7b 2d 2d 7d 20 |e with \|dqp{--} |
|00002de0| 61 6e 64 20 74 65 72 6d | 69 6e 61 74 65 20 61 74 |and term|inate at|
|00002df0| 20 74 68 65 20 65 6e 64 | 20 6f 66 20 74 68 65 20 | the end| of the |
|00002e00| 6c 69 6e 65 2e 0d 0a 55 | 73 69 6e 67 20 74 68 69 |line...U|sing thi|
|00002e10| 73 20 66 61 63 74 2c 20 | 69 74 20 69 73 20 65 61 |s fact, |it is ea|
|00002e20| 73 79 20 74 6f 20 63 6f | 6e 73 74 72 75 63 74 20 |sy to co|nstruct |
|00002e30| 6d 61 63 72 6f 73 20 74 | 68 61 74 20 63 61 6e 20 |macros t|hat can |
|00002e40| 62 65 20 63 61 6c 6c 65 | 64 20 61 74 20 74 68 65 |be calle|d at the|
|00002e50| 0d 0a 73 74 61 72 74 20 | 6f 66 20 65 61 63 68 20 |..start |of each |
|00002e60| 74 61 72 67 65 74 20 6c | 69 6e 65 20 61 6e 64 20 |target l|ine and |
|00002e70| 77 68 69 63 68 20 74 75 | 72 6e 20 6f 6e 20 61 6e |which tu|rn on an|
|00002e80| 64 20 6f 66 66 20 74 68 | 65 20 6c 69 6e 65 73 20 |d off th|e lines |
|00002e90| 73 6f 0d 0a 6d 61 72 6b | 65 64 20 62 79 20 64 65 |so..mark|ed by de|
|00002ea0| 66 69 6e 69 6e 67 20 74 | 68 65 20 6d 61 63 72 6f |fining t|he macro|
|00002eb0| 20 74 6f 20 62 65 20 74 | 68 65 20 65 6d 70 74 79 | to be t|he empty|
|00002ec0| 20 73 74 72 69 6e 67 20 | 28 4f 4e 29 20 6f 72 20 | string |(ON) or |
|00002ed0| 74 68 65 20 63 6f 6d 6d | 65 6e 74 0d 0a 73 79 6d |the comm|ent..sym|
|00002ee0| 62 6f 6c 20 28 5c 70 7b | 2d 2d 7d 29 20 28 4f 46 |bol (\p{|--}) (OF|
|00002ef0| 46 29 2e 20 46 6f 72 20 | 65 78 61 6d 70 6c 65 3a |F). For |example:|
|00002f00| 0d 0a 0d 0a 5c 62 65 67 | 69 6e 7b 76 65 72 62 61 |....\beg|in{verba|
|00002f10| 74 69 6d 7d 0d 0a 40 41 | 40 3c 44 65 62 75 67 20 |tim}..@A|@<Debug |
|00002f20| 4d 61 63 72 6f 40 3e 0d | 0a 0d 0a 54 68 65 20 66 |Macro@>.|...The f|
|00002f30| 6f 6c 6c 6f 77 69 6e 67 | 20 6d 61 63 72 6f 20 64 |ollowing| macro d|
|00002f40| 65 74 65 72 6d 69 6e 65 | 73 20 77 68 65 74 68 65 |etermine|s whethe|
|00002f50| 72 20 64 65 62 75 67 20 | 63 6f 64 65 20 77 69 6c |r debug |code wil|
|00002f60| 6c 20 62 65 20 69 6e 63 | 6c 75 64 65 64 20 69 6e |l be inc|luded in|
|00002f70| 20 74 68 65 0d 0a 70 72 | 6f 67 72 61 6d 2e 20 41 | the..pr|ogram. A|
|00002f80| 6c 6c 20 6c 69 6e 65 73 | 20 6f 66 20 64 65 62 75 |ll lines| of debu|
|00002f90| 67 20 63 6f 64 65 20 63 | 6f 6d 6d 65 6e 63 65 20 |g code c|ommence |
|00002fa0| 77 69 74 68 20 61 20 63 | 61 6c 6c 20 74 6f 20 74 |with a c|all to t|
|00002fb0| 68 69 73 20 6d 61 63 72 | 6f 20 61 6e 64 20 73 6f |his macr|o and so|
|00002fc0| 0d 0a 77 65 20 63 61 6e | 20 74 75 72 6e 20 61 6c |..we can| turn al|
|00002fd0| 6c 20 74 68 61 74 20 63 | 6f 64 65 20 6f 6e 20 6f |l that c|ode on o|
|00002fe0| 72 20 6f 66 66 20 68 65 | 72 65 20 62 79 20 64 65 |r off he|re by de|
|00002ff0| 66 69 6e 69 6e 67 20 74 | 68 69 73 20 6d 61 63 72 |fining t|his macr|
|00003000| 6f 20 74 6f 20 62 65 20 | 65 69 74 68 65 72 0d 0a |o to be |either..|
|00003010| 65 6d 70 74 79 20 6f 72 | 20 74 68 65 20 73 69 6e |empty or| the sin|
|00003020| 67 6c 65 2d 6c 69 6e 65 | 20 63 6f 6d 6d 65 6e 74 |gle-line| comment|
|00003030| 20 73 79 6d 62 6f 6c 20 | 28 5c 70 7b 2d 2d 7d 29 | symbol |(\p{--})|
|00003040| 2e 20 4e 6f 74 65 20 74 | 68 65 20 75 73 65 20 6f |. Note t|he use o|
|00003050| 66 20 61 0d 0a 71 75 69 | 63 6b 20 6d 61 63 72 6f |f a..qui|ck macro|
|00003060| 20 6e 61 6d 65 2e 0d 0a | 0d 0a 40 24 40 23 44 40 | name...|..@$@#D@|
|00003070| 4d 3d 3d 40 7b 40 7d 20 | 20 20 20 20 40 21 20 54 |M==@{@} | @! T|
|00003080| 75 72 6e 73 20 74 68 65 | 20 64 65 62 75 67 20 63 |urns the| debug c|
|00003090| 6f 64 65 20 4f 4e 2e 0d | 0a 40 21 20 55 73 65 20 |ode ON..|.@! Use |
|000030a0| 74 68 69 73 20 64 65 66 | 69 6e 69 74 69 6f 6e 20 |this def|inition |
|000030b0| 74 6f 20 74 75 72 6e 20 | 74 68 65 20 64 65 62 75 |to turn |the debu|
|000030c0| 67 20 63 6f 64 65 20 4f | 46 46 3a 20 40 24 40 23 |g code O|FF: @$@#|
|000030d0| 44 3d 3d 40 7b 2d 2d 40 | 7d 0d 0a 0d 0a 2e 2e 2e |D==@{--@|}.......|
|000030e0| 20 74 68 65 6e 20 6c 61 | 74 65 72 20 69 6e 20 74 | then la|ter in t|
|000030f0| 68 65 20 66 69 6c 65 2e | 2e 2e 0d 0a 0d 0a 40 24 |he file.|......@$|
|00003100| 40 3c 53 6c 6f 74 68 20 | 69 6e 63 72 65 6d 65 6e |@<Sloth |incremen|
|00003110| 74 69 6e 67 20 6c 6f 6f | 70 40 3e 3d 3d 40 7b 40 |ting loo|p@>==@{@|
|00003120| 2d 0d 0a 77 68 69 6c 65 | 20 73 6c 6f 74 68 3c 77 |-..while| sloth<w|
|00003130| 61 6c 72 75 73 20 6c 6f | 6f 70 0d 0a 20 20 20 40 |alrus lo|op.. @|
|00003140| 23 44 20 61 73 73 65 72 | 74 28 73 6c 6f 74 68 3c |#D asser|t(sloth<|
|00003150| 77 61 6c 72 75 73 2c 22 | 41 57 4b 21 20 73 6c 6f |walrus,"|AWK! slo|
|00003160| 74 68 3e 3d 77 61 6c 72 | 75 73 21 21 21 21 21 21 |th>=walr|us!!!!!!|
|00003170| 21 22 29 3b 0d 0a 20 20 | 20 40 23 44 20 61 73 73 |!");.. | @#D ass|
|00003180| 65 72 74 28 74 69 6d 65 | 72 3c 74 69 6d 65 72 6d |ert(time|r<timerm|
|00003190| 61 78 2c 22 41 57 4b 21 | 20 74 69 6d 65 72 3e 3d |ax,"AWK!| timer>=|
|000031a0| 74 69 6d 65 72 6d 61 78 | 21 21 21 22 29 3b 0d 0a |timermax|!!!");..|
|000031b0| 20 20 20 69 6e 63 28 73 | 6c 6f 74 68 29 3b 0d 0a | inc(s|loth);..|
|000031c0| 65 6e 64 20 6c 6f 6f 70 | 40 7d 0d 0a 5c 65 6e 64 |end loop|@}..\end|
|000031d0| 7b 76 65 72 62 61 74 69 | 6d 7d 0d 0a 0d 0a 54 68 |{verbati|m}....Th|
|000031e0| 65 20 6f 74 68 65 72 20 | 77 61 79 20 74 6f 20 66 |e other |way to f|
|000031f0| 75 64 67 65 20 61 20 63 | 6f 6e 64 69 74 69 6f 6e |udge a c|ondition|
|00003200| 61 6c 20 69 73 20 74 6f | 20 64 65 66 69 6e 65 20 |al is to| define |
|00003210| 61 20 6d 61 63 72 6f 20 | 77 69 74 68 20 61 0d 0a |a macro |with a..|
|00003220| 73 69 6e 67 6c 65 20 70 | 61 72 61 6d 65 74 65 72 |single p|arameter|
|00003230| 2e 20 41 20 63 61 6c 6c | 20 74 6f 20 74 68 65 20 |. A call| to the |
|00003240| 6d 61 63 72 6f 20 69 73 | 20 74 68 65 6e 20 77 72 |macro is| then wr|
|00003250| 61 70 70 65 64 20 61 72 | 6f 75 6e 64 20 61 6c 6c |apped ar|ound all|
|00003260| 20 74 68 65 0d 0a 63 6f | 6e 64 69 74 69 6f 6e 61 | the..co|nditiona|
|00003270| 6c 20 63 6f 64 65 20 69 | 6e 20 74 68 65 20 70 72 |l code i|n the pr|
|00003280| 6f 67 72 61 6d 2e 20 54 | 68 65 20 6d 61 63 72 6f |ogram. T|he macro|
|00003290| 20 63 61 6e 20 74 68 65 | 6e 20 62 65 20 64 65 66 | can the|n be def|
|000032a0| 69 6e 65 64 20 74 6f 0d | 0a 70 72 65 73 65 6e 74 |ined to.|.present|
|000032b0| 20 6f 72 20 69 67 6e 6f | 72 65 20 74 68 65 20 63 | or igno|re the c|
|000032c0| 6f 64 65 20 6f 66 20 69 | 74 73 20 61 72 67 75 6d |ode of i|ts argum|
|000032d0| 65 6e 74 2e 20 46 6f 72 | 20 65 78 61 6d 70 6c 65 |ent. For| example|
|000032e0| 3a 0d 0a 0d 0a 5c 62 65 | 67 69 6e 7b 76 65 72 62 |:....\be|gin{verb|
|000032f0| 61 74 69 6d 7d 0d 0a 40 | 41 40 3c 44 65 62 75 67 |atim}..@|A@<Debug|
|00003300| 20 4d 61 63 72 6f 40 3e | 0d 0a 0d 0a 54 68 65 20 | Macro@>|....The |
|00003310| 66 6f 6c 6c 6f 77 69 6e | 67 20 6d 61 63 72 6f 20 |followin|g macro |
|00003320| 64 65 74 65 72 6d 69 6e | 65 73 20 77 68 65 74 68 |determin|es wheth|
|00003330| 65 72 20 64 65 62 75 67 | 20 63 6f 64 65 20 77 69 |er debug| code wi|
|00003340| 6c 6c 20 62 65 20 69 6e | 63 6c 75 64 65 64 20 69 |ll be in|cluded i|
|00003350| 6e 20 74 68 65 0d 0a 70 | 72 6f 67 72 61 6d 2e 20 |n the..p|rogram. |
|00003360| 41 6c 6c 20 64 65 62 75 | 67 20 63 6f 64 65 20 69 |All debu|g code i|
|00003370| 73 20 77 72 61 70 70 65 | 64 20 62 79 20 61 20 63 |s wrappe|d by a c|
|00003380| 61 6c 6c 20 74 6f 20 74 | 68 69 73 20 6d 61 63 72 |all to t|his macr|
|00003390| 6f 20 61 6e 64 20 73 6f | 0d 0a 77 65 20 63 61 6e |o and so|..we can|
|000033a0| 20 74 75 72 6e 20 61 6c | 6c 20 74 68 65 20 64 65 | turn al|l the de|
|000033b0| 62 75 67 20 63 6f 64 65 | 20 6f 6e 20 6f 72 20 6f |bug code| on or o|
|000033c0| 66 66 20 68 65 72 65 20 | 62 79 20 64 65 66 69 6e |ff here |by defin|
|000033d0| 69 6e 67 20 74 68 69 73 | 20 6d 61 63 72 6f 20 74 |ing this| macro t|
|000033e0| 6f 20 62 65 0d 0a 65 69 | 74 68 65 72 20 65 6d 70 |o be..ei|ther emp|
|000033f0| 74 79 20 6f 72 20 69 74 | 73 20 70 61 72 61 6d 65 |ty or it|s parame|
|00003400| 74 65 72 2e 0d 0a 0d 0a | 40 24 40 23 44 40 28 40 |ter.....|@$@#D@(@|
|00003410| 31 40 29 40 4d 3d 3d 40 | 7b 40 31 40 7d 20 20 20 |1@)@M==@|{@1@} |
|00003420| 20 20 40 21 20 54 75 72 | 6e 73 20 74 68 65 20 64 | @! Tur|ns the d|
|00003430| 65 62 75 67 20 63 6f 64 | 65 20 4f 4e 2e 0d 0a 40 |ebug cod|e ON...@|
|00003440| 21 20 55 73 65 20 74 68 | 69 73 20 64 65 66 69 6e |! Use th|is defin|
|00003450| 69 74 69 6f 6e 20 74 6f | 20 74 75 72 6e 20 74 68 |ition to| turn th|
|00003460| 65 20 64 65 62 75 67 20 | 63 6f 64 65 20 4f 46 46 |e debug |code OFF|
|00003470| 3a 20 40 24 40 23 44 40 | 28 40 31 40 29 3d 3d 40 |: @$@#D@|(@1@)==@|
|00003480| 7b 40 7d 0d 0a 0d 0a 2e | 2e 2e 20 74 68 65 6e 20 |{@}.....|.. then |
|00003490| 6c 61 74 65 72 20 69 6e | 20 74 68 65 20 66 69 6c |later in| the fil|
|000034a0| 65 2e 2e 2e 0d 0a 0d 0a | 40 24 40 3c 53 6c 6f 74 |e.......|@$@<Slot|
|000034b0| 68 20 69 6e 63 72 65 6d | 65 6e 74 69 6e 67 20 6c |h increm|enting l|
|000034c0| 6f 6f 70 40 3e 3d 3d 40 | 7b 40 2d 0d 0a 77 68 69 |oop@>==@|{@-..whi|
|000034d0| 6c 65 20 73 6c 6f 74 68 | 3c 77 61 6c 72 75 73 20 |le sloth|<walrus |
|000034e0| 6c 6f 6f 70 0d 0a 20 20 | 20 40 23 44 40 28 61 73 |loop.. | @#D@(as|
|000034f0| 73 65 72 74 28 73 6c 6f | 74 68 3c 77 61 6c 72 75 |sert(slo|th<walru|
|00003500| 73 2c 22 41 57 4b 21 20 | 73 6c 6f 74 68 3e 3d 77 |s,"AWK! |sloth>=w|
|00003510| 61 6c 72 75 73 21 21 21 | 21 21 21 21 22 29 3b 0d |alrus!!!|!!!!");.|
|00003520| 0a 20 20 20 20 20 20 20 | 20 61 73 73 65 72 74 28 |. | assert(|
|00003530| 74 69 6d 65 72 3c 74 69 | 6d 65 72 6d 61 78 2c 22 |timer<ti|mermax,"|
|00003540| 41 57 4b 21 20 74 69 6d | 65 72 3e 3d 74 69 6d 65 |AWK! tim|er>=time|
|00003550| 72 6d 61 78 21 21 21 22 | 29 3b 40 29 0d 0a 20 20 |rmax!!!"|);@).. |
|00003560| 20 69 6e 63 28 73 6c 6f | 74 68 29 3b 0d 0a 65 6e | inc(slo|th);..en|
|00003570| 64 20 6c 6f 6f 70 40 7d | 0d 0a 5c 65 6e 64 7b 76 |d loop@}|..\end{v|
|00003580| 65 72 62 61 74 69 6d 7d | 0d 0a 0d 0a 49 6e 20 6c |erbatim}|....In l|
|00003590| 61 6e 67 75 61 67 65 73 | 20 74 68 61 74 20 61 6c |anguages| that al|
|000035a0| 6c 6f 77 20 6d 75 6c 74 | 69 2d 6c 69 6e 65 20 63 |low mult|i-line c|
|000035b0| 6f 6d 6d 65 6e 74 73 20 | 28 5c 65 67 7b 7d 43 20 |omments |(\eg{}C |
|000035c0| 77 69 74 68 20 5c 70 7b | 2f 2a 7d 20 61 6e 64 20 |with \p{|/*} and |
|000035d0| 5c 70 7b 2a 2f 7d 29 2c | 0d 0a 63 6f 6d 6d 65 6e |\p{*/}),|..commen|
|000035e0| 74 73 20 63 61 6e 20 62 | 65 20 75 73 65 64 20 74 |ts can b|e used t|
|000035f0| 6f 20 65 6c 69 6d 69 6e | 61 74 65 20 74 68 65 20 |o elimin|ate the |
|00003600| 63 6f 6e 64 69 74 69 6f | 6e 65 64 20 63 6f 64 65 |conditio|ned code|
|00003610| 20 72 61 74 68 65 72 20 | 74 68 61 6e 0d 0a 61 62 | rather |than..ab|
|00003620| 73 65 6e 63 65 2e 20 20 | 46 6f 72 20 65 78 61 6d |sence. |For exam|
|00003630| 70 6c 65 3a 0d 0a 0d 0a | 5c 62 65 67 69 6e 7b 76 |ple:....|\begin{v|
|00003640| 65 72 62 61 74 69 6d 7d | 0d 0a 40 24 40 23 44 40 |erbatim}|..@$@#D@|
|00003650| 28 40 31 40 29 40 4d 3d | 3d 40 7b 2f 2a 20 40 31 |(@1@)@M=|=@{/* @1|
|00003660| 20 2a 2f 40 7d 20 20 20 | 20 40 21 20 43 6f 6d 6d | */@} | @! Comm|
|00003670| 65 6e 74 73 20 6f 75 74 | 20 74 68 65 20 64 65 62 |ents out| the deb|
|00003680| 75 67 20 63 6f 64 65 0d | 0a 5c 65 6e 64 7b 76 65 |ug code.|.\end{ve|
|00003690| 72 62 61 74 69 6d 7d 0d | 0a 0d 0a 28 4e 6f 74 65 |rbatim}.|...(Note|
|000036a0| 3a 20 49 66 20 74 68 69 | 73 20 65 78 61 6d 70 6c |: If thi|s exampl|
|000036b0| 65 20 77 65 72 65 20 65 | 76 65 72 20 61 63 74 75 |e were e|ver actu|
|000036c0| 61 6c 6c 79 20 75 73 65 | 64 2c 0d 0a 74 68 65 20 |ally use|d,..the |
|000036d0| 70 72 6f 67 72 61 6d 6d | 65 72 20 77 6f 75 6c 64 |programm|er would|
|000036e0| 20 68 61 76 65 20 74 6f | 20 62 65 20 63 61 72 65 | have to| be care|
|000036f0| 66 75 6c 20 6e 6f 74 20 | 74 6f 20 70 6c 61 63 65 |ful not |to place|
|00003700| 20 63 6f 6d 6d 65 6e 74 | 73 20 69 6e 0d 0a 74 68 | comment|s in..th|
|00003710| 65 20 61 72 67 75 6d 65 | 6e 74 20 63 6f 64 65 2e |e argume|nt code.|
|00003720| 20 4e 65 73 74 65 64 20 | 63 6f 6d 6d 65 6e 74 73 | Nested |comments|
|00003730| 20 69 6e 7e 43 20 61 72 | 65 20 6e 6f 6e 2d 70 6f | in~C ar|e non-po|
|00003740| 72 74 61 62 6c 65 2e 29 | 0d 0a 0d 0a 54 68 65 20 |rtable.)|....The |
|00003750| 70 61 72 61 6d 65 74 65 | 72 69 7a 65 64 20 6d 61 |paramete|rized ma|
|00003760| 63 72 6f 20 69 64 65 61 | 20 63 61 6e 20 62 65 20 |cro idea| can be |
|00003770| 67 65 6e 65 72 61 6c 69 | 7a 65 64 20 74 6f 20 73 |generali|zed to s|
|00003780| 75 70 70 6f 72 74 20 74 | 68 65 20 63 68 6f 69 63 |upport t|he choic|
|00003790| 65 20 6f 66 0d 0a 6d 6f | 72 65 20 74 68 61 6e 20 |e of..mo|re than |
|000037a0| 6f 6e 65 20 6d 75 74 75 | 61 6c 6c 79 20 65 78 63 |one mutu|ally exc|
|000037b0| 6c 75 73 69 76 65 20 61 | 6c 74 65 72 6e 61 74 69 |lusive a|lternati|
|000037c0| 76 65 2e 20 46 6f 72 20 | 65 78 61 6d 70 6c 65 3a |ve. For |example:|
|000037d0| 0d 0a 0d 0a 5c 62 65 67 | 69 6e 7b 76 65 72 62 61 |....\beg|in{verba|
|000037e0| 74 69 6d 7d 0d 0a 40 41 | 20 54 68 69 73 20 6d 6f |tim}..@A| This mo|
|000037f0| 64 75 6c 65 20 63 6f 6e | 74 61 69 6e 73 20 6e 6f |dule con|tains no|
|00003800| 6e 2d 70 6f 72 74 61 62 | 6c 65 20 63 6f 64 65 20 |n-portab|le code |
|00003810| 74 68 61 74 20 6d 75 73 | 74 20 65 78 65 63 75 74 |that mus|t execut|
|00003820| 65 20 6f 6e 20 48 65 77 | 6c 65 74 74 0d 0a 50 61 |e on Hew|lett..Pa|
|00003830| 63 6b 61 72 64 2c 20 53 | 75 6e 2c 20 61 6e 64 20 |ckard, S|un, and |
|00003840| 44 45 43 20 77 6f 72 6b | 73 74 61 74 69 6f 6e 73 |DEC work|stations|
|00003850| 2e 20 54 68 65 20 66 6f | 6c 6c 6f 77 69 6e 67 20 |. The fo|llowing |
|00003860| 46 75 6e 6e 65 6c 57 65 | 62 20 6d 61 63 72 6f 20 |FunnelWe|b macro |
|00003870| 69 73 0d 0a 64 65 66 69 | 6e 65 64 20 74 6f 20 63 |is..defi|ned to c|
|00003880| 68 6f 6f 73 65 20 62 65 | 74 77 65 65 6e 20 74 68 |hoose be|tween th|
|00003890| 65 73 65 20 74 68 72 65 | 65 2e 20 54 68 65 20 66 |ese thre|e. The f|
|000038a0| 69 72 73 74 20 70 61 72 | 61 6d 65 74 65 72 20 69 |irst par|ameter i|
|000038b0| 73 20 74 68 65 20 48 50 | 20 63 6f 64 65 2c 0d 0a |s the HP| code,..|
|000038c0| 74 68 65 20 73 65 63 6f | 6e 64 20 69 73 20 74 68 |the seco|nd is th|
|000038d0| 65 20 53 75 6e 20 63 6f | 64 65 2c 20 61 6e 64 20 |e Sun co|de, and |
|000038e0| 74 68 65 20 74 68 69 72 | 64 20 69 73 20 74 68 65 |the thir|d is the|
|000038f0| 20 44 45 43 20 63 6f 64 | 65 2e 20 57 68 69 63 68 | DEC cod|e. Which|
|00003900| 65 76 65 72 0d 0a 70 61 | 72 61 6d 65 74 65 72 20 |ever..pa|rameter |
|00003910| 63 6f 6e 73 74 69 74 75 | 74 65 73 20 74 68 65 20 |constitu|tes the |
|00003920| 62 6f 64 79 20 6f 66 20 | 74 68 69 73 20 6d 61 63 |body of |this mac|
|00003930| 72 6f 20 64 65 74 65 72 | 6d 69 6e 65 73 20 77 68 |ro deter|mines wh|
|00003940| 69 63 68 0d 0a 6d 61 63 | 68 69 6e 65 20 74 68 65 |ich..mac|hine the|
|00003950| 20 63 6f 64 65 20 69 73 | 20 62 65 69 6e 67 20 74 | code is| being t|
|00003960| 61 72 67 65 74 65 64 5c | 6e 6f 74 65 7b 44 69 63 |argeted\|note{Dic|
|00003970| 74 69 6f 6e 61 72 79 20 | 73 61 79 73 20 6f 6e 6c |tionary |says onl|
|00003980| 79 20 6f 6e 65 20 74 0d | 0a 69 6e 20 74 61 72 67 |y one t.|.in targ|
|00003990| 65 74 65 64 2e 7d 20 66 | 6f 72 2e 0d 0a 0d 0a 40 |eted.} f|or.....@|
|000039a0| 24 40 3c 4d 61 63 68 69 | 6e 65 20 73 70 65 63 69 |$@<Machi|ne speci|
|000039b0| 66 69 63 20 63 6f 64 65 | 40 3e 40 28 40 33 40 29 |fic code|@>@(@3@)|
|000039c0| 40 4d 3d 3d 40 7b 40 31 | 40 7d 20 20 40 21 20 43 |@M==@{@1|@} @! C|
|000039d0| 6f 6e 66 69 67 75 72 65 | 20 66 6f 72 20 48 50 2e |onfigure| for HP.|
|000039e0| 0d 0a 0d 0a 2e 2e 2e 74 | 68 65 6e 20 6c 61 74 65 |.......t|hen late|
|000039f0| 72 20 69 6e 20 74 68 65 | 20 66 69 6c 65 2e 2e 2e |r in the| file...|
|00003a00| 0d 0a 0d 0a 40 3c 4d 61 | 63 68 69 6e 65 20 73 70 |....@<Ma|chine sp|
|00003a10| 65 63 69 66 69 63 20 63 | 6f 64 65 40 3e 40 28 0d |ecific c|ode@>@(.|
|00003a20| 0a 40 22 67 65 74 5f 63 | 6f 6d 6d 61 6e 64 5f 6c |.@"get_c|ommand_l|
|00003a30| 69 6e 65 28 63 6f 6d 6c | 69 6e 65 29 40 22 20 20 |ine(coml|ine)@" |
|00003a40| 20 20 20 20 20 20 20 20 | 20 40 2c 20 40 21 20 48 | | @, @! H|
|00003a50| 50 2e 0d 0a 40 22 73 63 | 61 6e 5f 63 6f 6d 6d 61 |P...@"sc|an_comma|
|00003a60| 6e 64 5f 6c 69 6e 65 28 | 31 32 38 2c 63 6f 6d 6c |nd_line(|128,coml|
|00003a70| 69 6e 65 29 3b 40 22 20 | 20 20 20 20 40 2c 20 40 |ine);@" | @, @|
|00003a80| 21 20 53 75 6e 2e 0d 0a | 40 22 64 63 6c 5f 67 65 |! Sun...|@"dcl_ge|
|00003a90| 74 5f 63 6f 6d 6d 61 6e | 64 5f 6c 69 6e 65 28 63 |t_comman|d_line(c|
|00003aa0| 6f 6d 6c 69 6e 65 2c 32 | 35 36 29 3b 40 22 20 20 |omline,2|56);@" |
|00003ab0| 40 29 20 40 21 20 44 45 | 43 2e 0d 0a 5c 65 6e 64 |@) @! DE|C...\end|
|00003ac0| 7b 76 65 72 62 61 74 69 | 6d 7d 0d 0a 0d 0a 4f 66 |{verbati|m}....Of|
|00003ad0| 20 63 6f 75 72 73 65 2c | 20 74 68 69 73 20 63 6f | course,| this co|
|00003ae0| 75 6c 64 20 61 6c 73 6f | 20 62 65 20 70 65 72 66 |uld also| be perf|
|00003af0| 6f 72 6d 65 64 20 75 73 | 69 6e 67 20 74 68 72 65 |ormed us|ing thre|
|00003b00| 65 20 73 65 70 61 72 61 | 74 65 20 6d 61 63 72 6f |e separa|te macro|
|00003b10| 73 2e 20 54 68 65 0d 0a | 6d 61 69 6e 20 61 64 76 |s. The..|main adv|
|00003b20| 61 6e 74 61 67 65 20 6f | 66 20 75 73 69 6e 67 20 |antage o|f using |
|00003b30| 61 20 73 69 6e 67 6c 65 | 20 6d 61 63 72 6f 20 69 |a single| macro i|
|00003b40| 73 20 74 68 61 74 20 74 | 68 65 20 6d 75 74 75 61 |s that t|he mutua|
|00003b50| 6c 20 65 78 63 6c 75 73 | 69 76 69 74 79 20 69 73 |l exclus|ivity is|
|00003b60| 0d 0a 65 6e 66 6f 72 63 | 65 64 2e 20 41 6c 73 6f |..enforc|ed. Also|
|00003b70| 2c 20 62 65 63 61 75 73 | 65 20 46 75 6e 6e 65 6c |, becaus|e Funnel|
|00003b80| 57 65 62 20 65 6e 73 75 | 72 65 73 20 74 68 61 74 |Web ensu|res that|
|00003b90| 20 74 68 65 20 6e 75 6d | 62 65 72 20 6f 66 20 66 | the num|ber of f|
|00003ba0| 6f 72 6d 61 6c 20 61 6e | 64 0d 0a 61 63 74 75 61 |ormal an|d..actua|
|00003bb0| 6c 20 70 61 72 61 6d 65 | 74 65 72 73 20 61 72 65 |l parame|ters are|
|00003bc0| 20 74 68 65 20 73 61 6d | 65 2c 20 74 68 69 73 20 | the sam|e, this |
|00003bd0| 6d 65 74 68 6f 64 20 6c | 65 73 73 65 6e 73 20 74 |method l|essens t|
|00003be0| 68 65 20 63 68 61 6e 63 | 65 20 74 68 61 74 20 61 |he chanc|e that a|
|00003bf0| 0d 0a 6d 61 63 68 69 6e | 65 20 77 69 6c 6c 20 62 |..machin|e will b|
|00003c00| 65 20 66 6f 72 67 6f 74 | 74 65 6e 20 69 6e 20 73 |e forgot|ten in s|
|00003c10| 6f 6d 65 20 70 6c 61 63 | 65 73 2e 0d 0a 0d 0a 0d |ome plac|es......|
|00003c20| 0a 5c 73 65 63 74 69 6f | 6e 7b 43 68 61 6e 67 69 |.\sectio|n{Changi|
|00003c30| 6e 67 20 74 68 65 20 53 | 74 72 65 6e 67 74 68 20 |ng the S|trength |
|00003c40| 6f 66 20 48 65 61 64 69 | 6e 67 73 7d 0d 0a 5c 78 |of Headi|ngs}..\x|
|00003c50| 78 7b 68 65 61 64 69 6e | 67 73 7d 7b 73 74 72 65 |x{headin|gs}{stre|
|00003c60| 6e 67 74 68 7d 5c 78 78 | 7b 74 79 70 65 73 65 74 |ngth}\xx|{typeset|
|00003c70| 74 69 6e 67 7d 7b 73 74 | 72 65 6e 67 74 68 7d 25 |ting}{st|rength}%|
|00003c80| 0d 0a 5c 78 78 7b 73 65 | 63 74 69 6f 6e 7d 7b 73 |..\xx{se|ction}{s|
|00003c90| 74 72 65 6e 67 74 68 7d | 5c 78 78 7b 66 6f 6e 74 |trength}|\xx{font|
|00003ca0| 7d 7b 73 69 7a 65 7d 0d | 0a 0d 0a 46 75 6e 6e 65 |}{size}.|...Funne|
|00003cb0| 6c 57 65 62 20 70 72 6f | 76 69 64 65 73 20 66 69 |lWeb pro|vides fi|
|00003cc0| 76 65 20 68 65 61 64 69 | 6e 67 20 6c 65 76 65 6c |ve headi|ng level|
|00003cd0| 73 3a 0d 0a 5c 70 7b 40 | 41 7d 2c 20 5c 70 7b 40 |s:..\p{@|A}, \p{@|
|00003ce0| 42 7d 2c 20 5c 70 7b 40 | 43 7d 2c 20 5c 70 7b 40 |B}, \p{@|C}, \p{@|
|00003cf0| 44 7d 2c 20 61 6e 64 20 | 5c 70 7b 40 45 7d 20 74 |D}, and |\p{@E} t|
|00003d00| 6f 20 77 68 69 63 68 20 | 69 74 20 62 69 6e 64 73 |o which |it binds|
|00003d10| 20 66 69 76 65 20 64 69 | 66 66 65 72 65 6e 74 0d | five di|fferent.|
|00003d20| 0a 74 79 70 6f 67 72 61 | 70 68 69 63 61 6c 20 73 |.typogra|phical s|
|00003d30| 74 72 65 6e 67 74 68 73 | 2e 20 54 68 65 73 65 20 |trengths|. These |
|00003d40| 62 69 6e 64 69 6e 67 73 | 20 61 72 65 20 73 74 61 |bindings| are sta|
|00003d50| 74 69 63 3b 20 61 20 6c | 65 76 65 6c 0d 0a 5c 70 |tic; a l|evel..\p|
|00003d60| 7b 40 41 7d 20 68 65 61 | 64 69 6e 67 20 77 69 6c |{@A} hea|ding wil|
|00003d70| 6c 20 61 6c 77 61 79 73 | 20 62 65 20 74 79 70 65 |l always| be type|
|00003d80| 73 65 74 20 69 6e 20 61 | 20 70 61 72 74 69 63 75 |set in a| particu|
|00003d90| 6c 61 72 20 66 6f 6e 74 | 20 73 69 7a 65 20 72 65 |lar font| size re|
|00003da0| 67 61 72 64 6c 65 73 73 | 0d 0a 6f 66 20 74 68 65 |gardless|..of the|
|00003db0| 20 73 69 7a 65 20 6f 66 | 20 74 68 65 20 64 6f 63 | size of| the doc|
|00003dc0| 75 6d 65 6e 74 2e 20 54 | 68 65 20 66 6f 6e 74 0d |ument. T|he font.|
|00003dd0| 0a 73 69 7a 65 73 20 68 | 61 76 65 20 62 65 65 6e |.sizes h|ave been|
|00003de0| 20 70 72 65 73 65 74 20 | 74 6f 20 62 65 20 5c 64 | preset |to be \d|
|00003df0| 71 7b 72 65 61 73 6f 6e | 61 62 6c 65 7d 20 66 6f |q{reason|able} fo|
|00003e00| 72 20 61 20 72 61 6e 67 | 65 20 6f 66 20 64 6f 63 |r a rang|e of doc|
|00003e10| 75 6d 65 6e 74 20 73 69 | 7a 65 73 2c 0d 0a 62 75 |ument si|zes,..bu|
|00003e20| 74 20 6d 61 79 20 62 65 | 20 69 6e 61 70 70 72 6f |t may be| inappro|
|00003e30| 70 72 69 61 74 65 20 66 | 6f 72 20 76 65 72 79 20 |priate f|or very |
|00003e40| 73 6d 61 6c 6c 20 6f 72 | 20 6c 61 72 67 65 20 64 |small or| large d|
|00003e50| 6f 63 75 6d 65 6e 74 73 | 2e 0d 0a 0d 0a 46 75 6e |ocuments|.....Fun|
|00003e60| 6e 65 6c 57 65 62 20 64 | 6f 65 73 20 6e 6f 74 20 |nelWeb d|oes not |
|00003e70| 63 75 72 72 65 6e 74 6c | 79 20 70 72 6f 76 69 64 |currentl|y provid|
|00003e80| 65 20 61 6e 20 5c 64 71 | 7b 6f 66 66 69 63 69 61 |e an \dq|{officia|
|00003e90| 6c 7d 0d 0a 77 61 79 20 | 28 5c 65 67 7b 7d 61 20 |l}..way |(\eg{}a |
|00003ea0| 70 72 61 67 6d 61 29 20 | 74 6f 20 63 68 61 6e 67 |pragma) |to chang|
|00003eb0| 65 20 74 68 65 20 74 79 | 70 65 73 65 74 74 69 6e |e the ty|pesettin|
|00003ec0| 67 0d 0a 73 74 72 65 6e | 67 74 68 20 6f 66 20 68 |g..stren|gth of h|
|00003ed0| 65 61 64 69 6e 67 73 2e | 20 54 68 69 73 20 66 65 |eadings.| This fe|
|00003ee0| 61 74 75 72 65 20 6d 69 | 67 68 74 20 62 65 20 61 |ature mi|ght be a|
|00003ef0| 64 64 65 64 20 69 6e 20 | 6c 61 74 65 72 20 76 65 |dded in |later ve|
|00003f00| 72 73 69 6f 6e 73 2e 0d | 0a 4d 65 61 6e 77 68 69 |rsions..|.Meanwhi|
|00003f10| 6c 65 2c 20 61 20 68 61 | 63 6b 20 69 73 20 61 76 |le, a ha|ck is av|
|00003f20| 61 69 6c 61 62 6c 65 20 | 74 68 61 74 20 77 69 6c |ailable |that wil|
|00003f30| 6c 20 64 6f 20 74 68 65 | 20 6a 6f 62 2c 20 70 72 |l do the| job, pr|
|00003f40| 6f 76 69 64 69 6e 67 20 | 74 68 61 74 20 79 6f 75 |oviding |that you|
|00003f50| 0d 0a 64 6f 20 6e 6f 74 | 20 6d 69 6e 64 20 74 68 |..do not| mind th|
|00003f60| 65 20 68 61 63 6b 20 62 | 65 69 6e 67 20 5c 54 65 |e hack b|eing \Te|
|00003f70| 58 7b 7d 2d 73 70 65 63 | 69 66 69 63 20 61 6e 64 |X{}-spec|ific and|
|00003f80| 20 70 72 6f 62 61 62 6c | 79 20 46 75 6e 6e 65 6c | probabl|y Funnel|
|00003f90| 57 65 62 2d 76 65 72 73 | 69 6f 6e 0d 0a 73 70 65 |Web-vers|ion..spe|
|00003fa0| 63 69 66 69 63 2e 0d 0a | 0d 0a 49 6e 73 69 64 65 |cific...|..Inside|
|00003fb0| 20 74 68 65 20 73 65 74 | 20 6f 66 20 5c 54 65 58 | the set| of \TeX|
|00003fc0| 7b 7d 20 6d 61 63 72 6f | 20 64 65 66 69 6e 69 74 |{} macro| definit|
|00003fd0| 69 6f 6e 73 0d 0a 74 68 | 61 74 20 46 75 6e 6e 65 |ions..th|at Funne|
|00003fe0| 6c 57 65 62 20 77 72 69 | 74 65 73 20 61 74 20 74 |lWeb wri|tes at t|
|00003ff0| 68 65 20 74 6f 70 20 6f | 66 20 65 76 65 72 79 20 |he top o|f every |
|00004000| 64 6f 63 75 6d 65 6e 74 | 61 74 69 6f 6e 0d 0a 66 |document|ation..f|
|00004010| 69 6c 65 20 61 72 65 20 | 66 69 76 65 20 5c 64 71 |ile are |five \dq|
|00004020| 7b 6c 69 62 72 61 72 79 | 7d 0d 0a 64 65 66 69 6e |{library|}..defin|
|00004030| 69 74 69 6f 6e 73 20 5c | 70 7b 66 77 6c 69 62 61 |itions \|p{fwliba|
|00004040| 7d 24 5c 6c 64 6f 74 73 | 24 5c 70 7b 66 77 6c 69 |}$\ldots|$\p{fwli|
|00004050| 62 65 7d 20 77 68 69 63 | 68 0d 0a 70 72 6f 76 69 |be} whic|h..provi|
|00004060| 64 65 20 66 69 76 65 20 | 64 69 66 66 65 72 65 6e |de five |differen|
|00004070| 74 20 74 79 70 65 73 65 | 74 74 69 6e 67 20 73 74 |t typese|tting st|
|00004080| 72 65 6e 67 74 68 73 20 | 66 6f 72 20 68 65 61 64 |rengths |for head|
|00004090| 69 6e 67 73 2e 20 4e 65 | 61 72 20 74 68 65 0d 0a |ings. Ne|ar the..|
|000040a0| 65 6e 64 20 6f 66 20 74 | 68 65 20 73 65 74 20 6f |end of t|he set o|
|000040b0| 66 20 64 65 66 69 6e 69 | 74 69 6f 6e 73 2c 20 46 |f defini|tions, F|
|000040c0| 75 6e 6e 65 6c 57 65 62 | 20 62 69 6e 64 73 20 74 |unnelWeb| binds t|
|000040d0| 68 65 73 65 20 6d 61 63 | 72 6f 73 20 74 6f 20 66 |hese mac|ros to f|
|000040e0| 69 76 65 0d 0a 6f 74 68 | 65 72 20 6d 61 63 72 6f |ive..oth|er macro|
|000040f0| 73 20 5c 70 7b 66 77 73 | 65 63 61 7d 24 5c 6c 64 |s \p{fws|eca}$\ld|
|00004100| 6f 74 73 24 5c 70 7b 66 | 77 73 65 63 65 7d 20 77 |ots$\p{f|wsece} w|
|00004110| 68 69 63 68 20 61 72 65 | 20 69 6e 76 6f 6b 65 64 |hich are| invoked|
|00004120| 20 64 69 72 65 63 74 6c | 79 20 69 6e 20 74 68 65 | directl|y in the|
|00004130| 0d 0a 67 65 6e 65 72 61 | 74 65 64 20 5c 54 65 58 |..genera|ted \TeX|
|00004140| 7b 7d 20 63 6f 64 65 20 | 74 6f 20 74 79 70 65 73 |{} code |to types|
|00004150| 65 74 20 74 68 65 20 68 | 65 61 64 69 6e 67 73 2e |et the h|eadings.|
|00004160| 0d 0a 0d 0a 5c 62 65 67 | 69 6e 7b 76 65 72 62 61 |....\beg|in{verba|
|00004170| 74 69 6d 7d 0d 0a 5c 64 | 65 66 5c 66 77 73 65 63 |tim}..\d|ef\fwsec|
|00004180| 61 23 31 23 32 7b 5c 66 | 77 6c 69 62 61 7b 23 31 |a#1#2{\f|wliba{#1|
|00004190| 7d 7b 23 32 7d 7d 0d 0a | 5c 64 65 66 5c 66 77 73 |}{#2}}..|\def\fws|
|000041a0| 65 63 62 23 31 23 32 7b | 5c 66 77 6c 69 62 62 7b |ecb#1#2{|\fwlibb{|
|000041b0| 23 31 7d 7b 23 32 7d 7d | 0d 0a 5c 64 65 66 5c 66 |#1}{#2}}|..\def\f|
|000041c0| 77 73 65 63 63 23 31 23 | 32 7b 5c 66 77 6c 69 62 |wsecc#1#|2{\fwlib|
|000041d0| 63 7b 23 31 7d 7b 23 32 | 7d 7d 0d 0a 5c 64 65 66 |c{#1}{#2|}}..\def|
|000041e0| 5c 66 77 73 65 63 64 23 | 31 23 32 7b 5c 66 77 6c |\fwsecd#|1#2{\fwl|
|000041f0| 69 62 64 7b 23 31 7d 7b | 23 32 7d 7d 0d 0a 5c 64 |ibd{#1}{|#2}}..\d|
|00004200| 65 66 5c 66 77 73 65 63 | 65 23 31 23 32 7b 5c 66 |ef\fwsec|e#1#2{\f|
|00004210| 77 6c 69 62 65 7b 23 31 | 7d 7b 23 32 7d 7d 0d 0a |wlibe{#1|}{#2}}..|
|00004220| 5c 65 6e 64 7b 76 65 72 | 62 61 74 69 6d 7d 0d 0a |\end{ver|batim}..|
|00004230| 0d 0a 54 68 69 73 20 6d | 65 61 6e 73 20 74 68 61 |..This m|eans tha|
|00004240| 74 20 74 68 65 20 74 79 | 70 65 73 65 74 74 69 6e |t the ty|pesettin|
|00004250| 67 20 73 74 72 65 6e 67 | 74 68 20 6f 66 20 74 68 |g streng|th of th|
|00004260| 65 20 68 65 61 64 69 6e | 67 73 20 69 6e 20 61 20 |e headin|gs in a |
|00004270| 46 75 6e 6e 65 6c 57 65 | 62 0d 0a 64 6f 63 75 6d |FunnelWe|b..docum|
|00004280| 65 6e 74 20 63 61 6e 20 | 62 65 20 63 68 61 6e 67 |ent can |be chang|
|00004290| 65 64 20 62 79 20 72 65 | 64 65 66 69 6e 69 6e 67 |ed by re|defining|
|000042a0| 20 74 68 65 73 65 20 6d | 61 63 72 6f 73 20 61 74 | these m|acros at|
|000042b0| 20 74 68 65 20 74 6f 70 | 20 6f 66 20 61 20 46 75 | the top| of a Fu|
|000042c0| 6e 6e 65 6c 57 65 62 0d | 0a 64 6f 63 75 6d 65 6e |nnelWeb.|.documen|
|000042d0| 74 2e 20 46 6f 72 20 65 | 78 61 6d 70 6c 65 3a 0d |t. For e|xample:.|
|000042e0| 0a 0d 0a 5c 62 65 67 69 | 6e 7b 76 65 72 62 61 74 |...\begi|n{verbat|
|000042f0| 69 6d 7d 0d 0a 40 70 20 | 74 79 70 65 73 65 74 74 |im}..@p |typesett|
|00004300| 65 72 20 3d 20 74 65 78 | 0d 0a 5c 64 65 66 5c 66 |er = tex|..\def\f|
|00004310| 77 73 65 63 61 23 31 23 | 32 7b 5c 66 77 6c 69 62 |wseca#1#|2{\fwlib|
|00004320| 63 7b 23 31 7d 7b 23 32 | 7d 7d 0d 0a 5c 65 6e 64 |c{#1}{#2|}}..\end|
|00004330| 7b 76 65 72 62 61 74 69 | 6d 7d 0d 0a 0d 0a 77 6f |{verbati|m}....wo|
|00004340| 75 6c 64 20 73 65 74 20 | 5c 70 7b 40 41 7d 20 68 |uld set |\p{@A} h|
|00004350| 65 61 64 69 6e 67 73 20 | 61 74 20 74 68 65 20 73 |eadings |at the s|
|00004360| 61 6d 65 20 73 74 72 65 | 6e 67 74 68 20 61 73 20 |ame stre|ngth as |
|00004370| 74 68 65 20 64 65 66 61 | 75 6c 74 20 73 74 72 65 |the defa|ult stre|
|00004380| 6e 67 74 68 20 6f 66 0d | 0a 5c 70 7b 40 43 7d 20 |ngth of.|.\p{@C} |
|00004390| 68 65 61 64 69 6e 67 73 | 2e 20 54 68 65 20 5c 70 |headings|. The \p|
|000043a0| 7b 74 79 70 65 73 65 74 | 74 65 72 7d 20 64 69 72 |{typeset|ter} dir|
|000043b0| 65 63 74 69 76 65 20 69 | 73 20 6e 65 63 65 73 73 |ective i|s necess|
|000043c0| 61 72 79 20 74 6f 20 65 | 6e 73 75 72 65 20 74 68 |ary to e|nsure th|
|000043d0| 61 74 20 74 68 65 0d 0a | 5c 54 65 58 7b 7d 20 63 |at the..|\TeX{} c|
|000043e0| 6f 6e 74 72 6f 6c 20 73 | 65 71 75 65 6e 63 65 73 |ontrol s|equences|
|000043f0| 20 67 65 74 20 74 68 72 | 6f 75 67 68 20 74 6f 20 | get thr|ough to |
|00004400| 74 68 65 20 64 6f 63 75 | 6d 65 6e 74 61 74 69 6f |the docu|mentatio|
|00004410| 6e 20 66 69 6c 65 20 75 | 6e 66 69 6c 74 65 72 65 |n file u|nfiltere|
|00004420| 64 2e 0d 0a 0d 0a 54 68 | 65 20 66 6f 6c 6c 6f 77 |d.....Th|e follow|
|00004430| 69 6e 67 20 77 69 6c 6c | 20 74 6f 6e 65 20 64 6f |ing will| tone do|
|00004440| 77 6e 20 61 6c 6c 20 68 | 65 61 64 69 6e 67 73 20 |wn all h|eadings |
|00004450| 62 79 20 74 77 6f 20 6c | 65 76 65 6c 73 20 28 77 |by two l|evels (w|
|00004460| 69 74 68 20 74 68 65 0d | 0a 5c 70 7b 40 44 7d 20 |ith the.|.\p{@D} |
|00004470| 61 6e 64 20 5c 70 7b 40 | 45 7d 20 6c 65 76 65 6c |and \p{@|E} level|
|00004480| 73 20 62 65 69 6e 67 20 | 61 6c 6c 6f 63 61 74 65 |s being |allocate|
|00004490| 64 20 74 68 65 20 64 65 | 66 61 75 6c 74 20 5c 70 |d the de|fault \p|
|000044a0| 7b 40 45 7d 20 74 79 70 | 65 73 65 74 74 69 6e 67 |{@E} typ|esetting|
|000044b0| 0d 0a 73 74 72 65 6e 67 | 74 68 20 62 65 63 61 75 |..streng|th becau|
|000044c0| 73 65 20 74 68 65 72 65 | 20 69 73 20 6e 6f 74 68 |se there| is noth|
|000044d0| 69 6e 67 20 77 65 61 6b | 65 72 29 2e 0d 0a 0d 0a |ing weak|er).....|
|000044e0| 5c 62 65 67 69 6e 7b 76 | 65 72 62 61 74 69 6d 7d |\begin{v|erbatim}|
|000044f0| 0d 0a 40 70 20 74 79 70 | 65 73 65 74 74 65 72 20 |..@p typ|esetter |
|00004500| 3d 20 74 65 78 0d 0a 5c | 64 65 66 5c 66 77 73 65 |= tex..\|def\fwse|
|00004510| 63 61 23 31 23 32 7b 5c | 66 77 6c 69 62 63 7b 23 |ca#1#2{\|fwlibc{#|
|00004520| 31 7d 7b 23 32 7d 7d 0d | 0a 5c 64 65 66 5c 66 77 |1}{#2}}.|.\def\fw|
|00004530| 73 65 63 62 23 31 23 32 | 7b 5c 66 77 6c 69 62 64 |secb#1#2|{\fwlibd|
|00004540| 7b 23 31 7d 7b 23 32 7d | 7d 0d 0a 5c 64 65 66 5c |{#1}{#2}|}..\def\|
|00004550| 66 77 73 65 63 63 23 31 | 23 32 7b 5c 66 77 6c 69 |fwsecc#1|#2{\fwli|
|00004560| 62 65 7b 23 31 7d 7b 23 | 32 7d 7d 0d 0a 5c 64 65 |be{#1}{#|2}}..\de|
|00004570| 66 5c 66 77 73 65 63 64 | 23 31 23 32 7b 5c 66 77 |f\fwsecd|#1#2{\fw|
|00004580| 6c 69 62 65 7b 23 31 7d | 7b 23 32 7d 7d 0d 0a 5c |libe{#1}|{#2}}..\|
|00004590| 64 65 66 5c 66 77 73 65 | 63 65 23 31 23 32 7b 5c |def\fwse|ce#1#2{\|
|000045a0| 66 77 6c 69 62 65 7b 23 | 31 7d 7b 23 32 7d 7d 0d |fwlibe{#|1}{#2}}.|
|000045b0| 0a 5c 65 6e 64 7b 76 65 | 72 62 61 74 69 6d 7d 0d |.\end{ve|rbatim}.|
|000045c0| 0a 0d 0a 54 68 65 73 65 | 20 64 65 66 69 6e 69 74 |...These| definit|
|000045d0| 69 6f 6e 73 20 61 66 66 | 65 63 74 20 6f 6e 6c 79 |ions aff|ect only|
|000045e0| 20 74 68 65 20 68 65 61 | 64 69 6e 67 73 20 74 68 | the hea|dings th|
|000045f0| 61 74 20 66 6f 6c 6c 6f | 77 20 74 68 65 6d 2c 20 |at follo|w them, |
|00004600| 61 6e 64 20 73 6f 20 74 | 68 65 79 0d 0a 73 68 6f |and so t|hey..sho|
|00004610| 75 6c 64 20 62 65 20 70 | 6c 61 63 65 64 20 61 74 |uld be p|laced at|
|00004620| 20 74 68 65 20 74 6f 70 | 20 6f 66 20 74 68 65 20 | the top| of the |
|00004630| 46 75 6e 6e 65 6c 57 65 | 62 20 69 6e 70 75 74 20 |FunnelWe|b input |
|00004640| 66 69 6c 65 2e 0d 0a 0d | 0a 5c 73 65 63 74 69 6f |file....|.\sectio|
|00004650| 6e 7b 45 66 66 69 63 69 | 65 6e 63 79 20 4e 6f 74 |n{Effici|ency Not|
|00004660| 65 73 7d 0d 0a 5c 78 78 | 7b 46 75 6e 6e 65 6c 57 |es}..\xx|{FunnelW|
|00004670| 65 62 7d 7b 65 66 66 69 | 63 69 65 6e 63 79 7d 5c |eb}{effi|ciency}\|
|00004680| 78 78 7b 65 66 66 69 63 | 69 65 6e 63 79 7d 7b 6e |xx{effic|iency}{n|
|00004690| 6f 74 65 73 7d 0d 0a 0d | 0a 54 68 65 20 66 6f 6c |otes}...|.The fol|
|000046a0| 6c 6f 77 69 6e 67 20 6e | 6f 74 65 73 20 61 72 65 |lowing n|otes are|
|000046b0| 20 77 6f 72 74 68 20 6b | 65 65 70 69 6e 67 20 69 | worth k|eeping i|
|000046c0| 6e 20 6d 69 6e 64 20 77 | 68 65 6e 20 75 73 69 6e |n mind w|hen usin|
|000046d0| 67 20 46 75 6e 6e 65 6c | 57 65 62 2e 0d 0a 0d 0a |g Funnel|Web.....|
|000046e0| 5c 6e 61 72 72 6f 77 74 | 68 69 6e 67 7b 4d 65 6d |\narrowt|hing{Mem|
|000046f0| 6f 72 79 3a 7d 7b 57 68 | 65 6e 5c 78 7b 6d 65 6d |ory:}{Wh|en\x{mem|
|00004700| 6f 72 79 7d 5c 78 78 7b | 69 6e 70 75 74 7d 7b 66 |ory}\xx{|input}{f|
|00004710| 69 6c 65 73 7d 0d 0a 46 | 75 6e 6e 65 6c 57 65 62 |iles}..F|unnelWeb|
|00004720| 20 70 72 6f 63 65 73 73 | 65 73 20 61 6e 20 69 6e | process|es an in|
|00004730| 70 75 74 20 66 69 6c 65 | 2c 20 69 74 20 72 65 61 |put file|, it rea|
|00004740| 64 73 0d 0a 74 68 65 20 | 65 6e 74 69 72 65 20 69 |ds..the |entire i|
|00004750| 6e 70 75 74 20 66 69 6c | 65 2c 20 61 6e 64 20 61 |nput fil|e, and a|
|00004760| 6c 6c 20 74 68 65 20 69 | 6e 63 6c 75 64 65 64 20 |ll the i|ncluded |
|00004770| 66 69 6c 65 73 20 69 6e | 74 6f 20 6d 65 6d 6f 72 |files in|to memor|
|00004780| 79 2e 5c 66 6f 6f 74 6e | 6f 74 65 7b 49 66 20 61 |y.\footn|ote{If a|
|00004790| 0d 0a 66 69 6c 65 20 69 | 73 20 69 6e 63 6c 75 64 |..file i|s includ|
|000047a0| 65 64 20 24 6e 24 20 74 | 69 6d 65 73 2c 20 46 75 |ed $n$ t|imes, Fu|
|000047b0| 6e 6e 65 6c 57 65 62 20 | 6b 65 65 70 73 20 24 6e |nnelWeb |keeps $n|
|000047c0| 24 20 63 6f 70 69 65 73 | 20 69 6e 20 6d 65 6d 6f |$ copies| in memo|
|000047d0| 72 79 2e 7d 20 54 68 69 | 73 0d 0a 6f 72 67 61 6e |ry.} Thi|s..organ|
|000047e0| 69 7a 61 74 69 6f 6e 20 | 64 6f 65 73 20 6e 6f 74 |ization |does not|
|000047f0| 20 70 6f 73 65 20 61 20 | 63 6f 6e 73 74 72 61 69 | pose a |constrai|
|00004800| 6e 74 20 6f 6e 20 6d 61 | 63 68 69 6e 65 73 20 77 |nt on ma|chines w|
|00004810| 69 74 68 20 6c 61 72 67 | 65 20 6d 65 6d 6f 72 69 |ith larg|e memori|
|00004820| 65 73 2c 0d 0a 62 75 74 | 20 63 6f 75 6c 64 0d 0a |es,..but| could..|
|00004830| 70 72 65 73 65 6e 74 20 | 61 20 70 72 6f 62 6c 65 |present |a proble|
|00004840| 6d 20 6f 6e 20 74 68 65 | 20 73 6d 61 6c 6c 65 72 |m on the| smaller|
|00004850| 20 6d 61 63 68 69 6e 65 | 73 20 73 75 63 68 20 61 | machine|s such a|
|00004860| 73 20 74 68 65 20 50 43 | 2e 7d 0d 0a 0d 0a 5c 6e |s the PC|.}....\n|
|00004870| 61 72 72 6f 77 74 68 69 | 6e 67 7b 53 70 65 65 64 |arrowthi|ng{Speed|
|00004880| 3a 7d 7b 46 75 6e 6e 65 | 6c 57 65 62 5c 78 7b 73 |:}{Funne|lWeb\x{s|
|00004890| 70 65 65 64 7d 20 69 73 | 20 6e 6f 74 20 61 20 73 |peed} is| not a s|
|000048a0| 6c 6f 77 20 70 72 6f 67 | 72 61 6d 2e 20 48 6f 77 |low prog|ram. How|
|000048b0| 65 76 65 72 2c 20 69 74 | 20 69 73 0d 0a 6e 6f 74 |ever, it| is..not|
|000048c0| 20 70 61 72 74 69 63 75 | 6c 61 72 6c 79 20 66 61 | particu|larly fa|
|000048d0| 73 74 20 65 69 74 68 65 | 72 2e 20 49 66 20 74 68 |st eithe|r. If th|
|000048e0| 65 20 73 70 65 65 64 20 | 61 74 20 77 68 69 63 68 |e speed |at which|
|000048f0| 20 46 75 6e 6e 65 6c 57 | 65 62 20 72 75 6e 73 20 | FunnelW|eb runs |
|00004900| 69 73 0d 0a 69 6d 70 6f | 72 74 61 6e 74 20 74 6f |is..impo|rtant to|
|00004910| 20 79 6f 75 2c 20 74 68 | 65 6e 20 74 68 65 20 74 | you, th|en the t|
|00004920| 68 69 6e 67 20 74 6f 20 | 6b 65 65 70 20 69 6e 20 |hing to |keep in |
|00004930| 6d 69 6e 64 20 69 73 20 | 74 68 61 74 20 46 75 6e |mind is |that Fun|
|00004940| 6e 65 6c 57 65 62 20 68 | 61 73 20 62 65 65 6e 0d |nelWeb h|as been.|
|00004950| 0a 6f 70 74 69 6d 69 7a | 65 64 20 74 6f 20 64 65 |.optimiz|ed to de|
|00004960| 61 6c 20 65 66 66 69 63 | 69 65 6e 74 6c 79 20 77 |al effic|iently w|
|00004970| 69 74 68 20 6c 61 72 67 | 65 20 73 6c 61 62 73 20 |ith larg|e slabs |
|00004980| 6f 66 20 74 65 78 74 2e | 20 46 75 6e 6e 65 6c 57 |of text.| FunnelW|
|00004990| 65 62 20 74 72 65 61 74 | 73 0d 0a 69 6e 70 75 74 |eb treat|s..input|
|000049a0| 20 66 69 6c 65 73 20 61 | 73 20 61 20 73 65 71 75 | files a|s a sequ|
|000049b0| 65 6e 63 65 20 6f 66 20 | 74 65 78 74 20 73 6c 61 |ence of |text sla|
|000049c0| 62 73 20 61 6e 64 20 73 | 70 65 63 69 61 6c 20 73 |bs and s|pecial s|
|000049d0| 65 71 75 65 6e 63 65 73 | 20 28 5c 65 67 7b 7d 5c |equences| (\eg{}\|
|000049e0| 70 7b 40 2b 7d 29 0d 0a | 61 6e 64 20 77 68 65 6e |p{@+})..|and when|
|000049f0| 65 76 65 72 20 69 74 20 | 68 69 74 73 20 61 20 73 |ever it |hits a s|
|00004a00| 70 65 63 69 61 6c 20 73 | 65 71 75 65 6e 63 65 2c |pecial s|equence,|
|00004a10| 20 69 74 20 68 61 73 20 | 74 6f 20 73 74 6f 70 20 | it has |to stop |
|00004a20| 61 6e 64 20 74 68 69 6e | 6b 2e 0d 0a 54 68 75 73 |and thin|k...Thus|
|00004a30| 2c 20 77 68 69 6c 65 20 | 61 20 74 65 6e 20 6d 65 |, while |a ten me|
|00004a40| 67 61 62 79 74 65 20 74 | 65 78 74 20 73 6c 61 62 |gabyte t|ext slab|
|00004a50| 20 77 6f 75 6c 64 20 62 | 65 20 6d 61 6e 69 70 75 | would b|e manipu|
|00004a60| 6c 61 74 65 64 20 61 73 | 20 61 20 73 69 6e 67 6c |lated as| a singl|
|00004a70| 65 20 74 6f 6b 65 6e 2c | 0d 0a 69 6e 20 61 20 66 |e token,|..in a f|
|00004a80| 65 77 20 6d 69 6c 6c 69 | 73 65 63 6f 6e 64 73 2c |ew milli|seconds,|
|00004a90| 20 61 20 73 69 6d 69 6c | 61 72 20 74 65 6e 20 6d | a simil|ar ten m|
|00004aa0| 65 67 61 62 79 74 65 20 | 63 68 75 6e 6b 20 66 69 |egabyte |chunk fi|
|00004ab0| 6c 6c 65 64 20 77 69 74 | 68 20 73 70 65 63 69 61 |lled wit|h specia|
|00004ac0| 6c 0d 0a 73 65 71 75 65 | 6e 63 65 73 20 77 6f 75 |l..seque|nces wou|
|00004ad0| 6c 64 20 74 61 6b 65 20 | 61 20 6c 6f 74 20 6c 6f |ld take |a lot lo|
|00004ae0| 6e 67 65 72 2e 0d 0a 49 | 66 20 46 75 6e 6e 65 6c |nger...I|f Funnel|
|00004af0| 57 65 62 20 69 73 20 72 | 75 6e 6e 69 6e 67 20 73 |Web is r|unning s|
|00004b00| 6c 6f 77 6c 79 2c 20 6c | 6f 6f 6b 20 74 6f 20 73 |lowly, l|ook to s|
|00004b10| 65 65 20 69 66 20 74 68 | 65 20 69 6e 70 75 74 20 |ee if th|e input |
|00004b20| 63 6f 6e 74 61 69 6e 73 | 0d 0a 61 20 68 69 67 68 |contains|..a high|
|00004b30| 20 64 65 6e 73 69 74 79 | 20 6f 66 20 73 70 65 63 | density| of spec|
|00004b40| 69 61 6c 20 73 65 71 75 | 65 6e 63 65 73 2e 20 54 |ial sequ|ences. T|
|00004b50| 68 69 73 20 63 61 6e 20 | 73 6f 6d 65 74 69 6d 65 |his can |sometime|
|00004b60| 73 20 68 61 70 70 65 6e | 20 69 66 20 46 75 6e 6e |s happen| if Funn|
|00004b70| 65 6c 57 65 62 0d 0a 69 | 73 20 62 65 69 6e 67 20 |elWeb..i|s being |
|00004b80| 75 73 65 64 20 61 73 20 | 61 20 62 61 63 6b 65 6e |used as |a backen|
|00004b90| 64 20 6d 61 63 72 6f 20 | 70 72 6f 63 65 73 73 6f |d macro |processo|
|00004ba0| 72 20 61 6e 64 20 69 74 | 73 20 69 6e 70 75 74 20 |r and it|s input |
|00004bb0| 69 73 20 62 65 69 6e 67 | 0d 0a 67 65 6e 65 72 61 |is being|..genera|
|00004bc0| 74 65 64 20 61 75 74 6f | 6d 61 74 69 63 61 6c 6c |ted auto|maticall|
|00004bd0| 79 20 62 79 20 73 6f 6d | 65 20 6f 74 68 65 72 20 |y by som|e other |
|00004be0| 70 72 6f 67 72 61 6d 2e | 7d 0d 0a 0d 0a 5c 6e 61 |program.|}....\na|
|00004bf0| 72 72 6f 77 74 68 69 6e | 67 7b 4d 61 63 72 6f 20 |rrowthin|g{Macro |
|00004c00| 65 78 70 61 6e 73 69 6f | 6e 3a 7d 7b 57 68 65 6e |expansio|n:}{When|
|00004c10| 5c 78 78 7b 6d 61 63 72 | 6f 7d 7b 65 78 70 61 6e |\xx{macr|o}{expan|
|00004c20| 73 69 6f 6e 7d 0d 0a 74 | 61 6e 67 6c 69 6e 67 20 |sion}..t|angling |
|00004c30| 28 65 78 70 61 6e 64 69 | 6e 67 20 6d 61 63 72 6f |(expandi|ng macro|
|00004c40| 73 29 2c 20 46 75 6e 6e | 65 6c 57 65 62 20 6e 65 |s), Funn|elWeb ne|
|00004c50| 76 65 72 0d 0a 65 78 70 | 61 6e 64 73 20 61 20 6d |ver..exp|ands a m|
|00004c60| 61 63 72 6f 20 65 78 70 | 72 65 73 73 69 6f 6e 20 |acro exp|ression |
|00004c70| 69 6e 74 6f 20 6d 65 6d | 6f 72 79 3b 20 69 74 20 |into mem|ory; it |
|00004c80| 61 6c 77 61 79 73 20 77 | 72 69 74 65 73 20 69 74 |always w|rites it|
|00004c90| 20 74 6f 20 74 68 65 0d | 0a 70 72 6f 64 75 63 74 | to the.|.product|
|00004ca0| 20 66 69 6c 65 0d 0a 61 | 73 20 69 74 20 67 6f 65 | file..a|s it goe|
|00004cb0| 73 2e 20 54 68 69 73 20 | 69 73 20 61 20 70 6f 77 |s. This |is a pow|
|00004cc0| 65 72 66 75 6c 20 66 61 | 63 74 2c 20 62 65 63 61 |erful fa|ct, beca|
|00004cd0| 75 73 65 20 69 74 20 6d | 65 61 6e 73 20 74 68 61 |use it m|eans tha|
|00004ce0| 74 20 79 6f 75 20 63 61 | 6e 0d 0a 77 72 69 74 65 |t you ca|n..write|
|00004cf0| 20 6d 61 63 72 6f 73 20 | 63 6f 6e 74 61 69 6e 69 | macros |containi|
|00004d00| 6e 67 20 61 6e 20 75 6e | 6c 69 6d 69 74 65 64 20 |ng an un|limited |
|00004d10| 61 6d 6f 75 6e 74 20 6f | 66 20 74 65 78 74 2c 20 |amount o|f text, |
|00004d20| 61 6e 64 20 70 61 73 73 | 20 73 75 63 68 20 6d 61 |and pass| such ma|
|00004d30| 63 72 6f 73 0d 0a 61 73 | 20 70 61 72 61 6d 65 74 |cros..as| paramet|
|00004d40| 65 72 73 20 74 6f 20 6f | 74 68 65 72 20 6d 61 63 |ers to o|ther mac|
|00004d50| 72 6f 73 20 77 69 74 68 | 6f 75 74 20 62 65 63 6f |ros with|out beco|
|00004d60| 6d 69 6e 67 20 63 6f 6e | 63 65 72 6e 65 64 20 61 |ming con|cerned a|
|00004d70| 62 6f 75 74 20 6f 76 65 | 72 66 6c 6f 77 69 6e 67 |bout ove|rflowing|
|00004d80| 0d 0a 73 6f 6d 65 20 6b | 69 6e 64 20 6f 66 20 62 |..some k|ind of b|
|00004d90| 75 66 66 65 72 20 6d 65 | 6d 6f 72 79 2e 20 49 6e |uffer me|mory. In|
|00004da0| 20 73 68 6f 72 74 2c 20 | 46 75 6e 6e 65 6c 57 65 | short, |FunnelWe|
|00004db0| 62 20 64 6f 65 73 20 6e | 6f 74 20 69 6d 70 6f 73 |b does n|ot impos|
|00004dc0| 65 20 61 6e 79 0d 0a 6c | 69 6d 69 74 73 20 6f 6e |e any..l|imits on|
|00004dd0| 20 74 68 65 20 73 69 7a | 65 20 6f 66 20 6d 61 63 | the siz|e of mac|
|00004de0| 72 6f 20 62 6f 64 69 65 | 73 20 6f 72 20 74 68 65 |ro bodie|s or the|
|00004df0| 69 72 20 65 78 70 61 6e | 73 69 6f 6e 73 2e 7d 0d |ir expan|sions.}.|
|00004e00| 0a 0d 0a 5c 73 65 63 74 | 69 6f 6e 7b 49 6e 74 65 |...\sect|ion{Inte|
|00004e10| 72 61 63 74 69 76 65 20 | 4d 6f 64 65 7d 0d 0a 5c |ractive |Mode}..\|
|00004e20| 78 7b 69 6e 74 65 72 61 | 63 74 69 76 65 20 6d 6f |x{intera|ctive mo|
|00004e30| 64 65 7d 5c 78 7b 6b 65 | 79 62 6f 61 72 64 20 6d |de}\x{ke|yboard m|
|00004e40| 6f 64 65 7d 0d 0a 0d 0a | 41 73 20 77 65 6c 6c 20 |ode}....|As well |
|00004e50| 61 73 20 68 61 76 69 6e | 67 20 61 20 63 6f 6d 6d |as havin|g a comm|
|00004e60| 61 6e 64 20 6c 69 6e 65 | 20 69 6e 74 65 72 66 61 |and line| interfa|
|00004e70| 63 65 20 77 69 74 68 20 | 6c 6f 74 73 20 6f 66 20 |ce with |lots of |
|00004e80| 6f 70 74 69 6f 6e 73 2c | 20 46 75 6e 6e 65 6c 57 |options,| FunnelW|
|00004e90| 65 62 0d 0a 61 6c 73 6f | 20 70 72 6f 76 69 64 65 |eb..also| provide|
|00004ea0| 73 20 61 20 63 6f 6d 6d | 61 6e 64 20 6c 61 6e 67 |s a comm|and lang|
|00004eb0| 75 61 67 65 20 61 6e 64 | 20 61 20 6d 6f 64 65 20 |uage and| a mode |
|00004ec0| 28 5c 64 71 7b 69 6e 74 | 65 72 61 63 74 69 76 65 |(\dq{int|eractive|
|00004ed0| 20 6d 6f 64 65 7d 29 0d | 0a 69 6e 20 77 68 69 63 | mode}).|.in whic|
|00004ee0| 68 20 63 6f 6d 6d 61 6e | 64 73 20 69 6e 20 74 68 |h comman|ds in th|
|00004ef0| 65 20 6c 61 6e 67 75 61 | 67 65 20 63 61 6e 20 62 |e langua|ge can b|
|00004f00| 65 20 74 79 70 65 64 20 | 69 6e 74 65 72 61 63 74 |e typed |interact|
|00004f10| 69 76 65 6c 79 2e 20 54 | 68 65 0d 0a 46 75 6e 6e |ively. T|he..Funn|
|00004f20| 65 6c 57 65 62 20 63 6f | 6d 6d 61 6e 64 20 69 6e |elWeb co|mmand in|
|00004f30| 74 65 72 70 72 65 74 65 | 72 20 77 61 73 20 63 72 |terprete|r was cr|
|00004f40| 65 61 74 65 64 20 70 72 | 69 6d 61 72 69 6c 79 0d |eated pr|imarily.|
|00004f50| 0a 74 6f 20 73 75 70 70 | 6f 72 74 20 72 65 67 72 |.to supp|ort regr|
|00004f60| 65 73 73 69 6f 6e 20 74 | 65 73 74 69 6e 67 2c 5c |ession t|esting,\|
|00004f70| 78 78 7b 72 65 67 72 65 | 73 73 69 6f 6e 7d 7b 74 |xx{regre|ssion}{t|
|00004f80| 65 73 74 69 6e 67 7d 0d | 0a 62 75 74 20 63 61 6e |esting}.|.but can|
|00004f90| 20 61 6c 73 6f 20 62 65 | 20 75 73 65 66 75 6c 20 | also be| useful |
|00004fa0| 74 6f 20 46 75 6e 6e 65 | 6c 57 65 62 20 75 73 65 |to Funne|lWeb use|
|00004fb0| 72 73 2e 0d 0a 0d 0a 46 | 75 6e 6e 65 6c 57 65 62 |rs.....F|unnelWeb|
|00004fc0| 27 73 20 63 6f 6d 6d 61 | 6e 64 20 69 6e 74 65 72 |'s comma|nd inter|
|00004fd0| 70 72 65 74 65 72 5c 78 | 78 7b 63 6f 6d 6d 61 6e |preter\x|x{comman|
|00004fe0| 64 7d 7b 69 6e 74 65 72 | 70 72 65 74 65 72 7d 0d |d}{inter|preter}.|
|00004ff0| 0a 72 65 61 64 73 20 6f | 6e 65 20 63 6f 6d 6d 61 |.reads o|ne comma|
|00005000| 6e 64 20 70 65 72 20 6c | 69 6e 65 20 61 6e 64 20 |nd per l|ine and |
|00005010| 63 61 6e 20 72 65 61 64 | 0d 0a 61 20 73 74 72 65 |can read|..a stre|
|00005020| 61 6d 20 6f 66 20 63 6f | 6d 6d 61 6e 64 73 20 65 |am of co|mmands e|
|00005030| 69 74 68 65 72 20 66 72 | 6f 6d 20 61 20 74 65 78 |ither fr|om a tex|
|00005040| 74 20 66 69 6c 65 2c 20 | 6f 72 20 66 72 6f 6d 20 |t file, |or from |
|00005050| 74 68 65 20 63 6f 6e 73 | 6f 6c 65 2e 20 54 68 65 |the cons|ole. The|
|00005060| 0d 0a 69 6e 74 65 72 70 | 72 65 74 65 72 20 63 61 |..interp|reter ca|
|00005070| 6e 20 75 6e 64 65 72 73 | 74 61 6e 64 20 6f 76 65 |n unders|tand ove|
|00005080| 72 20 74 77 65 6e 74 79 | 20 63 6f 6d 6d 61 6e 64 |r twenty| command|
|00005090| 73 2e 20 53 65 65 0d 0a | 43 68 61 70 74 65 72 7e |s. See..|Chapter~|
|000050a0| 5c 72 65 66 7b 63 68 61 | 70 64 65 66 69 6e 69 74 |\ref{cha|pdefinit|
|000050b0| 69 6f 6e 7d 20 66 6f 72 | 20 61 20 66 75 6c 6c 20 |ion} for| a full |
|000050c0| 6c 69 73 74 2e 20 48 6f | 77 65 76 65 72 2c 20 6d |list. Ho|wever, m|
|000050d0| 6f 73 74 20 6f 66 20 74 | 68 65 6d 0d 0a 77 65 72 |ost of t|hem..wer|
|000050e0| 65 20 64 65 73 69 67 6e | 65 64 20 74 6f 20 73 75 |e design|ed to su|
|000050f0| 70 70 6f 72 74 20 72 65 | 67 72 65 73 73 69 6f 6e |pport re|gression|
|00005100| 20 74 65 73 74 69 6e 67 | 20 61 6e 64 20 77 69 6c | testing| and wil|
|00005110| 6c 20 6e 6f 74 20 62 65 | 20 6f 66 20 75 73 65 20 |l not be| of use |
|00005120| 74 6f 20 74 68 65 0d 0a | 63 61 73 75 61 6c 20 75 |to the..|casual u|
|00005130| 73 65 72 2e 0d 0a 0d 0a | 54 68 65 20 63 6f 6d 6d |ser.....|The comm|
|00005140| 61 6e 64 73 20 74 68 61 | 74 20 61 72 65 20 6f 66 |ands tha|t are of|
|00005150| 20 67 72 65 61 74 65 73 | 74 20 75 73 65 20 74 6f | greates|t use to|
|00005160| 20 74 68 65 20 63 61 73 | 75 61 6c 20 75 73 65 72 | the cas|ual user|
|00005170| 0d 0a 61 72 65 3a 5c 78 | 78 7b 75 73 65 66 75 6c |..are:\x|x{useful|
|00005180| 7d 7b 63 6f 6d 6d 61 6e | 64 73 7d 0d 0a 0d 0a 5c |}{comman|ds}....\|
|00005190| 62 65 67 69 6e 7b 76 65 | 72 62 61 74 69 6d 7d 0d |begin{ve|rbatim}.|
|000051a0| 0a 20 20 20 20 20 21 20 | 20 20 20 20 20 20 20 20 |. ! | |
|000051b0| 20 20 20 20 20 20 2d 20 | 43 6f 6d 6d 65 6e 74 2e | - |Comment.|
|000051c0| 20 49 67 6e 6f 72 65 73 | 20 74 68 65 20 77 68 6f | Ignores| the who|
|000051d0| 6c 65 20 6c 69 6e 65 2e | 0d 0a 20 20 20 20 20 45 |le line.|.. E|
|000051e0| 58 45 43 55 54 45 20 66 | 6e 20 20 20 20 20 20 2d |XECUTE f|n -|
|000051f0| 20 45 78 65 63 75 74 65 | 20 74 68 65 20 73 70 65 | Execute| the spe|
|00005200| 63 69 66 69 65 64 20 66 | 69 6c 65 2e 0d 0a 20 20 |cified f|ile... |
|00005210| 20 20 20 46 57 20 6f 70 | 74 69 6f 6e 73 20 20 20 | FW op|tions |
|00005220| 20 20 20 2d 20 49 6e 76 | 6f 6b 65 20 46 75 6e 6e | - Inv|oke Funn|
|00005230| 65 6c 57 65 62 2d 70 72 | 6f 70 65 72 20 6f 6e 63 |elWeb-pr|oper onc|
|00005240| 65 2e 0d 0a 20 20 20 20 | 20 53 45 54 20 6f 70 74 |e... | SET opt|
|00005250| 69 6f 6e 73 20 20 20 20 | 20 2d 20 53 65 74 73 20 |ions | - Sets |
|00005260| 6f 70 74 69 6f 6e 73 2e | 0d 0a 20 20 20 20 20 53 |options.|.. S|
|00005270| 48 4f 57 20 20 20 20 20 | 20 20 20 20 20 20 20 2d |HOW | -|
|00005280| 20 44 69 73 70 6c 61 79 | 73 20 63 75 72 72 65 6e | Display|s curren|
|00005290| 74 6c 79 20 61 63 74 69 | 76 65 20 6f 70 74 69 6f |tly acti|ve optio|
|000052a0| 6e 73 2e 0d 0a 20 20 20 | 20 20 54 52 41 43 45 20 |ns... | TRACE |
|000052b0| 4f 4e 20 20 20 20 20 20 | 20 20 2d 20 54 75 72 6e |ON | - Turn|
|000052c0| 73 20 63 6f 6d 6d 61 6e | 64 20 74 72 61 63 69 6e |s comman|d tracin|
|000052d0| 67 20 4f 4e 2e 0d 0a 20 | 20 20 20 20 51 55 49 54 |g ON... | QUIT|
|000052e0| 20 20 20 20 20 20 20 20 | 20 20 20 20 2d 20 51 75 | | - Qu|
|000052f0| 69 74 73 20 46 75 6e 6e | 65 6c 57 65 62 2e 0d 0a |its Funn|elWeb...|
|00005300| 5c 65 6e 64 7b 76 65 72 | 62 61 74 69 6d 7d 0d 0a |\end{ver|batim}..|
|00005310| 0d 0a 54 6f 20 64 69 73 | 74 69 6e 67 75 69 73 68 |..To dis|tinguish|
|00005320| 20 68 65 72 65 20 62 65 | 74 77 65 65 6e 20 69 6e | here be|tween in|
|00005330| 76 6f 63 61 74 69 6f 6e | 73 20 6f 66 20 74 68 65 |vocation|s of the|
|00005340| 20 46 75 6e 6e 65 6c 57 | 65 62 20 70 72 6f 67 72 | FunnelW|eb progr|
|00005350| 61 6d 0d 0a 61 6e 64 20 | 46 75 6e 6e 65 6c 57 65 |am..and |FunnelWe|
|00005360| 62 20 72 75 6e 73 20 69 | 6e 73 69 64 65 20 74 68 |b runs i|nside th|
|00005370| 65 20 73 68 65 6c 6c 2c | 20 77 65 20 63 61 6c 6c |e shell,| we call|
|00005380| 20 74 68 65 20 6c 61 74 | 74 65 72 20 5c 6e 65 77 | the lat|ter \new|
|00005390| 74 65 72 6d 7b 46 75 6e | 6e 65 6c 57 65 62 0d 0a |term{Fun|nelWeb..|
|000053a0| 70 72 6f 70 65 72 7d 2e | 20 54 68 65 20 5c 64 71 |proper}.| The \dq|
|000053b0| 70 7b 46 57 7d 20 63 6f | 6d 6d 61 6e 64 20 69 6e |p{FW} co|mmand in|
|000053c0| 76 6f 6b 65 73 20 46 75 | 6e 6e 65 6c 57 65 62 20 |vokes Fu|nnelWeb |
|000053d0| 70 72 6f 70 65 72 20 77 | 69 74 68 20 74 68 65 20 |proper w|ith the |
|000053e0| 73 70 65 63 69 66 69 65 | 64 0d 0a 6f 70 74 69 6f |specifie|d..optio|
|000053f0| 6e 73 20 77 68 69 63 68 | 20 74 61 6b 65 20 74 68 |ns which| take th|
|00005400| 65 20 73 61 6d 65 20 73 | 79 6e 74 61 78 20 61 73 |e same s|yntax as|
|00005410| 20 74 68 65 79 20 64 6f | 20 6f 6e 20 74 68 65 20 | they do| on the |
|00005420| 63 6f 6d 6d 61 6e 64 20 | 6c 69 6e 65 2e 20 54 68 |command |line. Th|
|00005430| 65 20 6f 6e 6c 79 0d 0a | 72 65 73 74 72 69 63 74 |e only..|restrict|
|00005440| 69 6f 6e 20 69 73 20 74 | 68 61 74 20 6e 6f 6e 65 |ion is t|hat none|
|00005450| 20 6f 66 20 74 68 65 20 | 61 63 74 69 6f 6e 20 6f | of the |action o|
|00005460| 70 74 69 6f 6e 73 20 63 | 61 6e 20 62 65 20 74 75 |ptions c|an be tu|
|00005470| 72 6e 65 64 20 6f 6e 20 | 65 78 63 65 70 74 0d 0a |rned on |except..|
|00005480| 5c 64 71 70 7b 2b 46 7d | 20 77 68 69 63 68 20 6d |\dqp{+F}| which m|
|00005490| 75 73 74 20 62 65 20 74 | 75 72 6e 65 64 20 6f 6e |ust be t|urned on|
|000054a0| 2e 0d 0a 0d 0a 54 68 65 | 20 5c 64 71 70 7b 53 45 |.....The| \dqp{SE|
|000054b0| 54 7d 20 63 6f 6d 6d 61 | 6e 64 5c 78 78 7b 73 65 |T} comma|nd\xx{se|
|000054c0| 74 7d 7b 63 6f 6d 6d 61 | 6e 64 7d 0d 0a 68 61 73 |t}{comma|nd}..has|
|000054d0| 20 74 68 65 20 73 61 6d | 65 20 73 79 6e 74 61 78 | the sam|e syntax|
|000054e0| 20 61 73 20 74 68 65 20 | 5c 64 71 70 7b 46 57 7d | as the |\dqp{FW}|
|000054f0| 20 63 6f 6d 6d 61 6e 64 | 20 65 78 63 65 70 74 20 | command| except |
|00005500| 74 68 61 74 20 69 74 0d | 0a 64 6f 65 73 20 6e 6f |that it.|.does no|
|00005510| 74 20 61 6c 6c 6f 77 20 | 5c 69 7b 61 6e 79 7d 20 |t allow |\i{any} |
|00005520| 61 63 74 69 6f 6e 20 6f | 70 74 69 6f 6e 73 20 74 |action o|ptions t|
|00005530| 6f 20 62 65 0d 0a 73 70 | 65 63 69 66 69 65 64 2e |o be..sp|ecified.|
|00005540| 20 49 74 27 73 20 73 6f | 6c 65 20 65 66 66 65 63 | It's so|le effec|
|00005550| 74 20 69 73 20 74 6f 20 | 73 65 74 20 64 65 66 61 |t is to |set defa|
|00005560| 75 6c 74 20 6f 70 74 69 | 6f 6e 20 76 61 6c 75 65 |ult opti|on value|
|00005570| 73 20 66 6f 72 20 74 68 | 65 0d 0a 72 65 73 74 20 |s for th|e..rest |
|00005580| 6f 66 20 74 68 65 20 72 | 75 6e 2e 0d 0a 0d 0a 54 |of the r|un.....T|
|00005590| 68 65 20 5c 64 71 70 7b | 53 48 4f 57 7d 5c 78 78 |he \dqp{|SHOW}\xx|
|000055a0| 7b 73 68 6f 77 7d 7b 63 | 6f 6d 6d 61 6e 64 7d 0d |{show}{c|ommand}.|
|000055b0| 0a 63 6f 6d 6d 61 6e 64 | 20 64 69 73 70 6c 61 79 |.command| display|
|000055c0| 73 20 74 68 65 20 63 75 | 72 72 65 6e 74 20 64 65 |s the cu|rrent de|
|000055d0| 66 61 75 6c 74 20 6f 70 | 74 69 6f 6e 73 2e 0d 0a |fault op|tions...|
|000055e0| 0d 0a 42 79 20 64 65 66 | 61 75 6c 74 2c 20 46 75 |..By def|ault, Fu|
|000055f0| 6e 6e 65 6c 57 65 62 20 | 64 6f 65 73 20 6e 6f 74 |nnelWeb |does not|
|00005600| 20 65 63 68 6f 20 74 68 | 65 20 63 6f 6d 6d 61 6e | echo th|e comman|
|00005610| 64 73 20 74 68 61 74 20 | 69 74 20 70 72 6f 63 65 |ds that |it proce|
|00005620| 73 73 65 73 20 69 6e 20 | 61 0d 0a 73 63 72 69 70 |sses in |a..scrip|
|00005630| 74 2e 20 54 68 65 20 5c | 64 71 70 7b 54 52 41 43 |t. The \|dqp{TRAC|
|00005640| 45 20 4f 4e 7d 5c 78 78 | 7b 74 72 61 63 65 20 6f |E ON}\xx|{trace o|
|00005650| 6e 7d 7b 63 6f 6d 6d 61 | 6e 64 7d 0d 0a 63 6f 6d |n}{comma|nd}..com|
|00005660| 6d 61 6e 64 20 74 75 72 | 6e 73 20 6f 6e 20 73 75 |mand tur|ns on su|
|00005670| 63 68 20 74 72 61 63 69 | 6e 67 2e 0d 0a 0d 0a 54 |ch traci|ng.....T|
|00005680| 68 65 73 65 20 63 6f 6d | 6d 61 6e 64 73 20 63 61 |hese com|mands ca|
|00005690| 6e 20 62 65 20 63 6f 6d | 62 69 6e 65 64 20 74 6f |n be com|bined to|
|000056a0| 20 73 74 72 65 61 6d 6c | 69 6e 65 20 74 68 65 20 | streaml|ine the |
|000056b0| 75 73 65 20 6f 66 20 46 | 75 6e 6e 65 6c 57 65 62 |use of F|unnelWeb|
|000056c0| 2e 0d 0a 46 6f 72 20 65 | 78 61 6d 70 6c 65 2c 20 |...For e|xample, |
|000056d0| 79 6f 75 20 6d 69 67 68 | 74 20 77 69 73 68 20 74 |you migh|t wish t|
|000056e0| 6f 20 63 72 65 61 74 65 | 20 61 20 73 63 72 69 70 |o create| a scrip|
|000056f0| 74 20 63 61 6c 6c 65 64 | 20 5c 70 7b 74 79 70 65 |t called| \p{type|
|00005700| 73 65 74 2e 66 77 73 7d | 0d 0a 74 6f 20 70 72 6f |set.fws}|..to pro|
|00005710| 63 65 73 73 20 61 20 77 | 68 6f 6c 65 20 67 72 6f |cess a w|hole gro|
|00005720| 75 70 20 6f 66 20 66 69 | 6c 65 73 2e 0d 0a 0d 0a |up of fi|les.....|
|00005730| 5c 62 65 67 69 6e 7b 76 | 65 72 62 61 74 69 6d 7d |\begin{v|erbatim}|
|00005740| 0d 0a 74 72 61 63 65 20 | 6f 6e 0d 0a 21 54 68 69 |..trace |on..!Thi|
|00005750| 73 20 73 63 72 69 70 74 | 20 74 79 70 65 73 65 74 |s script| typeset|
|00005760| 73 20 74 68 65 20 77 68 | 6f 6c 65 20 70 72 6f 67 |s the wh|ole prog|
|00005770| 72 61 6d 2e 0d 0a 21 20 | 53 65 74 20 6e 6f 20 6c |ram...! |Set no l|
|00005780| 69 73 74 69 6e 67 20 66 | 69 6c 65 2c 20 6e 6f 20 |isting f|ile, no |
|00005790| 70 72 6f 64 75 63 74 20 | 66 69 6c 65 73 2c 20 62 |product |files, b|
|000057a0| 75 74 20 73 70 65 63 69 | 66 79 20 61 20 64 6f 63 |ut speci|fy a doc|
|000057b0| 75 6d 65 6e 74 61 74 69 | 6f 6e 20 66 69 6c 65 0d |umentati|on file.|
|000057c0| 0a 21 20 61 6e 64 20 73 | 70 65 63 69 66 79 20 74 |.! and s|pecify t|
|000057d0| 68 65 20 64 69 72 65 63 | 74 6f 72 79 20 69 6e 74 |he direc|tory int|
|000057e0| 6f 20 77 68 69 63 68 20 | 69 74 20 73 68 6f 75 6c |o which |it shoul|
|000057f0| 64 20 62 65 20 70 6c 61 | 63 65 64 2e 0d 0a 73 65 |d be pla|ced...se|
|00005800| 74 20 2d 4c 20 2d 4f 20 | 2b 54 2f 75 73 72 2f 72 |t -L -O |+T/usr/r|
|00005810| 6f 73 73 2f 74 79 70 65 | 73 65 74 2f 0d 0a 66 77 |oss/type|set/..fw|
|00005820| 20 70 72 6f 67 31 0d 0a | 66 77 20 70 72 6f 67 32 | prog1..|fw prog2|
|00005830| 0d 0a 66 77 20 70 72 6f | 67 33 0d 0a 66 77 20 70 |..fw pro|g3..fw p|
|00005840| 72 6f 67 34 0d 0a 5c 65 | 6e 64 7b 76 65 72 62 61 |rog4..\e|nd{verba|
|00005850| 74 69 6d 7d 0d 0a 0d 0a | 54 68 65 72 65 20 61 72 |tim}....|There ar|
|00005860| 65 20 61 20 66 65 77 20 | 77 61 79 73 20 69 6e 20 |e a few |ways in |
|00005870| 77 68 69 63 68 20 74 68 | 69 73 20 73 63 72 69 70 |which th|is scrip|
|00005880| 74 20 63 61 6e 20 62 65 | 20 72 75 6e 2e 20 54 68 |t can be| run. Th|
|00005890| 65 20 73 69 6d 70 6c 65 | 73 74 20 69 73 0d 0a 73 |e simple|st is..s|
|000058a0| 69 6d 70 6c 79 20 74 6f | 20 73 70 65 63 69 66 79 |imply to| specify|
|000058b0| 20 69 74 20 69 6e 20 74 | 68 65 20 5c 64 71 70 7b | it in t|he \dqp{|
|000058c0| 2b 58 7d 20 6f 70 74 69 | 6f 6e 20 6f 66 20 61 20 |+X} opti|on of a |
|000058d0| 46 75 6e 6e 65 6c 57 65 | 62 20 69 6e 76 6f 63 61 |FunnelWe|b invoca|
|000058e0| 74 69 6f 6e 2e 0d 0a 46 | 75 6e 6e 65 6c 57 65 62 |tion...F|unnelWeb|
|000058f0| 20 73 68 65 6c 6c 73 63 | 72 69 70 74 73 20 64 65 | shellsc|ripts de|
|00005900| 66 61 75 6c 74 20 74 6f | 20 5c 64 71 70 7b 3c 63 |fault to| \dqp{<c|
|00005910| 75 72 72 65 6e 74 5c 5f | 64 69 72 65 63 74 6f 72 |urrent\_|director|
|00005920| 79 3e 7d 20 61 6e 64 20 | 5c 64 71 70 7b 2e 66 77 |y>} and |\dqp{.fw|
|00005930| 73 7d 2e 0d 0a 0d 0a 5c | 62 65 67 69 6e 7b 76 65 |s}.....\|begin{ve|
|00005940| 72 62 61 74 69 6d 7d 0d | 0a 66 77 20 2b 78 74 79 |rbatim}.|.fw +xty|
|00005950| 70 65 73 65 74 0d 0a 5c | 65 6e 64 7b 76 65 72 62 |peset..\|end{verb|
|00005960| 61 74 69 6d 7d 0d 0a 0d | 0a 54 68 65 20 73 65 63 |atim}...|.The sec|
|00005970| 6f 6e 64 20 61 6c 74 65 | 72 6e 61 74 69 76 65 20 |ond alte|rnative |
|00005980| 69 73 20 74 6f 20 65 6e | 74 65 72 20 69 6e 74 65 |is to en|ter inte|
|00005990| 72 61 63 74 69 76 65 20 | 6d 6f 64 65 2e 0d 0a 0d |ractive |mode....|
|000059a0| 0a 5c 62 65 67 69 6e 7b | 76 65 72 62 61 74 69 6d |.\begin{|verbatim|
|000059b0| 7d 0d 0a 66 77 20 2b 6b | 0d 0a 5c 65 6e 64 7b 76 |}..fw +k|..\end{v|
|000059c0| 65 72 62 61 74 69 6d 7d | 0d 0a 0d 0a 46 72 6f 6d |erbatim}|....From|
|000059d0| 20 74 68 65 72 65 2c 20 | 79 6f 75 20 63 61 6e 20 | there, |you can |
|000059e0| 65 78 65 63 75 74 65 20 | 74 68 65 20 73 63 72 69 |execute |the scri|
|000059f0| 70 74 20 75 73 69 6e 67 | 3a 0d 0a 0d 0a 5c 62 65 |pt using|:....\be|
|00005a00| 67 69 6e 7b 76 65 72 62 | 61 74 69 6d 7d 0d 0a 65 |gin{verb|atim}..e|
|00005a10| 78 65 63 75 74 65 20 74 | 79 70 65 73 65 74 0d 0a |xecute t|ypeset..|
|00005a20| 5c 65 6e 64 7b 76 65 72 | 62 61 74 69 6d 7d 0d 0a |\end{ver|batim}..|
|00005a30| 0d 0a 49 6e 74 65 72 61 | 63 74 69 76 65 20 6d 6f |..Intera|ctive mo|
|00005a40| 64 65 20 63 6f 75 6c 64 | 20 62 65 20 76 65 72 79 |de could| be very|
|00005a50| 20 75 73 65 66 75 6c 20 | 74 6f 20 74 68 6f 73 65 | useful |to those|
|00005a60| 20 77 69 74 68 20 6d 75 | 6c 74 69 70 6c 65 2d 77 | with mu|ltiple-w|
|00005a70| 69 6e 64 6f 77 0d 0a 77 | 6f 72 6b 73 74 61 74 69 |indow..w|orkstati|
|00005a80| 6f 6e 73 2e 5c 78 7b 77 | 6f 72 6b 73 74 61 74 69 |ons.\x{w|orkstati|
|00005a90| 6f 6e 73 7d 0d 0a 54 68 | 65 20 75 73 65 72 20 63 |ons}..Th|e user c|
|00005aa0| 6f 75 6c 64 20 63 72 65 | 61 74 65 20 61 20 77 69 |ould cre|ate a wi|
|00005ab0| 6e 64 6f 77 20 63 6f 6e | 74 61 69 6e 69 6e 67 20 |ndow con|taining |
|00005ac0| 61 6e 20 69 6e 74 65 72 | 61 63 74 69 76 65 0d 0a |an inter|active..|
|00005ad0| 73 65 73 73 69 6f 6e 20 | 6f 66 20 46 75 6e 6e 65 |session |of Funne|
|00005ae0| 6c 57 65 62 2c 20 61 6e | 64 20 74 68 65 6e 20 73 |lWeb, an|d then s|
|00005af0| 77 69 74 63 68 20 62 65 | 74 77 65 65 6e 20 77 69 |witch be|tween wi|
|00005b00| 6e 64 6f 77 73 2c 20 65 | 64 69 74 69 6e 67 2c 20 |ndows, e|diting, |
|00005b10| 61 6e 64 20 65 78 65 63 | 75 74 69 6e 67 0d 0a 46 |and exec|uting..F|
|00005b20| 75 6e 6e 65 6c 57 65 62 | 20 70 72 6f 70 65 72 20 |unnelWeb| proper |
|00005b30| 61 6e 64 20 6f 74 68 65 | 72 20 70 72 6f 67 72 61 |and othe|r progra|
|00005b40| 6d 73 2e 0d 0a 0d 0a 49 | 66 20 79 6f 75 20 66 69 |ms.....I|f you fi|
|00005b50| 6e 64 20 79 6f 75 72 73 | 65 6c 66 20 75 73 69 6e |nd yours|elf usin|
|00005b60| 67 20 74 68 65 20 63 6f | 6d 6d 61 6e 64 20 69 6e |g the co|mmand in|
|00005b70| 74 65 72 70 72 65 74 65 | 72 20 61 20 6c 6f 74 2c |terprete|r a lot,|
|00005b80| 20 62 65 20 73 75 72 65 | 20 74 6f 0d 0a 72 65 61 | be sure| to..rea|
|00005b90| 64 20 61 62 6f 75 74 20 | 74 68 65 20 6f 74 68 65 |d about |the othe|
|00005ba0| 72 20 63 6f 6d 6d 61 6e | 64 73 20 74 68 61 74 20 |r comman|ds that |
|00005bb0| 61 72 65 20 61 76 61 69 | 6c 61 62 6c 65 20 69 6e |are avai|lable in|
|00005bc0| 0d 0a 43 68 61 70 74 65 | 72 7e 5c 72 65 66 7b 63 |..Chapte|r~\ref{c|
|00005bd0| 68 61 70 64 65 66 69 6e | 69 74 69 6f 6e 7d 2e 0d |hapdefin|ition}..|
|00005be0| 0a 0d 0a 5c 73 65 63 74 | 69 6f 6e 7b 53 65 74 74 |...\sect|ion{Sett|
|00005bf0| 69 6e 67 20 55 70 20 44 | 65 66 61 75 6c 74 20 4f |ing Up D|efault O|
|00005c00| 70 74 69 6f 6e 73 7d 0d | 0a 5c 78 78 7b 6f 70 74 |ptions}.|.\xx{opt|
|00005c10| 69 6f 6e 73 7d 7b 73 65 | 74 74 69 6e 67 20 64 65 |ions}{se|tting de|
|00005c20| 66 61 75 6c 74 73 7d 5c | 78 78 7b 64 65 66 61 75 |faults}\|xx{defau|
|00005c30| 6c 74 7d 7b 6f 70 74 69 | 6f 6e 73 7d 0d 0a 0d 0a |lt}{opti|ons}....|
|00005c40| 49 66 20 79 6f 75 20 64 | 6f 20 6e 6f 74 20 6c 69 |If you d|o not li|
|00005c50| 6b 65 20 46 75 6e 6e 65 | 6c 57 65 62 27 73 20 64 |ke Funne|lWeb's d|
|00005c60| 65 66 61 75 6c 74 20 73 | 65 74 74 69 6e 67 73 20 |efault s|ettings |
|00005c70| 66 6f 72 20 69 74 73 20 | 63 6f 6d 6d 61 6e 64 20 |for its |command |
|00005c80| 6c 69 6e 65 0d 0a 6f 70 | 74 69 6f 6e 73 2c 20 74 |line..op|tions, t|
|00005c90| 68 65 72 65 20 61 72 65 | 20 61 20 6e 75 6d 62 65 |here are| a numbe|
|00005ca0| 72 20 6f 66 20 77 61 79 | 73 20 69 6e 20 77 68 69 |r of way|s in whi|
|00005cb0| 63 68 20 79 6f 75 20 63 | 61 6e 20 63 68 61 6e 67 |ch you c|an chang|
|00005cc0| 65 20 74 68 65 6d 2e 0d | 0a 0d 0a 5c 6e 61 72 72 |e them..|...\narr|
|00005cd0| 6f 77 74 68 69 6e 67 7b | 44 65 66 69 6e 65 20 61 |owthing{|Define a|
|00005ce0| 6e 20 5c 64 71 7b 61 6c | 69 61 73 7d 3a 7d 7b 55 |n \dq{al|ias}:}{U|
|00005cf0| 73 65 20 79 6f 75 72 20 | 6f 70 65 72 61 74 69 6e |se your |operatin|
|00005d00| 67 20 73 79 73 74 65 6d | 0d 0a 5c 64 71 70 7b 61 |g system|..\dqp{a|
|00005d10| 6c 69 61 73 7d 5c 78 7b | 61 6c 69 61 73 7d 0d 0a |lias}\x{|alias}..|
|00005d20| 66 61 63 69 6c 69 74 79 | 20 74 6f 20 63 72 65 61 |facility| to crea|
|00005d30| 74 65 20 61 6e 20 61 6c | 69 61 73 20 66 6f 72 20 |te an al|ias for |
|00005d40| 46 75 6e 6e 65 6c 57 65 | 62 20 63 6f 6e 74 61 69 |FunnelWe|b contai|
|00005d50| 6e 69 6e 67 20 74 68 65 | 20 64 65 73 69 72 65 64 |ning the| desired|
|00005d60| 20 6f 70 74 69 6f 6e 73 | 2e 0d 0a 46 75 6e 6e 65 | options|...Funne|
|00005d70| 6c 57 65 62 20 70 72 6f | 63 65 73 73 65 73 20 6f |lWeb pro|cesses o|
|00005d80| 70 74 69 6f 6e 73 20 66 | 72 6f 6d 20 6c 65 66 74 |ptions f|rom left|
|00005d90| 20 74 6f 20 72 69 67 68 | 74 2c 20 73 6f 20 79 6f | to righ|t, so yo|
|00005da0| 75 20 63 61 6e 20 6f 76 | 65 72 72 69 64 65 0d 0a |u can ov|erride..|
|00005db0| 74 68 65 73 65 20 64 65 | 66 61 75 6c 74 73 20 6c |these de|faults l|
|00005dc0| 61 74 65 72 20 69 66 20 | 79 6f 75 20 77 69 73 68 |ater if |you wish|
|00005dd0| 2e 7d 0d 0a 0d 0a 5c 6e | 61 72 72 6f 77 74 68 69 |.}....\n|arrowthi|
|00005de0| 6e 67 7b 43 72 65 61 74 | 65 20 61 20 73 63 72 69 |ng{Creat|e a scri|
|00005df0| 70 74 20 63 61 6c 6c 65 | 64 20 5c 64 71 70 7b 66 |pt calle|d \dqp{f|
|00005e00| 77 69 6e 69 74 2e 66 77 | 73 7d 3a 7d 7b 57 68 65 |winit.fw|s}:}{Whe|
|00005e10| 6e 20 46 75 6e 6e 65 6c | 57 65 62 0d 0a 73 74 61 |n Funnel|Web..sta|
|00005e20| 72 74 73 20 75 70 2c 20 | 69 74 20 65 78 65 63 75 |rts up, |it execu|
|00005e30| 74 65 73 20 61 20 73 63 | 72 69 70 74 20 63 61 6c |tes a sc|ript cal|
|00005e40| 6c 65 64 20 5c 64 71 70 | 7b 66 77 69 6e 69 74 2e |led \dqp|{fwinit.|
|00005e50| 66 77 73 7d 5c 78 7b 66 | 77 69 6e 69 74 2e 66 77 |fws}\x{f|winit.fw|
|00005e60| 73 7d 0d 0a 69 66 5c 78 | 78 7b 73 74 61 72 74 75 |s}..if\x|x{startu|
|00005e70| 70 7d 7b 73 63 72 69 70 | 74 7d 5c 78 78 7b 69 6e |p}{scrip|t}\xx{in|
|00005e80| 69 74 69 61 6c 69 7a 61 | 74 69 6f 6e 7d 7b 73 63 |itializa|tion}{sc|
|00005e90| 72 69 70 74 7d 20 73 75 | 63 68 20 61 0d 0a 73 63 |ript} su|ch a..sc|
|00005ea0| 72 69 70 74 20 65 78 69 | 73 74 73 20 69 6e 20 74 |ript exi|sts in t|
|00005eb0| 68 65 20 63 75 72 72 65 | 6e 74 20 64 69 72 65 63 |he curre|nt direc|
|00005ec0| 74 6f 72 79 2e 20 59 6f | 75 20 63 61 6e 20 75 73 |tory. Yo|u can us|
|00005ed0| 65 20 74 68 69 73 20 66 | 61 63 74 20 74 6f 20 73 |e this f|act to s|
|00005ee0| 65 74 20 6f 70 74 69 6f | 6e 73 0d 0a 62 65 66 6f |et optio|ns..befo|
|00005ef0| 72 65 20 74 68 65 20 72 | 75 6e 20 6f 66 20 46 75 |re the r|un of Fu|
|00005f00| 6e 6e 65 6c 57 65 62 20 | 70 72 6f 70 65 72 20 62 |nnelWeb |proper b|
|00005f10| 79 20 63 72 65 61 74 69 | 6e 67 20 73 75 63 68 20 |y creati|ng such |
|00005f20| 61 20 73 63 72 69 70 74 | 20 61 6e 64 20 70 6c 61 |a script| and pla|
|00005f30| 63 69 6e 67 0d 0a 61 20 | 73 69 6e 67 6c 65 20 5c |cing..a |single \|
|00005f40| 64 71 70 7b 73 65 74 7d | 20 63 6f 6d 6d 61 6e 64 |dqp{set}| command|
|00005f50| 20 69 6e 20 69 74 20 63 | 6f 6e 74 61 69 6e 69 6e | in it c|ontainin|
|00005f60| 67 20 74 68 65 20 64 65 | 73 69 72 65 64 20 6f 70 |g the de|sired op|
|00005f70| 74 69 6f 6e 73 2e 20 54 | 68 65 20 6d 61 69 6e 0d |tions. T|he main.|
|00005f80| 0a 74 72 6f 75 62 6c 65 | 20 77 69 74 68 20 74 68 |.trouble| with th|
|00005f90| 69 73 20 61 70 70 72 6f | 61 63 68 20 69 73 20 74 |is appro|ach is t|
|00005fa0| 68 61 74 20 74 68 65 20 | 6f 70 74 69 6f 6e 73 20 |hat the |options |
|00005fb0| 69 6e 20 74 68 65 20 5c | 70 7b 73 65 74 7d 20 63 |in the \|p{set} c|
|00005fc0| 6f 6d 6d 61 6e 64 20 77 | 69 6c 6c 0d 0a 62 65 20 |ommand w|ill..be |
|00005fd0| 70 72 6f 63 65 73 73 65 | 64 20 5c 69 7b 61 66 74 |processe|d \i{aft|
|00005fe0| 65 72 7d 20 74 68 65 20 | 63 6f 6d 6d 61 6e 64 20 |er} the |command |
|00005ff0| 6c 69 6e 65 20 6f 70 74 | 69 6f 6e 73 2c 20 77 68 |line opt|ions, wh|
|00006000| 69 63 68 20 6d 65 61 6e | 73 20 74 68 61 74 20 79 |ich mean|s that y|
|00006010| 6f 75 20 77 6f 6e 27 74 | 0d 0a 62 65 20 61 62 6c |ou won't|..be abl|
|00006020| 65 20 74 6f 20 6f 76 65 | 72 72 69 64 65 20 74 68 |e to ove|rride th|
|00006030| 65 6d 20 6f 6e 20 74 68 | 65 20 63 6f 6d 6d 61 6e |em on th|e comman|
|00006040| 64 20 6c 69 6e 65 2e 7d | 0d 0a 0d 0a 46 6f 72 20 |d line.}|....For |
|00006050| 65 78 61 6d 70 6c 65 2c | 20 79 6f 75 20 6d 69 67 |example,| you mig|
|00006060| 68 74 20 62 65 20 69 6e | 76 6f 6c 76 65 64 20 6d |ht be in|volved m|
|00006070| 6f 72 65 20 77 69 74 68 | 20 70 72 65 73 65 6e 74 |ore with| present|
|00006080| 69 6e 67 20 70 72 6f 67 | 72 61 6d 73 20 74 68 61 |ing prog|rams tha|
|00006090| 6e 20 77 69 74 68 0d 0a | 72 75 6e 6e 69 6e 67 20 |n with..|running |
|000060a0| 74 68 65 6d 2c 20 61 6e | 64 20 77 61 6e 74 20 46 |them, an|d want F|
|000060b0| 75 6e 6e 65 6c 57 65 62 | 20 74 6f 20 67 65 6e 65 |unnelWeb| to gene|
|000060c0| 72 61 74 65 20 61 20 64 | 6f 63 75 6d 65 6e 74 61 |rate a d|ocumenta|
|000060d0| 74 69 6f 6e 0d 0a 66 69 | 6c 65 20 62 79 20 64 65 |tion..fi|le by de|
|000060e0| 66 61 75 6c 74 2c 20 62 | 75 74 20 6e 6f 74 20 74 |fault, b|ut not t|
|000060f0| 6f 20 70 72 6f 64 75 63 | 65 0d 0a 6c 69 73 74 69 |o produc|e..listi|
|00006100| 6e 67 20 6f 72 20 70 72 | 6f 64 75 63 74 20 66 69 |ng or pr|oduct fi|
|00006110| 6c 65 73 20 62 79 20 64 | 65 66 61 75 6c 74 2e 20 |les by d|efault. |
|00006120| 49 6e 20 55 6e 69 78 20 | 79 6f 75 20 63 6f 75 6c |In Unix |you coul|
|00006130| 64 20 64 6f 20 74 68 69 | 73 20 77 69 74 68 3a 0d |d do thi|s with:.|
|00006140| 0a 0d 0a 5c 62 65 67 69 | 6e 7b 76 65 72 62 61 74 |...\begi|n{verbat|
|00006150| 69 6d 7d 0d 0a 61 6c 69 | 61 73 20 66 77 20 66 77 |im}..ali|as fw fw|
|00006160| 20 2d 4c 20 2d 4f 20 2b | 54 0d 0a 5c 65 6e 64 7b | -L -O +|T..\end{|
|00006170| 76 65 72 62 61 74 69 6d | 7d 0d 0a 0d 0a 5c 73 65 |verbatim|}....\se|
|00006180| 63 74 69 6f 6e 7b 46 75 | 6e 6e 65 6c 57 65 62 20 |ction{Fu|nnelWeb |
|00006190| 61 6e 64 20 4d 61 6b 65 | 7d 0d 0a 5c 78 7b 6d 61 |and Make|}..\x{ma|
|000061a0| 6b 65 20 75 74 69 6c 69 | 74 79 7d 5c 78 78 7b 66 |ke utili|ty}\xx{f|
|000061b0| 69 6c 65 7d 7b 64 65 70 | 65 6e 64 65 6e 63 69 65 |ile}{dep|endencie|
|000061c0| 73 7d 0d 0a 0d 0a 54 68 | 65 20 55 6e 69 78 20 5c |s}....Th|e Unix \|
|000061d0| 70 7b 4d 61 6b 65 7d 20 | 70 72 6f 67 72 61 6d 20 |p{Make} |program |
|000061e0| 61 6c 6c 6f 77 73 20 61 | 20 73 65 74 20 6f 66 20 |allows a| set of |
|000061f0| 64 65 70 65 6e 64 65 6e | 63 69 65 73 20 62 65 74 |dependen|cies bet|
|00006200| 77 65 65 6e 20 61 20 73 | 65 74 20 6f 66 0d 0a 66 |ween a s|et of..f|
|00006210| 69 6c 65 73 20 74 6f 20 | 62 65 20 64 65 73 63 72 |iles to |be descr|
|00006220| 69 62 65 64 2c 20 61 6e | 64 20 74 68 65 6e 20 75 |ibed, an|d then u|
|00006230| 73 65 73 20 74 68 65 73 | 65 20 64 65 70 65 6e 64 |ses thes|e depend|
|00006240| 65 6e 63 69 65 73 20 74 | 6f 20 63 6f 6e 74 72 6f |encies t|o contro|
|00006250| 6c 20 74 68 65 20 77 61 | 79 20 69 6e 0d 0a 77 68 |l the wa|y in..wh|
|00006260| 69 63 68 20 74 68 65 20 | 66 69 6c 65 73 20 61 72 |ich the |files ar|
|00006270| 65 20 63 72 65 61 74 65 | 64 20 61 6e 64 20 75 70 |e create|d and up|
|00006280| 64 61 74 65 64 2e 20 54 | 79 70 69 63 61 6c 6c 79 |dated. T|ypically|
|00006290| 2c 0d 0a 5c 70 7b 4d 61 | 6b 65 7d 20 69 73 20 75 |,..\p{Ma|ke} is u|
|000062a0| 73 65 64 20 74 6f 20 63 | 6f 6e 74 72 6f 6c 20 74 |sed to c|ontrol t|
|000062b0| 68 65 20 70 72 6f 63 65 | 73 73 20 6f 66 20 74 72 |he proce|ss of tr|
|000062c0| 61 6e 73 66 6f 72 6d 69 | 6e 67 20 61 20 63 6f 6c |ansformi|ng a col|
|000062d0| 6c 65 63 74 69 6f 6e 20 | 6f 66 0d 0a 73 6f 75 72 |lection |of..sour|
|000062e0| 63 65 20 63 6f 64 65 20 | 66 69 6c 65 73 20 74 6f |ce code |files to|
|000062f0| 20 6f 6e 65 20 6f 72 20 | 6d 6f 72 65 20 65 78 65 | one or |more exe|
|00006300| 63 75 74 61 62 6c 65 20 | 66 69 6c 65 73 2e 0d 0a |cutable |files...|
|00006310| 41 73 20 74 68 65 20 75 | 73 65 20 6f 66 20 46 75 |As the u|se of Fu|
|00006320| 6e 6e 65 6c 57 65 62 20 | 69 6d 70 6c 69 65 73 20 |nnelWeb |implies |
|00006330| 61 6e 20 65 78 74 72 61 | 20 73 74 61 67 65 20 74 |an extra| stage t|
|00006340| 6f 20 74 68 69 73 20 70 | 72 6f 63 65 73 73 2c 20 |o this p|rocess, |
|00006350| 69 74 20 69 73 0d 0a 6e | 61 74 75 72 61 6c 20 74 |it is..n|atural t|
|00006360| 6f 20 69 6e 63 6c 75 64 | 65 20 74 68 65 20 74 72 |o includ|e the tr|
|00006370| 61 6e 73 66 6f 72 6d 61 | 74 69 6f 6e 20 6f 66 20 |ansforma|tion of |
|00006380| 5c 70 7b 2e 66 77 7d 20 | 66 69 6c 65 73 20 74 6f |\p{.fw} |files to|
|00006390| 20 73 6f 75 72 63 65 20 | 63 6f 64 65 0d 0a 66 69 | source |code..fi|
|000063a0| 6c 65 73 20 61 73 20 70 | 61 72 74 20 6f 66 20 74 |les as p|art of t|
|000063b0| 68 65 20 5c 70 7b 4d 61 | 6b 65 7d 20 70 72 6f 63 |he \p{Ma|ke} proc|
|000063c0| 65 73 73 2e 20 54 68 69 | 73 20 69 73 20 65 61 73 |ess. Thi|s is eas|
|000063d0| 79 20 74 6f 20 64 6f 2c | 20 62 75 74 20 74 68 65 |y to do,| but the|
|000063e0| 20 75 73 65 72 0d 0a 73 | 68 6f 75 6c 64 20 62 65 | user..s|hould be|
|000063f0| 20 61 77 61 72 65 20 6f | 66 20 6f 6e 65 20 61 73 | aware o|f one as|
+--------+-------------------------+-------------------------+--------+--------+
Only 25.0 KB of data is shown above.