/ APDL Public Domain 1 / APDL_PD1A.iso / textutil / tex / source / latex_2e_1 / docstrip.dtx

< prev

next >

MacOS 8.1

Win98

DOS

browse contents

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 25 20 5c 69 66 66 61 6c | 73 65 20 6d 65 74 61 2d |% \iffal|se meta-|
|00000010| 63 6f 6d 6d 65 6e 74 0a | 25 0a 25 20 43 6f 70 79 |comment.|%.% Copy|
|00000020| 72 69 67 68 74 20 31 39 | 39 34 20 74 68 65 20 4c |right 19|94 the L|
|00000030| 61 54 65 58 33 20 70 72 | 6f 6a 65 63 74 20 61 6e |aTeX3 pr|oject an|
|00000040| 64 20 74 68 65 20 69 6e | 64 69 76 69 64 75 61 6c |d the in|dividual|
|00000050| 20 61 75 74 68 6f 72 73 | 2e 0a 25 20 41 6c 6c 20 | authors|..% All |
|00000060| 72 69 67 68 74 73 20 72 | 65 73 65 72 76 65 64 2e |rights r|eserved.|
|00000070| 20 46 6f 72 20 66 75 72 | 74 68 65 72 20 63 6f 70 | For fur|ther cop|
|00000080| 79 72 69 67 68 74 20 69 | 6e 66 6f 72 6d 61 74 69 |yright i|nformati|
|00000090| 6f 6e 20 73 65 65 20 74 | 68 65 20 66 69 6c 65 0a |on see t|he file.|
|000000a0| 25 20 6c 65 67 61 6c 2e | 74 78 74 2c 20 61 6e 64 |% legal.|txt, and|
|000000b0| 20 61 6e 79 20 6f 74 68 | 65 72 20 63 6f 70 79 72 | any oth|er copyr|
|000000c0| 69 67 68 74 20 69 6e 64 | 69 63 61 74 65 64 20 69 |ight ind|icated i|
|000000d0| 6e 20 74 68 69 73 20 66 | 69 6c 65 2e 0a 25 20 0a |n this f|ile..% .|
|000000e0| 25 20 54 68 69 73 20 66 | 69 6c 65 20 69 73 20 70 |% This f|ile is p|
|000000f0| 61 72 74 20 6f 66 20 74 | 68 65 20 4c 61 54 65 58 |art of t|he LaTeX|
|00000100| 32 65 20 73 79 73 74 65 | 6d 2e 0a 25 20 2d 2d 2d |2e syste|m..% ---|
|00000110| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00000120| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00000130| 2d 2d 2d 2d 2d 0a 25 20 | 0a 25 20 20 54 68 69 73 |-----.% |.%  This|
|00000140| 20 73 79 73 74 65 6d 20 | 69 73 20 64 69 73 74 72 | system |is distr|
|00000150| 69 62 75 74 65 64 20 69 | 6e 20 74 68 65 20 68 6f |ibuted i|n the ho|
|00000160| 70 65 20 74 68 61 74 20 | 69 74 20 77 69 6c 6c 20 |pe that |it will |
|00000170| 62 65 20 75 73 65 66 75 | 6c 2c 0a 25 20 20 62 75 |be usefu|l,.%  bu|
|00000180| 74 20 57 49 54 48 4f 55 | 54 20 41 4e 59 20 57 41 |t WITHOU|T ANY WA|
|00000190| 52 52 41 4e 54 59 3b 20 | 77 69 74 68 6f 75 74 20 |RRANTY; |without |
|000001a0| 65 76 65 6e 20 74 68 65 | 20 69 6d 70 6c 69 65 64 |even the| implied|
|000001b0| 20 77 61 72 72 61 6e 74 | 79 20 6f 66 0a 25 20 20 | warrant|y of.%  |
|000001c0| 4d 45 52 43 48 41 4e 54 | 41 42 49 4c 49 54 59 20 |MERCHANT|ABILITY |
|000001d0| 6f 72 20 46 49 54 4e 45 | 53 53 20 46 4f 52 20 41 |or FITNE|SS FOR A|
|000001e0| 20 50 41 52 54 49 43 55 | 4c 41 52 20 50 55 52 50 | PARTICU|LAR PURP|
|000001f0| 4f 53 45 2e 0a 25 20 0a | 25 20 0a 25 20 49 4d 50 |OSE..% .|% .% IMP|
|00000200| 4f 52 54 41 4e 54 20 4e | 4f 54 49 43 45 3a 0a 25 |ORTANT N|OTICE:.%|
|00000210| 20 0a 25 20 46 6f 72 20 | 65 72 72 6f 72 20 72 65 | .% For |error re|
|00000220| 70 6f 72 74 73 20 69 6e | 20 63 61 73 65 20 6f 66 |ports in| case of|
|00000230| 20 55 4e 43 48 41 4e 47 | 45 44 20 76 65 72 73 69 | UNCHANG|ED versi|
|00000240| 6f 6e 73 20 73 65 65 20 | 62 75 67 73 2e 74 78 74 |ons see |bugs.txt|
|00000250| 2e 0a 25 20 0a 25 20 50 | 6c 65 61 73 65 20 64 6f |..% .% P|lease do|
|00000260| 20 6e 6f 74 20 72 65 71 | 75 65 73 74 20 75 70 64 | not req|uest upd|
|00000270| 61 74 65 73 20 66 72 6f | 6d 20 75 73 20 64 69 72 |ates fro|m us dir|
|00000280| 65 63 74 6c 79 2e 20 20 | 44 69 73 74 72 69 62 75 |ectly.  |Distribu|
|00000290| 74 69 6f 6e 20 69 73 0a | 25 20 64 6f 6e 65 20 74 |tion is.|% done t|
|000002a0| 68 72 6f 75 67 68 20 4d | 61 69 6c 2d 53 65 72 76 |hrough M|ail-Serv|
|000002b0| 65 72 73 20 61 6e 64 20 | 54 65 58 20 6f 72 67 61 |ers and |TeX orga|
|000002c0| 6e 69 7a 61 74 69 6f 6e | 73 2e 0a 25 20 0a 25 20 |nization|s..% .% |
|000002d0| 59 6f 75 20 61 72 65 20 | 6e 6f 74 20 61 6c 6c 6f |You are |not allo|
|000002e0| 77 65 64 20 74 6f 20 63 | 68 61 6e 67 65 20 74 68 |wed to c|hange th|
|000002f0| 69 73 20 66 69 6c 65 2e | 0a 25 20 0a 25 20 59 6f |is file.|.% .% Yo|
|00000300| 75 20 61 72 65 20 61 6c | 6c 6f 77 65 64 20 74 6f |u are al|lowed to|
|00000310| 20 64 69 73 74 72 69 62 | 75 74 65 20 74 68 69 73 | distrib|ute this|
|00000320| 20 66 69 6c 65 20 75 6e | 64 65 72 20 74 68 65 20 | file un|der the |
|00000330| 63 6f 6e 64 69 74 69 6f | 6e 20 74 68 61 74 0a 25 |conditio|n that.%|
|00000340| 20 69 74 20 69 73 20 64 | 69 73 74 72 69 62 75 74 | it is d|istribut|
|00000350| 65 64 20 74 6f 67 65 74 | 68 65 72 20 77 69 74 68 |ed toget|her with|
|00000360| 20 61 6c 6c 20 66 69 6c | 65 73 20 6d 65 6e 74 69 | all fil|es menti|
|00000370| 6f 6e 65 64 20 69 6e 20 | 6d 61 6e 69 66 65 73 74 |oned in |manifest|
|00000380| 2e 74 78 74 2e 0a 25 20 | 0a 25 20 49 66 20 79 6f |.txt..% |.% If yo|
|00000390| 75 20 72 65 63 65 69 76 | 65 20 6f 6e 6c 79 20 73 |u receiv|e only s|
|000003a0| 6f 6d 65 20 6f 66 20 74 | 68 65 73 65 20 66 69 6c |ome of t|hese fil|
|000003b0| 65 73 20 66 72 6f 6d 20 | 73 6f 6d 65 6f 6e 65 2c |es from |someone,|
|000003c0| 20 63 6f 6d 70 6c 61 69 | 6e 21 0a 25 20 0a 25 20 | complai|n!.% .% |
|000003d0| 59 6f 75 20 61 72 65 20 | 4e 4f 54 20 41 4c 4c 4f |You are |NOT ALLO|
|000003e0| 57 45 44 20 74 6f 20 64 | 69 73 74 72 69 62 75 74 |WED to d|istribut|
|000003f0| 65 20 74 68 69 73 20 66 | 69 6c 65 20 61 6c 6f 6e |e this f|ile alon|
|00000400| 65 2e 20 20 59 6f 75 20 | 61 72 65 20 4e 4f 54 0a |e.  You |are NOT.|
|00000410| 25 20 41 4c 4c 4f 57 45 | 44 20 74 6f 20 74 61 6b |% ALLOWE|D to tak|
|00000420| 65 20 6d 6f 6e 65 79 20 | 66 6f 72 20 74 68 65 20 |e money |for the |
|00000430| 64 69 73 74 72 69 62 75 | 74 69 6f 6e 20 6f 72 20 |distribu|tion or |
|00000440| 75 73 65 20 6f 66 20 65 | 69 74 68 65 72 20 74 68 |use of e|ither th|
|00000450| 69 73 0a 25 20 66 69 6c | 65 20 6f 72 20 61 20 63 |is.% fil|e or a c|
|00000460| 68 61 6e 67 65 64 20 76 | 65 72 73 69 6f 6e 2c 20 |hanged v|ersion, |
|00000470| 65 78 63 65 70 74 20 66 | 6f 72 20 61 20 6e 6f 6d |except f|or a nom|
|00000480| 69 6e 61 6c 20 63 68 61 | 72 67 65 20 66 6f 72 20 |inal cha|rge for |
|00000490| 63 6f 70 79 69 6e 67 0a | 25 20 65 74 63 2e 0a 25 |copying.|% etc..%|
|000004a0| 20 5c 66 69 0a 5c 64 65 | 66 5c 66 69 6c 65 6e 61 | \fi.\de|f\filena|
|000004b0| 6d 65 7b 64 6f 63 73 74 | 72 69 70 2e 64 74 78 7d |me{docst|rip.dtx}|
|000004c0| 0a 5c 64 65 66 5c 66 69 | 6c 65 76 65 72 73 69 6f |.\def\fi|leversio|
|000004d0| 6e 7b 32 2e 32 68 7d 0a | 5c 64 65 66 5c 66 69 6c |n{2.2h}.|\def\fil|
|000004e0| 65 64 61 74 65 7b 31 39 | 39 34 2f 30 32 2f 32 36 |edate{19|94/02/26|
|000004f0| 7d 0a 5c 64 65 66 5c 64 | 6f 63 64 61 74 65 20 7b |}.\def\d|ocdate {|
|00000500| 31 39 39 34 2f 30 36 2f | 30 39 7d 0a 0a 25 20 5c |1994/06/|09}..% \|
|00000510| 43 68 65 63 6b 53 75 6d | 7b 31 35 30 34 7d 0a 25 |CheckSum|{1504}.%|
|00000520| 25 20 5c 43 68 61 72 61 | 63 74 65 72 54 61 62 6c |% \Chara|cterTabl|
|00000530| 65 0a 25 25 20 20 7b 55 | 70 70 65 72 2d 63 61 73 |e.%%  {U|pper-cas|
|00000540| 65 20 20 20 20 5c 41 5c | 42 5c 43 5c 44 5c 45 5c |e    \A\|B\C\D\E\|
|00000550| 46 5c 47 5c 48 5c 49 5c | 4a 5c 4b 5c 4c 5c 4d 5c |F\G\H\I\|J\K\L\M\|
|00000560| 4e 5c 4f 5c 50 5c 51 5c | 52 5c 53 5c 54 5c 55 5c |N\O\P\Q\|R\S\T\U\|
|00000570| 56 5c 57 5c 58 5c 59 5c | 5a 0a 25 25 20 20 20 4c |V\W\X\Y\|Z.%%   L|
|00000580| 6f 77 65 72 2d 63 61 73 | 65 20 20 20 20 5c 61 5c |ower-cas|e    \a\|
|00000590| 62 5c 63 5c 64 5c 65 5c | 66 5c 67 5c 68 5c 69 5c |b\c\d\e\|f\g\h\i\|
|000005a0| 6a 5c 6b 5c 6c 5c 6d 5c | 6e 5c 6f 5c 70 5c 71 5c |j\k\l\m\|n\o\p\q\|
|000005b0| 72 5c 73 5c 74 5c 75 5c | 76 5c 77 5c 78 5c 79 5c |r\s\t\u\|v\w\x\y\|
|000005c0| 7a 0a 25 25 20 20 20 44 | 69 67 69 74 73 20 20 20 |z.%%   D|igits   |
|000005d0| 20 20 20 20 20 5c 30 5c | 31 5c 32 5c 33 5c 34 5c |     \0\|1\2\3\4\|
|000005e0| 35 5c 36 5c 37 5c 38 5c | 39 0a 25 25 20 20 20 45 |5\6\7\8\|9.%%   E|
|000005f0| 78 63 6c 61 6d 61 74 69 | 6f 6e 20 20 20 5c 21 20 |xclamati|on   \! |
|00000600| 20 20 20 20 44 6f 75 62 | 6c 65 20 71 75 6f 74 65 |    Doub|le quote|
|00000610| 20 20 5c 22 20 20 20 20 | 20 48 61 73 68 20 28 6e |  \"    | Hash (n|
|00000620| 75 6d 62 65 72 29 20 5c | 23 0a 25 25 20 20 20 44 |umber) \|#.%%   D|
|00000630| 6f 6c 6c 61 72 20 20 20 | 20 20 20 20 20 5c 24 20 |ollar   |     \$ |
|00000640| 20 20 20 20 50 65 72 63 | 65 6e 74 20 20 20 20 20 |    Perc|ent     |
|00000650| 20 20 5c 25 20 20 20 20 | 20 41 6d 70 65 72 73 61 |  \%    | Ampersa|
|00000660| 6e 64 20 20 20 20 20 5c | 26 0a 25 25 20 20 20 41 |nd     \|&.%%   A|
|00000670| 63 75 74 65 20 61 63 63 | 65 6e 74 20 20 5c 27 20 |cute acc|ent  \' |
|00000680| 20 20 20 20 4c 65 66 74 | 20 70 61 72 65 6e 20 20 |    Left| paren  |
|00000690| 20 20 5c 28 20 20 20 20 | 20 52 69 67 68 74 20 70 |  \(    | Right p|
|000006a0| 61 72 65 6e 20 20 20 5c | 29 0a 25 25 20 20 20 41 |aren   \|).%%   A|
|000006b0| 73 74 65 72 69 73 6b 20 | 20 20 20 20 20 5c 2a 20 |sterisk |     \* |
|000006c0| 20 20 20 20 50 6c 75 73 | 20 20 20 20 20 20 20 20 |    Plus|        |
|000006d0| 20 20 5c 2b 20 20 20 20 | 20 43 6f 6d 6d 61 20 20 |  \+    | Comma  |
|000006e0| 20 20 20 20 20 20 20 5c | 2c 0a 25 25 20 20 20 4d |       \|,.%%   M|
|000006f0| 69 6e 75 73 20 20 20 20 | 20 20 20 20 20 5c 2d 20 |inus    |     \- |
|00000700| 20 20 20 20 50 6f 69 6e | 74 20 20 20 20 20 20 20 |    Poin|t       |
|00000710| 20 20 5c 2e 20 20 20 20 | 20 53 6f 6c 69 64 75 73 |  \.    | Solidus|
|00000720| 20 20 20 20 20 20 20 5c | 2f 0a 25 25 20 20 20 43 |       \|/.%%   C|
|00000730| 6f 6c 6f 6e 20 20 20 20 | 20 20 20 20 20 5c 3a 20 |olon    |     \: |
|00000740| 20 20 20 20 53 65 6d 69 | 63 6f 6c 6f 6e 20 20 20 |    Semi|colon   |
|00000750| 20 20 5c 3b 20 20 20 20 | 20 4c 65 73 73 20 74 68 |  \;    | Less th|
|00000760| 61 6e 20 20 20 20 20 5c | 3c 0a 25 25 20 20 20 45 |an     \|<.%%   E|
|00000770| 71 75 61 6c 73 20 20 20 | 20 20 20 20 20 5c 3d 20 |quals   |     \= |
|00000780| 20 20 20 20 47 72 65 61 | 74 65 72 20 74 68 61 6e |    Grea|ter than|
|00000790| 20 20 5c 3e 20 20 20 20 | 20 51 75 65 73 74 69 6f |  \>    | Questio|
|000007a0| 6e 20 6d 61 72 6b 20 5c | 3f 0a 25 25 20 20 20 43 |n mark \|?.%%   C|
|000007b0| 6f 6d 6d 65 72 63 69 61 | 6c 20 61 74 20 5c 40 20 |ommercia|l at \@ |
|000007c0| 20 20 20 20 4c 65 66 74 | 20 62 72 61 63 6b 65 74 |    Left| bracket|
|000007d0| 20 20 5c 5b 20 20 20 20 | 20 42 61 63 6b 73 6c 61 |  \[    | Backsla|
|000007e0| 73 68 20 20 20 20 20 5c | 5c 0a 25 25 20 20 20 52 |sh     \|\.%%   R|
|000007f0| 69 67 68 74 20 62 72 61 | 63 6b 65 74 20 5c 5d 20 |ight bra|cket \] |
|00000800| 20 20 20 20 43 69 72 63 | 75 6d 66 6c 65 78 20 20 |    Circ|umflex  |
|00000810| 20 20 5c 5e 20 20 20 20 | 20 55 6e 64 65 72 73 63 |  \^    | Undersc|
|00000820| 6f 72 65 20 20 20 20 5c | 5f 0a 25 25 20 20 20 47 |ore    \|_.%%   G|
|00000830| 72 61 76 65 20 61 63 63 | 65 6e 74 20 20 5c 60 20 |rave acc|ent  \` |
|00000840| 20 20 20 20 4c 65 66 74 | 20 62 72 61 63 65 20 20 |    Left| brace  |
|00000850| 20 20 5c 7b 20 20 20 20 | 20 56 65 72 74 69 63 61 |  \{    | Vertica|
|00000860| 6c 20 62 61 72 20 20 5c | 7c 0a 25 25 20 20 20 52 |l bar  \||.%%   R|
|00000870| 69 67 68 74 20 62 72 61 | 63 65 20 20 20 5c 7d 20 |ight bra|ce   \} |
|00000880| 20 20 20 20 54 69 6c 64 | 65 20 20 20 20 20 20 20 |    Tild|e       |
|00000890| 20 20 5c 7e 7d 0a 25 25 | 0a 25 0a 25 5c 69 66 66 |  \~}.%%|.%.%\iff|
|000008a0| 61 6c 73 65 0a 25 0a 25 | 25 20 54 68 65 20 64 6f |alse.%.%|% The do|
|000008b0| 63 73 74 72 69 70 20 70 | 72 6f 67 72 61 6d 20 66 |cstrip p|rogram f|
|000008c0| 6f 72 20 75 73 65 20 77 | 69 74 68 20 54 65 58 2e |or use w|ith TeX.|
|000008d0| 0a 25 25 20 43 6f 70 79 | 72 69 67 68 74 20 28 43 |.%% Copy|right (C|
|000008e0| 29 20 31 39 38 39 2d 31 | 39 39 31 20 46 72 61 6e |) 1989-1|991 Fran|
|000008f0| 6b 20 4d 69 74 74 65 6c | 62 61 63 68 0a 25 25 20 |k Mittel|bach.%% |
|00000900| 43 6f 70 79 72 69 67 68 | 74 20 28 43 29 20 31 39 |Copyrigh|t (C) 19|
|00000910| 39 32 2d 31 39 39 34 20 | 4a 6f 68 61 6e 6e 65 73 |92-1994 |Johannes|
|00000920| 20 42 72 61 61 6d 73 2c | 20 44 65 6e 79 73 20 44 | Braams,| Denys D|
|00000930| 75 63 68 69 65 72 2c 20 | 0a 25 25 20 20 20 20 20 |uchier, |.%%     |
|00000940| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00000950| 20 20 20 20 46 72 61 6e | 6b 20 4d 69 74 74 65 6c |    Fran|k Mittel|
|00000960| 62 61 63 68 0a 25 25 20 | 41 6c 6c 20 72 69 67 68 |bach.%% |All righ|
|00000970| 74 73 20 61 72 65 20 72 | 65 73 65 72 76 65 64 2e |ts are r|eserved.|
|00000980| 0a 25 25 0a 25 0a 25 20 | 5c 66 69 0a 25 0a 25 20 |.%%.%.% |\fi.%.% |
|00000990| 5c 63 68 61 6e 67 65 73 | 7b 32 2e 30 62 7d 7b 31 |\changes|{2.0b}{1|
|000009a0| 39 39 31 2f 30 35 2f 32 | 39 7d 7b 41 64 64 65 64 |991/05/2|9}{Added|
|000009b0| 20 62 75 67 66 69 78 20 | 66 72 6f 6d 20 44 65 6e | bugfix |from Den|
|000009c0| 79 73 7d 0a 25 20 5c 63 | 68 61 6e 67 65 73 7b 32 |ys}.% \c|hanges{2|
|000009d0| 2e 30 63 7d 7b 31 39 39 | 31 2f 30 35 2f 32 39 7d |.0c}{199|1/05/29}|
|000009e0| 7b 41 6c 6c 6f 77 20 61 | 6c 6d 6f 73 74 20 61 6c |{Allow a|lmost al|
|000009f0| 6c 20 63 68 61 72 61 63 | 74 65 72 73 20 69 6e 20 |l charac|ters in |
|00000a00| 67 75 61 72 64 20 28 44 | 44 29 7d 0a 25 20 5c 63 |guard (D|D)}.% \c|
|00000a10| 68 61 6e 67 65 73 7b 32 | 2e 30 64 7d 7b 31 39 39 |hanges{2|.0d}{199|
|00000a20| 31 2f 30 35 2f 33 31 7d | 7b 53 74 61 72 74 65 64 |1/05/31}|{Started|
|00000a30| 20 6d 65 72 67 69 6e 67 | 20 69 6e 20 73 6f 6d 65 | merging| in some|
|00000a40| 20 6f 66 20 46 72 61 6e | 6b 73 20 63 6f 64 65 7d | of Fran|ks code}|
|00000a50| 0a 25 20 5c 63 68 61 6e | 67 65 73 7b 32 2e 30 6a |.% \chan|ges{2.0j|
|00000a60| 7d 7b 31 39 39 32 2f 30 | 33 2f 30 35 7d 7b 57 72 |}{1992/0|3/05}{Wr|
|00000a70| 6f 74 65 20 69 6e 74 72 | 6f 64 75 63 74 69 6f 6e |ote intr|oduction|
|00000a80| 7d 0a 25 20 5c 63 68 61 | 6e 67 65 73 7b 32 2e 30 |}.% \cha|nges{2.0|
|00000a90| 6d 7d 7b 31 39 39 32 2f | 30 34 2f 32 31 7d 7b 52 |m}{1992/|04/21}{R|
|00000aa0| 65 6e 61 6d 65 64 20 61 | 6c 6c 20 6d 61 63 72 6f |enamed a|ll macro|
|00000ab0| 73 20 74 68 61 74 20 64 | 65 61 6c 20 77 69 74 68 |s that d|eal with|
|00000ac0| 20 74 68 65 0a 25 20 20 | 20 20 20 20 20 20 20 20 | the.%  |        |
|00000ad0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00000ae0| 20 70 61 72 73 69 6e 67 | 20 6f 66 20 62 6f 6f 6c | parsing| of bool|
|00000af0| 65 61 6e 20 65 78 70 72 | 65 73 73 69 6f 6e 73 7d |ean expr|essions}|
|00000b00| 0a 25 20 5c 63 68 61 6e | 67 65 73 7b 32 2e 30 6d |.% \chan|ges{2.0m|
|00000b10| 7d 7b 31 39 39 32 2f 30 | 34 2f 32 35 7d 7b 52 65 |}{1992/0|4/25}{Re|
|00000b20| 6d 6f 76 65 64 20 64 65 | 70 65 6e 64 65 6e 63 79 |moved de|pendency|
|00000b30| 20 66 72 6f 6d 20 6c 74 | 75 67 62 6f 61 74 2c 0a | from lt|ugboat,.|
|00000b40| 25 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |%       |        |
|00000b50| 20 20 20 20 20 20 20 20 | 20 20 20 69 6e 63 6f 72 |        |   incor|
|00000b60| 70 6f 72 61 74 65 64 20 | 64 72 69 76 65 72 20 66 |porated |driver f|
|00000b70| 69 6c 65 20 69 6e 74 6f | 20 73 6f 75 72 63 65 2e |ile into| source.|
|00000b80| 7d 0a 25 20 5c 63 68 61 | 6e 67 65 73 7b 32 2e 30 |}.% \cha|nges{2.0|
|00000b90| 6d 7d 7b 31 39 39 32 2f | 30 34 2f 32 35 7d 7b 41 |m}{1992/|04/25}{A|
|00000ba0| 64 64 65 64 20 73 6f 6d | 65 20 6d 69 73 73 69 6e |dded som|e missin|
|00000bb0| 67 20 70 65 72 63 65 6e | 74 73 3b 20 63 6f 72 72 |g percen|ts; corr|
|00000bc0| 65 63 74 65 64 20 73 6f | 6d 65 0a 25 20 20 20 20 |ected so|me.%    |
|00000bd0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00000be0| 20 20 20 20 20 20 74 79 | 70 6f 73 7d 0a 25 20 5c |      ty|pos}.% \|
|00000bf0| 63 68 61 6e 67 65 73 7b | 32 2e 30 6d 2d 44 4c 7d |changes{|2.0m-DL}|
|00000c00| 7b 31 39 39 32 2f 30 35 | 2f 30 38 7d 7b 56 61 72 |{1992/05|/08}{Var|
|00000c10| 69 6f 75 73 20 73 6d 61 | 6c 6c 20 63 6f 72 72 65 |ious sma|ll corre|
|00000c20| 63 74 69 6f 6e 73 20 74 | 6f 20 45 6e 67 6c 69 73 |ctions t|o Englis|
|00000c30| 68 20 61 6e 64 0a 25 20 | 20 20 20 20 20 20 20 20 |h and.% |        |
|00000c40| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00000c50| 20 20 74 79 70 6f 73 7d | 0a 25 20 5c 63 68 61 6e |  typos}|.% \chan|
|00000c60| 67 65 73 7b 32 2e 30 71 | 7d 7b 31 39 39 32 2f 30 |ges{2.0q|}{1992/0|
|00000c70| 37 2f 30 31 7d 7b 43 68 | 61 6e 67 65 64 20 61 6c |7/01}{Ch|anged al|
|00000c80| 6c 20 64 61 74 65 73 20 | 74 6f 20 79 79 2f 6d 6d |l dates |to yy/mm|
|00000c90| 2f 64 64 20 66 6f 72 20 | 62 65 74 74 65 72 0a 25 |/dd for |better.%|
|00000ca0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00000cb0| 20 20 20 20 20 20 20 20 | 20 20 73 6f 72 74 69 6e |        |  sortin|
|00000cc0| 67 7d 0a 25 20 5c 63 68 | 61 6e 67 65 73 7b 32 2e |g}.% \ch|anges{2.|
|00000cd0| 32 61 7d 7b 31 39 39 33 | 2f 31 32 2f 30 32 7d 7b |2a}{1993|/12/02}{|
|00000ce0| 55 70 64 61 74 65 20 66 | 6f 72 20 4c 61 54 65 58 |Update f|or LaTeX|
|00000cf0| 32 65 7d 0a 25 20 5c 63 | 68 61 6e 67 65 73 7b 32 |2e}.% \c|hanges{2|
|00000d00| 2e 32 63 7d 7b 31 39 39 | 33 2f 31 32 2f 31 37 7d |.2c}{199|3/12/17}|
|00000d10| 7b 52 65 6e 61 6d 65 64 | 20 74 65 78 73 79 73 2e |{Renamed| texsys.|
|00000d20| 74 65 78 20 74 6f 20 74 | 65 78 73 79 73 2e 63 66 |tex to t|exsys.cf|
|00000d30| 67 2e 7d 0a 25 0a 25 20 | 5c 44 6f 4e 6f 74 49 6e |g.}.%.% |\DoNotIn|
|00000d40| 64 65 78 7b 5c 23 2c 5c | 24 2c 5c 25 2c 5c 26 2c |dex{\#,\|$,\%,\&,|
|00000d50| 5c 40 2c 5c 5c 2c 5c 7b | 2c 5c 7d 2c 5c 5e 2c 5c |\@,\\,\{|,\},\^,\|
|00000d60| 5f 2c 5c 7e 2c 5c 20 7d | 0a 25 20 5c 44 6f 4e 6f |_,\~,\ }|.% \DoNo|
|00000d70| 74 49 6e 64 65 78 7b 5c | 40 6e 65 7d 0a 25 20 5c |tIndex{\|@ne}.% \|
|00000d80| 44 6f 4e 6f 74 49 6e 64 | 65 78 7b 5c 61 64 76 61 |DoNotInd|ex{\adva|
|00000d90| 6e 63 65 2c 5c 62 65 67 | 69 6e 67 72 6f 75 70 2c |nce,\beg|ingroup,|
|00000da0| 5c 63 61 74 63 6f 64 65 | 2c 5c 63 6c 6f 73 65 69 |\catcode|,\closei|
|00000db0| 6e 2c 5c 63 6c 6f 73 65 | 6f 75 74 7d 0a 25 20 5c |n,\close|out}.% \|
|00000dc0| 44 6f 4e 6f 74 49 6e 64 | 65 78 7b 5c 64 61 79 2c |DoNotInd|ex{\day,|
|00000dd0| 5c 64 65 66 2c 5c 65 64 | 65 66 2c 5c 65 6c 73 65 |\def,\ed|ef,\else|
|00000de0| 2c 5c 65 6d 70 74 79 2c | 5c 65 6e 64 67 72 6f 75 |,\empty,|\endgrou|
|00000df0| 70 2c 5c 65 72 72 6d 65 | 73 73 61 67 65 7d 0a 25 |p,\errme|ssage}.%|
|00000e00| 20 5c 44 6f 4e 6f 74 49 | 6e 64 65 78 7b 5c 65 78 | \DoNotI|ndex{\ex|
|00000e10| 70 61 6e 64 61 66 74 65 | 72 2c 5c 66 69 2c 5c 66 |pandafte|r,\fi,\f|
|00000e20| 75 74 75 72 65 6c 65 74 | 2c 5c 67 64 65 66 2c 5c |uturelet|,\gdef,\|
|00000e30| 67 6c 6f 62 61 6c 2c 5c | 69 66 2c 5c 69 66 65 6f |global,\|if,\ifeo|
|00000e40| 66 7d 0a 25 20 5c 44 6f | 4e 6f 74 49 6e 64 65 78 |f}.% \Do|NotIndex|
|00000e50| 7b 5c 69 66 78 2c 5c 69 | 6d 6d 65 64 69 61 74 65 |{\ifx,\i|mmediate|
|00000e60| 2c 5c 6c 65 74 2c 5c 6c | 6f 6f 70 2c 5c 6d 40 6e |,\let,\l|oop,\m@n|
|00000e70| 65 2c 5c 6d 65 73 73 61 | 67 65 2c 5c 6d 6f 6e 74 |e,\messa|ge,\mont|
|00000e80| 68 7d 0a 25 20 5c 44 6f | 4e 6f 74 49 6e 64 65 78 |h}.% \Do|NotIndex|
|00000e90| 7b 5c 6e 65 77 63 6f 75 | 6e 74 7d 0a 25 20 5c 44 |{\newcou|nt}.% \D|
|00000ea0| 6f 4e 6f 74 49 6e 64 65 | 78 7b 5c 6e 65 77 69 66 |oNotInde|x{\newif|
|00000eb0| 2c 5c 6e 65 77 6c 69 6e | 65 63 68 61 72 2c 5c 6e |,\newlin|echar,\n|
|00000ec0| 65 77 72 65 61 64 2c 5c | 6e 65 77 74 6f 6b 73 2c |ewread,\|newtoks,|
|00000ed0| 5c 6e 65 77 77 72 69 74 | 65 7d 0a 25 20 5c 44 6f |\newwrit|e}.% \Do|
|00000ee0| 4e 6f 74 49 6e 64 65 78 | 7b 5c 6e 6f 65 78 70 61 |NotIndex|{\noexpa|
|00000ef0| 6e 64 2c 5c 6f 70 65 6e | 69 6e 2c 5c 6f 70 65 6e |nd,\open|in,\open|
|00000f00| 6f 75 74 2c 5c 70 61 72 | 2c 5c 72 65 61 64 2c 5c |out,\par|,\read,\|
|00000f10| 72 65 6c 61 78 2c 5c 72 | 65 70 65 61 74 7d 0a 25 |relax,\r|epeat}.%|
|00000f20| 20 5c 44 6f 4e 6f 74 49 | 6e 64 65 78 7b 5c 73 70 | \DoNotI|ndex{\sp|
|00000f30| 61 63 65 2c 5c 74 68 65 | 2c 5c 75 6e 64 65 66 69 |ace,\the|,\undefi|
|00000f40| 6e 65 64 2c 5c 77 72 69 | 74 65 2c 5c 78 64 65 66 |ned,\wri|te,\xdef|
|00000f50| 2c 5c 79 65 61 72 2c 5c | 7a 40 7d 0a 25 0a 25 20 |,\year,\|z@}.%.% |
|00000f60| 5e 5e 41 20 73 6f 6d 65 | 20 64 65 66 69 6e 69 74 |^^A some| definit|
|00000f70| 69 6f 6e 73 20 66 6f 72 | 20 74 68 69 73 20 64 6f |ions for| this do|
|00000f80| 63 75 6d 65 6e 74 61 74 | 69 6f 6e 0a 25 0a 25 20 |cumentat|ion.%.% |
|00000f90| 5c 6e 65 77 63 6f 6d 6d | 61 6e 64 7b 5c 64 73 7d |\newcomm|and{\ds}|
|00000fa0| 7b 5c 74 65 78 74 73 66 | 7b 44 6f 63 53 74 72 69 |{\textsf|{DocStri|
|00000fb0| 70 7d 7d 20 5e 5e 41 20 | 6d 61 79 62 65 3f 0a 25 |p}} ^^A |maybe?.%|
|00000fc0| 20 5c 6e 65 77 63 6f 6d | 6d 61 6e 64 7b 5c 62 73 | \newcom|mand{\bs|
|00000fd0| 6c 7d 7b 5c 70 72 6f 74 | 65 63 74 5c 62 73 6c 61 |l}{\prot|ect\bsla|
|00000fe0| 73 68 7d 0a 25 20 5c 6e | 65 77 63 6f 6d 6d 61 6e |sh}.% \n|ewcomman|
|00000ff0| 64 7b 5c 6e 6f 74 65 7d | 5b 31 5d 7b 5c 6d 61 72 |d{\note}|[1]{\mar|
|00001000| 67 69 6e 70 61 72 7b 5c | 74 65 78 74 62 66 7b 23 |ginpar{\|textbf{#|
|00001010| 31 7d 7d 7d 0a 25 20 5c | 6e 65 77 63 6f 6d 6d 61 |1}}}.% \|newcomma|
|00001020| 6e 64 7b 5c 6e 65 74 61 | 64 64 72 65 73 73 7d 5b |nd{\neta|ddress}[|
|00001030| 31 5d 7b 5c 74 65 78 74 | 74 74 7b 23 31 7d 7d 0a |1]{\text|tt{#1}}.|
|00001040| 25 0a 25 20 5e 5e 41 20 | 6f 76 65 72 72 69 64 65 |%.% ^^A |override|
|00001050| 20 74 68 65 20 64 65 66 | 61 75 6c 74 20 69 6e 20 | the def|ault in |
|00001060| 64 6f 63 2e 73 74 79 0a | 25 20 5c 6d 61 6b 65 61 |doc.sty.|% \makea|
|00001070| 74 6c 65 74 74 65 72 0a | 25 20 5c 72 65 6e 65 77 |tletter.|% \renew|
|00001080| 65 6e 76 69 72 6f 6e 6d | 65 6e 74 7b 74 68 65 67 |environm|ent{theg|
|00001090| 6c 6f 73 73 61 72 79 7d | 7b 25 0a 25 20 20 20 20 |lossary}|{%.%    |
|000010a0| 5c 67 6c 6f 73 73 61 72 | 79 40 70 72 6f 6c 6f 67 |\glossar|y@prolog|
|000010b0| 75 65 25 0a 25 20 20 20 | 20 5c 47 6c 6f 73 73 61 |ue%.%   | \Glossa|
|000010c0| 72 79 50 61 72 6d 73 20 | 5c 6c 65 74 5c 69 74 65 |ryParms |\let\ite|
|000010d0| 6d 5c 40 69 64 78 69 74 | 65 6d 20 5c 69 67 6e 6f |m\@idxit|em \igno|
|000010e0| 72 65 73 70 61 63 65 73 | 7d 25 0a 25 20 20 20 7b |respaces|}%.%   {|
|000010f0| 7d 0a 25 20 5c 6d 61 6b | 65 61 74 6f 74 68 65 72 |}.% \mak|eatother|
|00001100| 0a 25 0a 25 0a 25 20 5c | 63 68 61 6e 67 65 73 7b |.%.%.% \|changes{|
|00001110| 32 2e 31 63 7d 7b 31 39 | 39 33 2f 30 32 2f 32 35 |2.1c}{19|93/02/25|
|00001120| 7d 7b 41 64 64 65 64 20 | 61 20 73 65 74 74 69 6e |}{Added |a settin|
|00001130| 67 20 66 6f 72 20 53 74 | 61 6e 64 61 72 64 4d 6f |g for St|andardMo|
|00001140| 64 75 6c 65 44 65 70 74 | 68 7d 0a 25 20 5c 73 65 |duleDept|h}.% \se|
|00001150| 74 63 6f 75 6e 74 65 72 | 7b 53 74 61 6e 64 61 72 |tcounter|{Standar|
|00001160| 64 4d 6f 64 75 6c 65 44 | 65 70 74 68 7d 7b 31 7d |dModuleD|epth}{1}|
|00001170| 0a 25 0a 25 20 5c 74 69 | 74 6c 65 7b 54 68 65 20 |.%.% \ti|tle{The |
|00001180| 5c 64 73 7b 7d 20 70 72 | 6f 67 72 61 6d 25 0a 25 |\ds{} pr|ogram%.%|
|00001190| 20 20 20 20 20 20 20 20 | 20 5c 74 68 61 6e 6b 73 |        | \thanks|
|000011a0| 7b 54 68 69 73 20 66 69 | 6c 65 20 68 61 73 20 76 |{This fi|le has v|
|000011b0| 65 72 73 69 6f 6e 20 6e | 75 6d 62 65 72 20 5c 66 |ersion n|umber \f|
|000011c0| 69 6c 65 76 65 72 73 69 | 6f 6e 2c 0a 25 20 20 20 |ileversi|on,.%   |
|000011d0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 6c 61 |        |      la|
|000011e0| 73 74 20 72 65 76 69 73 | 65 64 20 5c 66 69 6c 65 |st revis|ed \file|
|000011f0| 64 61 74 65 2c 0a 25 20 | 20 20 20 20 20 20 20 20 |date,.% |        |
|00001200| 20 20 20 20 20 20 20 20 | 64 6f 63 75 6d 65 6e 74 |        |document|
|00001210| 61 74 69 6f 6e 20 64 61 | 74 65 64 20 5c 64 6f 63 |ation da|ted \doc|
|00001220| 64 61 74 65 2e 7d 7d 0a | 25 0a 25 20 5c 63 68 61 |date.}}.|%.% \cha|
|00001230| 6e 67 65 73 7b 32 2e 31 | 62 7d 7b 31 39 39 33 2f |nges{2.1|b}{1993/|
|00001240| 30 32 2f 32 33 7d 7b 6d | 6f 64 69 66 69 65 64 20 |02/23}{m|odified |
|00001250| 6d 61 69 6c 61 64 64 72 | 65 73 73 20 6f 66 20 4a |mailaddr|ess of J|
|00001260| 6f 68 61 6e 6e 65 73 7d | 0a 25 20 5c 61 75 74 68 |ohannes}|.% \auth|
|00001270| 6f 72 7b 25 0a 25 20 20 | 20 46 72 61 6e 6b 20 4d |or{%.%  | Frank M|
|00001280| 69 74 74 65 6c 62 61 63 | 68 20 5c 5c 0a 25 20 20 |ittelbac|h \\.%  |
|00001290| 20 5c 6e 65 74 61 64 64 | 72 65 73 73 7b 4d 69 74 | \netadd|ress{Mit|
|000012a0| 74 65 6c 62 61 63 68 40 | 6d 7a 64 6d 7a 61 2e 7a |telbach@|mzdmza.z|
|000012b0| 64 76 2e 75 6e 69 2d 6d | 61 69 6e 7a 2e 64 65 7d |dv.uni-m|ainz.de}|
|000012c0| 0a 25 20 20 5c 61 6e 64 | 0a 25 20 20 20 44 65 6e |.%  \and|.%   Den|
|000012d0| 79 73 20 44 75 63 68 69 | 65 72 20 5c 5c 0a 25 20 |ys Duchi|er \\.% |
|000012e0| 20 20 5c 6e 65 74 61 64 | 64 72 65 73 73 7b 64 75 |  \netad|dress{du|
|000012f0| 63 68 69 65 72 2d 64 65 | 6e 79 73 40 63 73 2e 79 |chier-de|nys@cs.y|
|00001300| 61 6c 65 2e 65 64 75 7d | 0a 25 20 20 5c 61 6e 64 |ale.edu}|.%  \and|
|00001310| 0a 25 20 20 20 4a 6f 68 | 61 6e 6e 65 73 20 42 72 |.%   Joh|annes Br|
|00001320| 61 61 6d 73 20 5c 5c 0a | 25 20 20 20 50 54 54 20 |aams \\.|%   PTT |
|00001330| 52 65 73 65 61 72 63 68 | 20 4e 65 68 65 72 20 4c |Research| Neher L|
|00001340| 61 62 6f 72 61 74 6f 72 | 69 65 73 5c 5c 0a 25 20 |aborator|ies\\.% |
|00001350| 20 20 20 20 20 20 20 20 | 20 50 2e 4f 2e 20 42 6f |        | P.O. Bo|
|00001360| 78 20 34 32 31 5c 5c 0a | 25 20 20 20 20 20 20 20 |x 421\\.|%       |
|00001370| 20 20 20 32 32 36 30 20 | 41 4b 20 4c 65 69 64 73 |   2260 |AK Leids|
|00001380| 63 68 65 6e 64 61 6d 5c | 5c 0a 25 20 20 20 5c 6e |chendam\|\.%   \n|
|00001390| 65 74 61 64 64 72 65 73 | 73 7b 4a 2e 4c 2e 42 72 |etaddres|s{J.L.Br|
|000013a0| 61 61 6d 73 40 72 65 73 | 65 61 72 63 68 2e 70 74 |aams@res|earch.pt|
|000013b0| 74 2e 6e 6c 7d 7d 0a 25 | 0a 25 20 5c 64 61 74 65 |t.nl}}.%|.% \date|
|000013c0| 7b 50 72 69 6e 74 65 64 | 20 5c 74 6f 64 61 79 7d |{Printed| \today}|
|000013d0| 0a 25 0a 25 20 5c 6d 61 | 6b 65 74 69 74 6c 65 0a |.%.% \ma|ketitle.|
|000013e0| 25 0a 25 20 5c 62 65 67 | 69 6e 7b 61 62 73 74 72 |%.% \beg|in{abstr|
|000013f0| 61 63 74 7d 0a 25 20 20 | 20 20 54 68 69 73 20 64 |act}.%  |  This d|
|00001400| 6f 63 75 6d 65 6e 74 20 | 64 65 73 63 72 69 62 65 |ocument |describe|
|00001410| 73 20 74 68 65 20 69 6d | 70 6c 65 6d 65 6e 74 61 |s the im|plementa|
|00001420| 74 69 6f 6e 20 6f 66 20 | 74 68 65 20 5c 64 73 7b |tion of |the \ds{|
|00001430| 7d 20 70 72 6f 67 72 61 | 6d 2e 0a 25 20 20 20 20 |} progra|m..%    |
|00001440| 54 68 65 20 6f 72 69 67 | 69 6e 61 6c 20 76 65 72 |The orig|inal ver|
|00001450| 73 69 6f 6e 20 6f 66 20 | 74 68 69 73 20 70 72 6f |sion of |this pro|
|00001460| 67 72 61 6d 20 77 61 73 | 20 64 65 76 65 6c 6f 70 |gram was| develop|
|00001470| 65 64 20 62 79 20 46 72 | 61 6e 6b 0a 25 20 20 20 |ed by Fr|ank.%   |
|00001480| 20 4d 69 74 74 65 6c 62 | 61 63 68 20 74 6f 20 61 | Mittelb|ach to a|
|00001490| 63 63 6f 6d 70 61 6e 79 | 20 68 69 73 20 5c 74 65 |ccompany| his \te|
|000014a0| 78 74 74 74 7b 64 6f 63 | 2e 73 74 79 7d 20 77 68 |xttt{doc|.sty} wh|
|000014b0| 69 63 68 20 65 6e 61 62 | 6c 65 73 20 6c 69 74 65 |ich enab|les lite|
|000014c0| 72 61 74 65 0a 25 20 20 | 20 20 70 72 6f 67 72 61 |rate.%  |  progra|
|000014d0| 6d 6d 69 6e 67 20 69 6e | 20 5c 4c 61 54 65 58 5c |mming in| \LaTeX\|
|000014e0| 40 2e 20 44 65 6e 79 73 | 20 44 75 63 68 69 65 72 |@. Denys| Duchier|
|000014f0| 20 72 65 77 72 6f 74 65 | 20 69 74 20 74 6f 20 72 | rewrote| it to r|
|00001500| 75 6e 20 65 69 74 68 65 | 72 0a 25 20 20 20 20 77 |un eithe|r.%    w|
|00001510| 69 74 68 20 5c 54 65 58 | 5c 20 6f 72 20 6f 66 20 |ith \TeX|\ or of |
|00001520| 5c 4c 61 54 65 58 2c 20 | 61 6e 64 20 74 6f 20 61 |\LaTeX, |and to a|
|00001530| 6c 6c 6f 77 20 66 75 6c | 6c 20 62 6f 6f 6c 65 61 |llow ful|l boolea|
|00001540| 6e 20 65 78 70 72 65 73 | 73 69 6f 6e 73 20 69 6e |n expres|sions in|
|00001550| 0a 25 20 20 20 20 63 6f | 6e 64 69 74 69 6f 6e 61 |.%    co|nditiona|
|00001560| 6c 20 67 75 61 72 64 73 | 20 69 6e 73 74 65 61 64 |l guards| instead|
|00001570| 20 6f 66 20 6a 75 73 74 | 20 63 6f 6d 6d 61 2d 73 | of just| comma-s|
|00001580| 65 70 61 72 61 74 65 64 | 20 6c 69 73 74 73 2e 0a |eparated| lists..|
|00001590| 25 20 20 20 20 4a 6f 68 | 61 6e 6e 65 73 20 42 72 |%    Joh|annes Br|
|000015a0| 61 61 6d 73 20 72 65 2d | 75 6e 69 74 65 64 20 74 |aams re-|united t|
|000015b0| 68 65 20 74 77 6f 20 69 | 6d 70 6c 65 6d 65 6e 74 |he two i|mplement|
|000015c0| 61 74 69 6f 6e 73 2c 20 | 64 6f 63 75 6d 65 6e 74 |ations, |document|
|000015d0| 65 64 20 61 6e 64 0a 25 | 20 20 20 20 64 65 62 75 |ed and.%|    debu|
|000015e0| 67 67 65 64 20 74 68 65 | 20 63 6f 64 65 2e 0a 25 |gged the| code..%|
|000015f0| 20 5c 65 6e 64 7b 61 62 | 73 74 72 61 63 74 7d 0a | \end{ab|stract}.|
|00001600| 25 0a 25 20 5c 73 65 63 | 74 69 6f 6e 7b 49 6e 74 |%.% \sec|tion{Int|
|00001610| 72 6f 64 75 63 74 69 6f | 6e 7d 0a 25 0a 25 20 5c |roductio|n}.%.% \|
|00001620| 73 75 62 73 65 63 74 69 | 6f 6e 7b 57 68 79 20 74 |subsecti|on{Why t|
|00001630| 68 65 20 5c 64 73 7b 7d | 20 70 72 6f 67 72 61 6d |he \ds{}| program|
|00001640| 3f 7d 20 57 68 65 6e 20 | 46 72 61 6e 6b 20 4d 69 |?} When |Frank Mi|
|00001650| 74 74 65 6c 62 61 63 68 | 20 63 72 65 61 74 65 64 |ttelbach| created|
|00001660| 0a 25 20 20 20 20 74 68 | 65 20 5c 74 65 78 74 74 |.%    th|e \textt|
|00001670| 74 7b 64 6f 63 7d 20 70 | 61 63 6b 61 67 65 2c 20 |t{doc} p|ackage, |
|00001680| 68 65 20 69 6e 76 65 6e | 74 65 64 20 61 20 77 61 |he inven|ted a wa|
|00001690| 79 20 74 6f 20 63 6f 6d | 62 69 6e 65 20 5c 54 65 |y to com|bine \Te|
|000016a0| 58 5c 20 63 6f 64 65 0a | 25 20 20 20 20 61 6e 64 |X\ code.|%    and|
|000016b0| 20 69 74 73 20 64 6f 63 | 75 6d 65 6e 74 61 74 69 | its doc|umentati|
|000016c0| 6f 6e 2e 20 46 72 6f 6d | 20 74 68 65 6e 20 6f 6e |on. From| then on|
|000016d0| 20 69 74 20 77 61 73 20 | 6d 6f 72 65 20 6f 72 20 | it was |more or |
|000016e0| 6c 65 73 73 20 70 6f 73 | 73 69 62 6c 65 0a 25 20 |less pos|sible.% |
|000016f0| 20 20 20 74 6f 20 64 6f | 20 6c 69 74 65 72 61 74 |   to do| literat|
|00001700| 65 20 70 72 6f 67 72 61 | 6d 6d 69 6e 67 20 69 6e |e progra|mming in|
|00001710| 20 5c 54 65 58 2e 0a 25 | 0a 25 20 20 20 20 54 68 | \TeX..%|.%    Th|
|00001720| 69 73 20 77 61 79 20 6f | 66 20 77 72 69 74 69 6e |is way o|f writin|
|00001730| 67 20 5c 54 65 58 5c 20 | 70 72 6f 67 72 61 6d 73 |g \TeX\ |programs|
|00001740| 20 6f 62 76 69 6f 75 73 | 6c 79 20 68 61 73 20 67 | obvious|ly has g|
|00001750| 72 65 61 74 0a 25 20 20 | 20 20 61 64 76 61 6e 74 |reat.%  |  advant|
|00001760| 61 67 65 73 2c 20 65 73 | 70 65 63 69 61 6c 6c 79 |ages, es|pecially|
|00001770| 20 77 68 65 6e 20 74 68 | 65 20 70 72 6f 67 72 61 | when th|e progra|
|00001780| 6d 20 62 65 63 6f 6d 65 | 73 20 6c 61 72 67 65 72 |m become|s larger|
|00001790| 20 74 68 61 6e 20 61 0a | 25 20 20 20 20 63 6f 75 | than a.|%    cou|
|000017a0| 70 6c 65 20 6f 66 20 6d | 61 63 72 6f 73 2e 20 20 |ple of m|acros.  |
|000017b0| 54 68 65 72 65 20 69 73 | 20 6f 6e 65 20 64 72 61 |There is| one dra|
|000017c0| 77 62 61 63 6b 20 68 6f | 77 65 76 65 72 2c 20 61 |wback ho|wever, a|
|000017d0| 6e 64 20 74 68 61 74 20 | 69 73 0a 25 20 20 20 20 |nd that |is.%    |
|000017e0| 74 68 61 74 20 73 75 63 | 68 20 70 72 6f 67 72 61 |that suc|h progra|
|000017f0| 6d 73 20 6d 61 79 20 74 | 61 6b 65 20 6c 6f 6e 67 |ms may t|ake long|
|00001800| 65 72 20 74 68 61 6e 20 | 65 78 70 65 63 74 65 64 |er than |expected|
|00001810| 20 74 6f 20 72 75 6e 20 | 62 65 63 61 75 73 65 0a | to run |because.|
|00001820| 25 20 20 20 20 5c 54 65 | 58 5c 20 69 73 20 61 6e |%    \Te|X\ is an|
|00001830| 20 69 6e 74 65 72 70 72 | 65 74 65 72 20 61 6e 64 | interpr|eter and|
|00001840| 20 68 61 73 20 74 6f 20 | 64 65 63 69 64 65 20 66 | has to |decide f|
|00001850| 6f 72 20 65 61 63 68 20 | 6c 69 6e 65 20 6f 66 20 |or each |line of |
|00001860| 74 68 65 0a 25 20 20 20 | 20 70 72 6f 67 72 61 6d |the.%   | program|
|00001870| 20 66 69 6c 65 20 77 68 | 61 74 20 69 74 20 68 61 | file wh|at it ha|
|00001880| 73 20 74 6f 20 64 6f 20 | 77 69 74 68 20 69 74 2e |s to do |with it.|
|00001890| 20 54 68 65 72 65 66 6f | 72 65 2c 20 5c 54 65 58 | Therefo|re, \TeX|
|000018a0| 5c 20 70 72 6f 67 72 61 | 6d 73 0a 25 20 20 20 20 |\ progra|ms.%    |
|000018b0| 6d 61 79 20 62 65 20 73 | 70 65 65 64 65 64 20 75 |may be s|peeded u|
|000018c0| 70 20 62 79 20 72 65 6d | 6f 76 69 6e 67 20 61 6c |p by rem|oving al|
|000018d0| 6c 20 63 6f 6d 6d 65 6e | 74 73 20 66 72 6f 6d 20 |l commen|ts from |
|000018e0| 74 68 65 6d 2e 0a 25 0a | 25 20 20 20 20 42 79 20 |them..%.|%    By |
|000018f0| 72 65 6d 6f 76 69 6e 67 | 20 74 68 65 20 63 6f 6d |removing| the com|
|00001900| 6d 65 6e 74 73 20 66 72 | 6f 6d 20 61 20 5c 54 65 |ments fr|om a \Te|
|00001910| 58 5c 20 70 72 6f 67 72 | 61 6d 20 61 20 6e 65 77 |X\ progr|am a new|
|00001920| 20 70 72 6f 62 6c 65 6d | 20 69 73 0a 25 20 20 20 | problem| is.%   |
|00001930| 20 69 6e 74 72 6f 64 75 | 63 65 64 2e 20 57 65 20 | introdu|ced. We |
|00001940| 6e 6f 77 20 68 61 76 65 | 20 74 77 6f 20 76 65 72 |now have| two ver|
|00001950| 73 69 6f 6e 73 20 6f 66 | 20 74 68 65 20 70 72 6f |sions of| the pro|
|00001960| 67 72 61 6d 20 61 6e 64 | 20 62 6f 74 68 20 6f 66 |gram and| both of|
|00001970| 0a 25 20 20 20 20 74 68 | 65 6d 20 7b 5c 65 6d 20 |.%    th|em {\em |
|00001980| 68 61 76 65 5c 2f 7d 20 | 74 6f 20 62 65 20 6d 61 |have\/} |to be ma|
|00001990| 69 6e 74 61 69 6e 65 64 | 2e 20 54 68 65 72 65 66 |intained|. Theref|
|000019a0| 6f 72 65 20 69 74 20 77 | 6f 75 6c 64 20 62 65 20 |ore it w|ould be |
|000019b0| 6e 69 63 65 20 74 6f 0a | 25 20 20 20 20 68 61 76 |nice to.|%    hav|
|000019c0| 65 20 61 20 70 6f 73 73 | 69 62 69 6c 69 74 79 20 |e a poss|ibility |
|000019d0| 74 6f 20 72 65 6d 6f 76 | 65 20 74 68 65 20 63 6f |to remov|e the co|
|000019e0| 6d 6d 65 6e 74 73 20 61 | 75 74 6f 6d 61 74 69 63 |mments a|utomatic|
|000019f0| 61 6c 6c 79 2c 20 69 6e | 73 74 65 61 64 0a 25 20 |ally, in|stead.% |
|00001a00| 20 20 20 6f 66 20 64 6f | 69 6e 67 20 69 74 20 62 |   of do|ing it b|
|00001a10| 79 20 68 61 6e 64 2e 20 | 53 6f 20 77 65 20 6e 65 |y hand. |So we ne|
|00001a20| 65 64 20 61 20 70 72 6f | 67 72 61 6d 20 74 6f 20 |ed a pro|gram to |
|00001a30| 72 65 6d 6f 76 65 20 63 | 6f 6d 6d 65 6e 74 73 20 |remove c|omments |
|00001a40| 66 72 6f 6d 0a 25 20 20 | 20 20 5c 54 65 58 5c 20 |from.%  |  \TeX\ |
|00001a50| 70 72 6f 67 72 61 6d 73 | 2e 20 54 68 69 73 20 63 |programs|. This c|
|00001a60| 6f 75 6c 64 20 62 65 20 | 70 72 6f 67 72 61 6d 6d |ould be |programm|
|00001a70| 65 64 20 69 6e 20 61 6e | 79 20 68 69 67 68 20 6c |ed in an|y high l|
|00001a80| 65 76 65 6c 0a 25 20 20 | 20 20 6c 61 6e 67 75 61 |evel.%  |  langua|
|00001a90| 67 65 2c 20 62 75 74 20 | 6d 61 79 62 65 20 6e 6f |ge, but |maybe no|
|00001aa0| 74 20 65 76 65 72 79 62 | 6f 64 79 20 68 61 73 20 |t everyb|ody has |
|00001ab0| 74 68 65 20 72 69 67 68 | 74 20 63 6f 6d 70 69 6c |the righ|t compil|
|00001ac0| 65 72 20 74 6f 0a 25 20 | 20 20 20 63 6f 6d 70 69 |er to.% |   compi|
|00001ad0| 6c 65 20 74 68 65 20 70 | 72 6f 67 72 61 6d 2e 20 |le the p|rogram. |
|00001ae0| 20 45 76 65 72 79 62 6f | 64 79 20 77 68 6f 20 77 | Everybo|dy who w|
|00001af0| 61 6e 74 73 20 74 6f 20 | 72 65 6d 6f 76 65 20 63 |ants to |remove c|
|00001b00| 6f 6d 6d 65 6e 74 73 20 | 66 72 6f 6d 0a 25 20 20 |omments |from.%  |
|00001b10| 20 20 5c 54 65 58 5c 20 | 70 72 6f 67 72 61 6d 73 |  \TeX\ |programs|
|00001b20| 20 68 61 73 20 5c 54 65 | 58 5c 40 2e 20 20 54 68 | has \Te|X\@.  Th|
|00001b30| 65 72 65 66 6f 72 65 20 | 74 68 65 20 5c 64 73 7b |erefore |the \ds{|
|00001b40| 7d 20 70 72 6f 67 72 61 | 6d 20 69 73 0a 25 20 20 |} progra|m is.%  |
|00001b50| 20 20 69 6d 70 6c 65 6d | 65 6e 74 65 64 20 65 6e |  implem|ented en|
|00001b60| 74 69 72 65 6c 79 20 69 | 6e 20 5c 54 65 58 2e 0a |tirely i|n \TeX..|
|00001b70| 25 0a 25 20 5c 73 75 62 | 73 65 63 74 69 6f 6e 7b |%.% \sub|section{|
|00001b80| 46 75 6e 63 74 69 6f 6e | 73 20 6f 66 20 74 68 65 |Function|s of the|
|00001b90| 20 5c 64 73 7b 7d 20 70 | 72 6f 67 72 61 6d 7d 20 | \ds{} p|rogram} |
|00001ba0| 0a 25 0a 25 20 20 20 20 | 48 61 76 69 6e 67 20 63 |.%.%    |Having c|
|00001bb0| 72 65 61 74 65 64 20 74 | 68 65 20 5c 64 73 7b 7d |reated t|he \ds{}|
|00001bc0| 20 70 72 6f 67 72 61 6d | 20 74 6f 20 72 65 6d 6f | program| to remo|
|00001bd0| 76 65 20 63 6f 6d 6d 65 | 6e 74 20 6c 69 6e 65 73 |ve comme|nt lines|
|00001be0| 20 66 72 6f 6d 0a 25 20 | 20 20 20 5c 54 65 58 5c | from.% |   \TeX\|
|00001bf0| 20 70 72 6f 67 72 61 6d | 73 5c 66 6f 6f 74 6e 6f | program|s\footno|
|00001c00| 74 65 7b 4e 6f 74 65 20 | 74 68 61 74 20 6f 6e 6c |te{Note |that onl|
|00001c10| 79 20 63 6f 6d 6d 65 6e | 74 20 6c 69 6e 65 73 2c |y commen|t lines,|
|00001c20| 20 74 68 61 74 20 69 73 | 0a 25 20 20 20 20 6c 69 | that is|.%    li|
|00001c30| 6e 65 73 20 74 68 61 74 | 20 73 74 61 72 74 20 77 |nes that| start w|
|00001c40| 69 74 68 20 61 20 73 69 | 6e 67 6c 65 20 5c 74 65 |ith a si|ngle \te|
|00001c50| 78 74 74 74 7b 5c 25 7d | 20 63 68 61 72 61 63 74 |xttt{\%}| charact|
|00001c60| 65 72 2c 20 61 72 65 20 | 72 65 6d 6f 76 65 64 3b |er, are |removed;|
|00001c70| 0a 25 20 20 20 20 61 6c | 6c 20 6f 74 68 65 72 20 |.%    al|l other |
|00001c80| 63 6f 6d 6d 65 6e 74 73 | 20 73 74 20 69 6e 20 74 |comments| st in t|
|00001c90| 68 65 20 63 6f 64 65 2e | 7d 20 69 74 20 62 65 63 |he code.|} it bec|
|00001ca0| 61 6d 65 20 66 65 61 73 | 69 62 6c 65 20 74 6f 20 |ame feas|ible to |
|00001cb0| 64 6f 20 6d 6f 72 65 0a | 25 20 20 20 20 74 68 61 |do more.|%    tha|
|00001cc0| 6e 20 6a 75 73 74 20 73 | 74 72 69 70 20 63 6f 6d |n just s|trip com|
|00001cd0| 6d 65 6e 74 73 2e 5c 5c | 20 57 6f 75 6c 64 6e 27 |ments.\\| Wouldn'|
|00001ce0| 74 20 69 74 20 62 65 20 | 6e 69 63 65 20 74 6f 20 |t it be |nice to |
|00001cf0| 68 61 76 65 20 61 20 77 | 61 79 20 74 6f 0a 25 20 |have a w|ay to.% |
|00001d00| 20 20 20 69 6e 63 6c 75 | 64 65 20 70 61 72 74 73 |   inclu|de parts|
|00001d10| 20 6f 66 20 74 68 65 20 | 63 6f 64 65 20 6f 6e 6c | of the |code onl|
|00001d20| 79 20 77 68 65 6e 20 73 | 6f 6d 65 20 63 6f 6e 64 |y when s|ome cond|
|00001d30| 69 74 69 6f 6e 20 69 73 | 20 73 65 74 20 74 72 75 |ition is| set tru|
|00001d40| 65 3f 0a 25 20 20 20 20 | 57 6f 75 6c 64 6e 27 74 |e?.%    |Wouldn't|
|00001d50| 20 69 74 20 62 65 20 61 | 73 20 6e 69 63 65 20 74 | it be a|s nice t|
|00001d60| 6f 20 68 61 76 65 20 74 | 68 65 20 70 6f 73 73 69 |o have t|he possi|
|00001d70| 62 69 6c 69 74 79 20 74 | 6f 20 73 70 6c 69 74 20 |bility t|o split |
|00001d80| 74 68 65 0a 25 20 20 20 | 20 73 6f 75 72 63 65 20 |the.%   | source |
|00001d90| 6f 66 20 61 20 5c 54 65 | 58 5c 20 70 72 6f 67 72 |of a \Te|X\ progr|
|00001da0| 61 6d 20 69 6e 74 6f 20 | 73 65 76 65 72 61 6c 20 |am into |several |
|00001db0| 73 6d 61 6c 6c 65 72 20 | 66 69 6c 65 73 20 61 6e |smaller |files an|
|00001dc0| 64 20 63 6f 6d 62 69 6e | 65 0a 25 20 20 20 20 74 |d combin|e.%    t|
|00001dd0| 68 65 6d 20 6c 61 74 65 | 72 20 69 6e 74 6f 20 6f |hem late|r into o|
|00001de0| 6e 65 20 60 65 78 65 63 | 75 74 61 62 6c 65 27 3f |ne `exec|utable'?|
|00001df0| 5c 5c 20 42 6f 74 68 20 | 74 68 65 73 65 20 77 69 |\\ Both |these wi|
|00001e00| 73 68 65 73 20 68 61 76 | 65 20 62 65 65 6e 0a 25 |shes hav|e been.%|
|00001e10| 20 20 20 20 69 6d 70 6c | 65 6d 65 6e 74 65 64 20 |    impl|emented |
|00001e20| 69 6e 20 74 68 65 20 5c | 64 73 7b 7d 20 70 72 6f |in the \|ds{} pro|
|00001e30| 67 72 61 6d 2e 0a 25 0a | 25 20 20 5c 73 75 62 73 |gram..%.|%  \subs|
|00001e40| 65 63 74 69 6f 6e 7b 48 | 6f 77 20 74 6f 20 75 73 |ection{H|ow to us|
|00001e50| 65 20 74 68 65 20 5c 64 | 73 7b 7d 20 70 72 6f 67 |e the \d|s{} prog|
|00001e60| 72 61 6d 7d 0a 25 20 20 | 20 20 41 20 6e 75 6d 62 |ram}.%  |  A numb|
|00001e70| 65 72 20 6f 66 20 77 61 | 79 73 20 65 78 69 73 74 |er of wa|ys exist|
|00001e80| 20 74 6f 20 75 73 65 20 | 74 68 65 20 5c 64 73 7b | to use |the \ds{|
|00001e90| 7d 20 70 72 6f 67 72 61 | 6d 3a 0a 25 20 20 20 20 |} progra|m:.%    |
|00001ea0| 5c 62 65 67 69 6e 7b 65 | 6e 75 6d 65 72 61 74 65 |\begin{e|numerate|
|00001eb0| 7d 0a 25 20 20 20 20 5c | 69 74 65 6d 20 54 68 65 |}.%    \|item The|
|00001ec0| 20 65 61 73 69 65 73 74 | 20 77 61 79 20 69 73 20 | easiest| way is |
|00001ed0| 74 6f 20 69 6e 73 74 72 | 75 63 74 20 5c 54 65 58 |to instr|uct \TeX|
|00001ee0| 5c 20 74 6f 20 72 65 61 | 64 20 74 68 65 20 66 69 |\ to rea|d the fi|
|00001ef0| 6c 65 0a 25 20 20 20 20 | 20 20 20 20 5c 74 65 78 |le.%    |    \tex|
|00001f00| 74 74 74 7b 64 6f 63 73 | 74 72 69 70 2e 74 65 78 |ttt{docs|trip.tex|
|00001f10| 7d 20 61 6e 64 20 74 6f | 20 73 65 65 20 77 68 61 |} and to| see wha|
|00001f20| 74 20 68 61 70 70 65 6e | 73 2e 20 5c 54 65 58 5c |t happen|s. \TeX\|
|00001f30| 20 77 69 6c 6c 20 61 73 | 6b 0a 25 20 20 20 20 20 | will as|k.%     |
|00001f40| 20 20 20 79 6f 75 20 61 | 20 66 65 77 20 71 75 65 |   you a| few que|
|00001f50| 73 74 69 6f 6e 73 20 61 | 62 6f 75 74 20 74 68 65 |stions a|bout the|
|00001f60| 20 66 69 6c 65 20 79 6f | 75 20 77 6f 75 6c 64 20 | file yo|u would |
|00001f70| 6c 69 6b 65 20 74 6f 20 | 62 65 0a 25 20 20 20 20 |like to |be.%    |
|00001f80| 20 20 20 20 70 72 6f 63 | 65 73 73 65 64 2e 20 57 |    proc|essed. W|
|00001f90| 68 65 6e 20 79 6f 75 20 | 68 61 76 65 20 61 6e 73 |hen you |have ans|
|00001fa0| 77 65 72 65 64 20 74 68 | 65 73 65 20 71 75 65 73 |wered th|ese ques|
|00001fb0| 74 69 6f 6e 73 20 69 74 | 20 64 6f 65 73 0a 25 20 |tions it| does.% |
|00001fc0| 20 20 20 20 20 20 20 69 | 74 73 20 6a 6f 62 20 61 |       i|ts job a|
|00001fd0| 6e 64 20 73 74 72 69 70 | 73 20 74 68 65 20 63 6f |nd strip|s the co|
|00001fe0| 6d 6d 65 6e 74 73 20 66 | 72 6f 6d 20 79 6f 75 72 |mments f|rom your|
|00001ff0| 20 5c 54 65 58 5c 20 63 | 6f 64 65 2e 0a 25 20 20 | \TeX\ c|ode..%  |
|00002000| 20 20 5c 69 74 65 6d 20 | 57 68 65 6e 20 79 6f 75 |  \item |When you|
|00002010| 20 77 6f 75 6c 64 20 6c | 69 6b 65 20 74 6f 20 62 | would l|ike to b|
|00002020| 65 20 61 62 6c 65 20 74 | 6f 20 70 72 6f 63 65 73 |e able t|o proces|
|00002030| 73 20 6d 6f 72 65 20 74 | 68 61 6e 20 6f 6e 65 0a |s more t|han one.|
|00002040| 25 20 20 20 20 20 20 20 | 20 66 69 6c 65 20 77 69 |%       | file wi|
|00002050| 74 68 20 6f 6e 65 20 63 | 6f 6d 6d 61 6e 64 2c 20 |th one c|ommand, |
|00002060| 6f 72 20 79 6f 75 20 77 | 6f 75 6c 64 20 6c 69 6b |or you w|ould lik|
|00002070| 65 20 74 6f 20 61 64 64 | 20 61 20 63 6f 75 70 6c |e to add| a coupl|
|00002080| 65 20 6f 66 0a 25 20 20 | 20 20 20 20 20 20 6c 69 |e of.%  |      li|
|00002090| 6e 65 73 20 74 6f 20 74 | 68 65 20 62 65 67 69 6e |nes to t|he begin|
|000020a0| 6e 69 6e 67 20 28 6f 72 | 20 65 6e 64 29 20 6f 66 |ning (or| end) of|
|000020b0| 20 74 68 65 20 73 74 72 | 69 70 70 65 64 20 66 69 | the str|ipped fi|
|000020c0| 6c 65 20 79 6f 75 20 63 | 61 6e 0a 25 20 20 20 20 |le you c|an.%    |
|000020d0| 20 20 20 20 77 72 69 74 | 65 20 61 20 60 62 61 74 |    writ|e a `bat|
|000020e0| 63 68 20 66 69 6c 65 27 | 20 66 6f 72 20 5c 64 73 |ch file'| for \ds|
|000020f0| 7b 7d 2e 20 54 68 65 20 | 64 65 66 61 75 6c 74 20 |{}. The |default |
|00002100| 6e 61 6d 65 20 66 6f 72 | 20 73 75 63 68 20 61 0a |name for| such a.|
|00002110| 25 20 20 20 20 20 20 20 | 20 66 69 6c 65 20 69 73 |%       | file is|
|00002120| 20 5c 74 65 78 74 74 74 | 7b 64 6f 63 73 74 72 69 | \texttt|{docstri|
|00002130| 70 2e 63 6d 64 7d 2e 20 | 57 68 65 6e 20 61 20 66 |p.cmd}. |When a f|
|00002140| 69 6c 65 20 62 79 20 74 | 68 61 74 20 6e 61 6d 65 |ile by t|hat name|
|00002150| 0a 25 20 20 20 20 20 20 | 20 20 65 78 69 73 74 73 |.%      |  exists|
|00002160| 20 69 6e 20 79 6f 75 72 | 20 63 75 72 72 65 6e 74 | in your| current|
|00002170| 20 64 69 72 65 63 74 6f | 72 79 20 77 68 65 6e 20 | directo|ry when |
|00002180| 79 6f 75 20 69 6e 73 74 | 72 75 63 74 20 5c 54 65 |you inst|ruct \Te|
|00002190| 58 5c 20 74 6f 0a 25 20 | 20 20 20 20 20 20 20 72 |X\ to.% |       r|
|000021a0| 65 61 64 20 5c 74 65 78 | 74 74 74 7b 64 6f 63 73 |ead \tex|ttt{docs|
|000021b0| 74 72 69 70 2e 74 65 78 | 7d 20 69 74 20 77 69 6c |trip.tex|} it wil|
|000021c0| 6c 20 76 65 72 69 66 79 | 20 28 62 79 20 61 73 6b |l verify| (by ask|
|000021d0| 69 6e 67 20 79 6f 75 29 | 0a 25 20 20 20 20 20 20 |ing you)|.%      |
|000021e0| 20 20 74 68 61 74 20 79 | 6f 75 20 77 61 6e 74 20 |  that y|ou want |
|000021f0| 74 6f 20 75 73 65 20 7b | 5c 65 6d 20 74 68 61 74 |to use {|\em that|
|00002200| 5c 2f 7d 20 66 69 6c 65 | 20 61 6e 64 20 69 66 20 |\/} file| and if |
|00002210| 73 6f 2c 20 77 69 6c 6c | 0a 25 20 20 20 20 20 20 |so, will|.%      |
|00002220| 20 20 70 72 6f 63 65 73 | 73 20 74 68 65 20 63 6f |  proces|s the co|
|00002230| 6d 6d 61 6e 64 73 20 69 | 6e 20 69 74 2e 0a 25 0a |mmands i|n it..%.|
|00002240| 25 20 20 20 20 20 20 20 | 20 59 6f 75 20 64 6f 20 |%       | You do |
|00002250| 6e 6f 74 20 6e 65 65 64 | 20 74 6f 20 75 73 65 20 |not need| to use |
|00002260| 74 68 65 20 64 65 66 61 | 75 6c 74 20 6e 61 6d 65 |the defa|ult name|
|00002270| 2c 20 68 6f 77 65 76 65 | 72 2e 20 59 6f 75 20 63 |, howeve|r. You c|
|00002280| 61 6e 0a 25 20 20 20 20 | 20 20 20 20 67 69 76 65 |an.%    |    give|
|00002290| 20 61 20 62 61 74 63 68 | 20 66 69 6c 65 20 61 6e | a batch| file an|
|000022a0| 79 20 6e 61 6d 65 20 79 | 6f 75 20 6c 69 6b 65 20 |y name y|ou like |
|000022b0| 73 75 63 68 20 61 73 2c | 20 73 61 79 2c 20 0a 25 |such as,| say, .%|
|000022c0| 20 20 20 20 20 20 20 20 | 5c 74 65 78 74 74 74 7b |        |\texttt{|
|000022d0| 66 6f 6f 2e 62 61 72 7d | 20 61 6e 64 20 74 68 65 |foo.bar}| and the|
|000022e0| 6e 20 72 75 6e 20 5c 54 | 65 58 5c 20 62 79 20 75 |n run \T|eX\ by u|
|000022f0| 73 69 6e 67 20 61 20 63 | 6f 6d 6d 61 6e 64 20 73 |sing a c|ommand s|
|00002300| 75 63 68 20 61 73 3a 0a | 25 20 20 20 20 5c 62 65 |uch as:.|%    \be|
|00002310| 67 69 6e 7b 76 65 72 62 | 61 74 69 6d 7d 0a 25 20 |gin{verb|atim}.% |
|00002320| 20 20 20 54 65 58 20 5c | 64 65 66 5c 62 61 74 63 |   TeX \|def\batc|
|00002330| 68 66 69 6c 65 7b 66 6f | 6f 2e 62 61 72 7d 5c 69 |hfile{fo|o.bar}\i|
|00002340| 6e 70 75 74 20 64 6f 63 | 73 74 72 69 70 0a 25 20 |nput doc|strip.% |
|00002350| 20 20 20 5c 65 6e 64 7b | 76 65 72 62 61 74 69 6d |   \end{|verbatim|
|00002360| 7d 0a 25 0a 25 20 5c 69 | 74 65 6d 20 59 6f 75 20 |}.%.% \i|tem You |
|00002370| 6d 61 79 20 75 73 65 20 | 79 65 74 20 61 6e 6f 74 |may use |yet anot|
|00002380| 68 65 72 20 77 61 79 20 | 74 68 61 74 20 69 73 20 |her way |that is |
|00002390| 6f 6e 6c 79 20 73 6c 69 | 67 68 74 6c 79 20 64 69 |only sli|ghtly di|
|000023a0| 66 66 65 72 65 6e 74 0a | 25 20 20 20 20 20 20 20 |fferent.|%       |
|000023b0| 20 66 72 6f 6d 20 74 68 | 65 20 70 72 65 76 69 6f | from th|e previo|
|000023c0| 75 73 20 6d 65 74 68 6f | 64 2e 20 59 6f 75 20 63 |us metho|d. You c|
|000023d0| 61 6e 20 77 72 69 74 65 | 20 61 20 62 61 74 63 68 |an write| a batch|
|000023e0| 20 66 69 6c 65 20 69 6e | 20 73 75 63 68 0a 25 20 | file in| such.% |
|000023f0| 20 20 20 20 20 20 20 61 | 20 77 61 79 20 74 68 61 |       a| way tha|
|00002400| 74 20 69 74 20 63 61 6e | 20 62 65 20 64 69 72 65 |t it can| be dire|
|00002410| 63 74 6c 79 20 70 72 6f | 63 65 73 73 65 64 20 62 |ctly pro|cessed b|
|00002420| 79 20 5c 54 65 58 7b 7d | 2e 20 54 68 69 73 0a 25 |y \TeX{}|. This.%|
|00002430| 20 20 20 20 20 20 20 20 | 61 6c 6c 6f 77 73 20 79 |        |allows y|
|00002440| 6f 75 20 74 6f 20 73 65 | 74 20 75 70 20 61 20 64 |ou to se|t up a d|
|00002450| 69 73 74 72 69 62 75 74 | 69 6f 6e 20 77 68 65 72 |istribut|ion wher|
|00002460| 65 20 79 6f 75 20 63 61 | 6e 20 69 6e 73 74 72 75 |e you ca|n instru|
|00002470| 63 74 0a 25 20 20 20 20 | 20 20 20 20 74 68 65 20 |ct.%    |    the |
|00002480| 75 73 65 72 20 74 6f 20 | 73 69 6d 70 6c 79 20 72 |user to |simply r|
|00002490| 75 6e 0a 25 20 20 20 20 | 20 20 5c 62 65 67 69 6e |un.%    |  \begin|
|000024a0| 7b 71 75 6f 74 65 7d 0a | 25 20 20 20 20 20 20 20 |{quote}.|%       |
|000024b0| 20 5c 74 65 78 74 74 74 | 7b 54 45 58 7d 20 5c 6d | \texttt|{TEX} \m|
|000024c0| 65 74 61 7b 62 61 74 63 | 68 20 66 69 6c 65 7d 0a |eta{batc|h file}.|
|000024d0| 25 20 20 20 20 20 20 5c | 65 6e 64 7b 71 75 6f 74 |%      \|end{quot|
|000024e0| 65 7d 0a 25 20 20 20 20 | 20 20 20 20 74 6f 20 67 |e}.%    |    to g|
|000024f0| 65 6e 65 72 61 74 65 20 | 74 68 65 20 65 78 65 63 |enerate |the exec|
|00002500| 75 74 61 62 6c 65 20 76 | 65 72 73 69 6f 6e 73 20 |utable v|ersions |
|00002510| 6f 66 20 79 6f 75 72 20 | 66 69 6c 65 73 20 66 72 |of your |files fr|
|00002520| 6f 6d 20 74 68 65 0a 25 | 20 20 20 20 20 20 20 20 |om the.%|        |
|00002530| 64 69 73 74 72 69 62 75 | 74 69 6f 6e 20 73 6f 75 |distribu|tion sou|
|00002540| 72 63 65 73 2e 20 41 6c | 6c 20 64 69 73 74 72 69 |rces. Al|l distri|
|00002550| 62 75 74 69 6f 6e 73 20 | 66 72 6f 6d 20 4d 61 69 |butions |from Mai|
|00002560| 6e 7a 20 61 72 65 20 73 | 65 74 20 75 70 0a 25 20 |nz are s|et up.% |
|00002570| 20 20 20 20 20 20 20 69 | 6e 20 74 68 69 73 20 77 |       i|n this w|
|00002580| 61 79 20 28 61 6c 73 6f | 20 74 68 69 73 20 6f 6e |ay (also| this on|
|00002590| 65 29 3b 20 6c 6f 6f 6b | 2c 20 66 6f 72 20 65 78 |e); look|, for ex|
|000025a0| 61 6d 70 6c 65 2c 20 61 | 74 20 74 68 65 0a 25 20 |ample, a|t the.% |
|000025b0| 20 20 20 20 20 20 20 69 | 6e 73 74 61 6c 6c 61 74 |       i|nstallat|
|000025c0| 69 6f 6e 20 66 69 6c 65 | 20 66 6f 72 20 74 68 69 |ion file| for thi|
|000025d0| 73 20 64 69 73 74 72 69 | 62 75 74 69 6f 6e 2e 20 |s distri|bution. |
|000025e0| 20 54 6f 20 70 72 6f 64 | 75 63 65 20 73 75 63 68 | To prod|uce such|
|000025f0| 20 61 0a 25 20 20 20 20 | 20 20 20 20 62 61 74 63 | a.%    |    batc|
|00002600| 68 20 66 69 6c 65 20 69 | 6e 63 6c 75 64 65 20 61 |h file i|nclude a|
|00002610| 20 73 74 61 74 65 6d 65 | 6e 74 20 69 6e 20 79 6f | stateme|nt in yo|
|00002620| 75 72 20 60 62 61 74 63 | 68 20 66 69 6c 65 27 20 |ur `batc|h file' |
|00002630| 74 68 61 74 0a 25 20 20 | 20 20 20 20 20 20 69 6e |that.%  |      in|
|00002640| 73 74 72 75 63 74 73 20 | 5c 54 65 58 5c 20 74 6f |structs |\TeX\ to|
|00002650| 20 72 65 61 64 20 5c 74 | 65 78 74 74 74 7b 64 6f | read \t|exttt{do|
|00002660| 63 73 74 72 69 70 2e 74 | 65 78 7d 2e 20 59 6f 75 |cstrip.t|ex}. You|
|00002670| 20 73 68 6f 75 6c 64 20 | 74 68 65 6e 0a 25 20 20 | should |then.%  |
|00002680| 20 20 20 20 20 20 61 6c | 73 6f 20 64 65 66 69 6e |      al|so defin|
|00002690| 65 20 5c 76 65 72 62 3d | 5c 62 61 74 63 68 66 69 |e \verb=|\batchfi|
|000026a0| 6c 65 3d 20 74 6f 20 63 | 6f 6e 74 61 69 6e 20 74 |le= to c|ontain t|
|000026b0| 68 65 20 6e 61 6d 65 20 | 6f 66 20 74 68 61 74 0a |he name |of that.|
|000026c0| 25 20 20 20 20 20 20 20 | 20 60 62 61 74 63 68 20 |%       | `batch |
|000026d0| 66 69 6c 65 27 2e 20 54 | 68 65 20 62 65 67 69 6e |file'. T|he begin|
|000026e0| 6e 69 6e 67 20 6f 66 20 | 73 75 63 68 20 61 20 66 |ning of |such a f|
|000026f0| 69 6c 65 20 77 6f 75 6c | 64 20 6c 6f 6f 6b 20 6c |ile woul|d look l|
|00002700| 69 6b 65 3a 0a 25 20 20 | 20 20 5c 62 65 67 69 6e |ike:.%  |  \begin|
|00002710| 7b 76 65 72 62 61 74 69 | 6d 7d 0a 25 20 20 20 20 |{verbati|m}.%    |
|00002720| 5c 64 65 66 5c 62 61 74 | 63 68 66 69 6c 65 7b 69 |\def\bat|chfile{i|
|00002730| 6e 73 74 61 6c 6c 2e 6d | 65 7d 0a 25 20 20 20 20 |nstall.m|e}.%    |
|00002740| 5c 69 6e 70 75 74 20 64 | 6f 63 73 74 72 69 70 0a |\input d|ocstrip.|
|00002750| 25 20 20 20 20 2e 2e 2e | 0a 25 20 20 20 20 5c 65 |%    ...|.%    \e|
|00002760| 6e 64 7b 76 65 72 62 61 | 74 69 6d 7d 0a 25 20 20 |nd{verba|tim}.%  |
|00002770| 20 20 5c 65 6e 64 7b 65 | 6e 75 6d 65 72 61 74 65 |  \end{e|numerate|
|00002780| 7d 0a 25 0a 25 20 5c 73 | 65 63 74 69 6f 6e 7b 54 |}.%.% \s|ection{T|
|00002790| 68 65 20 75 73 65 72 20 | 69 6e 74 65 72 66 61 63 |he user |interfac|
|000027a0| 65 7d 0a 25 0a 25 20 5c | 73 75 62 73 65 63 74 69 |e}.%.% \|subsecti|
|000027b0| 6f 6e 7b 54 68 65 20 6d | 61 69 6e 20 70 72 6f 67 |on{The m|ain prog|
|000027c0| 72 61 6d 7d 0a 25 20 5c | 44 65 73 63 72 69 62 65 |ram}.% \|Describe|
|000027d0| 4d 61 63 72 6f 7b 5c 70 | 72 6f 63 65 73 73 62 61 |Macro{\p|rocessba|
|000027e0| 74 63 68 46 69 6c 65 7d | 20 54 68 65 20 60 6d 61 |tchFile}| The `ma|
|000027f0| 69 6e 20 70 72 6f 67 72 | 61 6d 27 20 73 74 61 72 |in progr|am' star|
|00002800| 74 73 20 77 69 74 68 0a | 25 20 20 20 20 74 72 79 |ts with.|%    try|
|00002810| 69 6e 67 20 74 6f 20 70 | 72 6f 63 65 73 73 20 61 |ing to p|rocess a|
|00002820| 20 62 61 74 63 68 20 66 | 69 6c 65 2c 20 74 68 69 | batch f|ile, thi|
|00002830| 73 20 69 73 20 61 63 63 | 6f 6d 70 6c 69 73 68 65 |s is acc|omplishe|
|00002840| 64 20 62 79 20 63 61 6c | 6c 69 6e 67 0a 25 20 20 |d by cal|ling.%  |
|00002850| 20 20 74 68 65 20 6d 61 | 63 72 6f 20 7c 5c 70 72 |  the ma|cro |\pr|
|00002860| 6f 63 65 73 73 62 61 74 | 63 68 46 69 6c 65 7c 2e |ocessbat|chFile|.|
|00002870| 20 49 74 20 63 6f 75 6e | 74 73 20 74 68 65 20 6e | It coun|ts the n|
|00002880| 75 6d 62 65 72 20 6f 66 | 20 62 61 74 63 68 0a 25 |umber of| batch.%|
|00002890| 20 20 20 20 66 69 6c 65 | 73 20 69 74 20 70 72 6f |    file|s it pro|
|000028a0| 63 65 73 73 65 73 2c 20 | 73 6f 20 74 68 61 74 20 |cesses, |so that |
|000028b0| 77 68 65 6e 20 74 68 65 | 20 6e 75 6d 62 65 72 20 |when the| number |
|000028c0| 6f 66 20 66 69 6c 65 73 | 20 70 72 6f 63 65 73 73 |of files| process|
|000028d0| 65 64 20 69 73 0a 25 20 | 20 20 20 73 74 69 6c 6c |ed is.% |   still|
|000028e0| 20 7a 65 72 6f 20 61 66 | 74 65 72 20 74 68 65 20 | zero af|ter the |
|000028f0| 63 61 6c 6c 20 74 6f 20 | 7c 5c 70 72 6f 63 65 73 |call to ||\proces|
|00002900| 73 62 61 74 63 68 46 69 | 6c 65 7c 20 61 70 70 72 |sbatchFi|le| appr|
|00002910| 6f 70 72 69 61 74 65 0a | 25 20 20 20 20 61 63 74 |opriate.|%    act|
|00002920| 69 6f 6e 20 63 61 6e 20 | 62 65 20 74 61 6b 65 6e |ion can |be taken|
|00002930| 2e 0a 25 0a 25 20 5c 44 | 65 73 63 72 69 62 65 4d |..%.% \D|escribeM|
|00002940| 61 63 72 6f 7b 5c 69 6e | 74 65 72 61 63 74 69 76 |acro{\in|teractiv|
|00002950| 65 7d 20 57 68 65 6e 20 | 6e 6f 20 62 61 74 63 68 |e} When |no batch|
|00002960| 20 66 69 6c 65 73 20 68 | 61 76 65 20 62 65 65 6e | files h|ave been|
|00002970| 20 70 72 6f 63 65 73 73 | 65 64 0a 25 20 20 20 20 | process|ed.%    |
|00002980| 74 68 65 20 6d 61 63 72 | 6f 20 7c 5c 69 6e 74 65 |the macr|o |\inte|
|00002990| 72 61 63 74 69 76 65 7c | 20 69 73 20 63 61 6c 6c |ractive|| is call|
|000029a0| 65 64 2e 20 49 74 20 70 | 72 6f 6d 70 74 73 20 74 |ed. It p|rompts t|
|000029b0| 68 65 20 75 73 65 72 20 | 66 6f 72 0a 25 20 20 20 |he user |for.%   |
|000029c0| 20 69 6e 66 6f 72 6d 61 | 74 69 6f 6e 2e 20 46 69 | informa|tion. Fi|
|000029d0| 72 73 74 20 74 68 65 20 | 65 78 74 65 6e 73 69 6f |rst the |extensio|
|000029e0| 6e 73 20 6f 66 20 74 68 | 65 20 69 6e 70 75 74 20 |ns of th|e input |
|000029f0| 61 6e 64 20 6f 75 74 70 | 75 74 20 66 69 6c 65 73 |and outp|ut files|
|00002a00| 0a 25 20 20 20 20 69 73 | 20 64 65 74 65 72 6d 69 |.%    is| determi|
|00002a10| 6e 65 64 2e 20 54 68 65 | 6e 20 61 20 71 75 65 73 |ned. The|n a ques|
|00002a20| 74 69 6f 6e 20 61 62 6f | 75 74 20 6f 70 74 69 6f |tion abo|ut optio|
|00002a30| 6e 61 6c 20 63 6f 64 65 | 20 69 73 20 61 73 6b 65 |nal code| is aske|
|00002a40| 64 20 61 6e 64 0a 25 20 | 20 20 20 66 69 6e 61 6c |d and.% |   final|
|00002a50| 6c 79 20 74 68 65 20 75 | 73 65 72 20 63 61 6e 20 |ly the u|ser can |
|00002a60| 67 69 76 65 20 61 20 6c | 69 73 74 20 6f 66 20 66 |give a l|ist of f|
|00002a70| 69 6c 65 73 20 74 68 61 | 74 20 68 61 76 65 20 74 |iles tha|t have t|
|00002a80| 6f 20 62 65 0a 25 20 20 | 20 20 70 72 6f 63 65 73 |o be.%  |  proces|
|00002a90| 73 65 64 2e 0a 25 0a 25 | 20 5c 44 65 73 63 72 69 |sed..%.%| \Descri|
|00002aa0| 62 65 4d 61 63 72 6f 7b | 5c 52 65 70 6f 72 74 54 |beMacro{|\ReportT|
|00002ab0| 6f 74 61 6c 73 7d 20 57 | 68 65 6e 20 74 68 65 20 |otals} W|hen the |
|00002ac0| 5c 74 65 78 74 74 74 7b | 73 74 61 74 73 7d 20 6f |\texttt{|stats} o|
|00002ad0| 70 74 69 6f 6e 20 69 73 | 0a 25 20 20 20 20 69 6e |ption is|.%    in|
|00002ae0| 63 6c 75 64 65 64 20 69 | 6e 20 74 68 65 20 5c 64 |cluded i|n the \d|
|00002af0| 73 7b 7d 2d 70 72 6f 67 | 72 61 6d 20 69 74 20 6b |s{}-prog|ram it k|
|00002b00| 65 65 70 73 20 61 20 72 | 65 63 6f 72 64 20 6f 66 |eeps a r|ecord of|
|00002b10| 20 74 68 65 20 6e 75 6d | 62 65 72 20 6f 66 0a 25 | the num|ber of.%|
|00002b20| 20 20 20 20 66 69 6c 65 | 73 20 61 6e 64 20 6c 69 |    file|s and li|
|00002b30| 6e 65 73 20 74 68 61 74 | 20 61 72 65 20 70 72 6f |nes that| are pro|
|00002b40| 63 65 73 73 65 64 2e 20 | 20 41 6c 73 6f 20 74 68 |cessed. | Also th|
|00002b50| 65 20 6e 75 6d 62 65 72 | 20 6f 66 20 63 6f 6d 6d |e number| of comm|
|00002b60| 65 6e 74 73 0a 25 20 20 | 20 20 72 65 6d 6f 76 65 |ents.%  |  remove|
|00002b70| 64 20 61 6e 64 20 70 61 | 73 73 65 64 20 61 73 20 |d and pa|ssed as |
|00002b80| 77 65 6c 6c 20 61 73 20 | 74 68 65 20 6e 75 6d 62 |well as |the numb|
|00002b90| 65 72 20 6f 66 20 63 6f | 64 65 20 6c 69 6e 65 73 |er of co|de lines|
|00002ba0| 20 74 68 61 74 20 77 65 | 72 65 0a 25 20 20 20 20 | that we|re.%    |
|00002bb0| 70 61 73 73 65 64 20 74 | 6f 20 74 68 65 20 6f 75 |passed t|o the ou|
|00002bc0| 74 70 75 74 20 61 72 65 | 20 61 63 63 6f 75 6e 74 |tput are| account|
|00002bd0| 65 64 2e 20 54 68 65 20 | 6d 61 63 72 6f 20 7c 5c |ed. The |macro |\|
|00002be0| 52 65 70 6f 72 74 54 6f | 74 61 6c 73 7c 0a 25 20 |ReportTo|tals|.% |
|00002bf0| 20 20 20 73 68 6f 77 73 | 20 61 20 73 75 6d 6d 61 |   shows| a summa|
|00002c00| 72 79 20 6f 66 20 74 68 | 69 73 20 69 6e 66 6f 72 |ry of th|is infor|
|00002c10| 6d 61 74 69 6f 6e 2e 0a | 25 0a 25 20 5c 73 75 62 |mation..|%.% \sub|
|00002c20| 73 65 63 74 69 6f 6e 7b | 42 61 74 63 68 66 69 6c |section{|Batchfil|
|00002c30| 65 20 63 6f 6d 6d 61 6e | 64 73 7d 0a 25 0a 25 20 |e comman|ds}.%.% |
|00002c40| 20 20 20 54 68 65 20 63 | 6f 6d 6d 61 6e 64 73 20 |   The c|ommands |
|00002c50| 64 65 73 63 72 69 62 65 | 64 20 69 6e 20 74 68 69 |describe|d in thi|
|00002c60| 73 20 73 65 63 74 69 6f | 6e 20 61 72 65 20 61 76 |s sectio|n are av|
|00002c70| 61 69 6c 61 62 6c 65 20 | 74 6f 20 62 75 69 6c 64 |ailable |to build|
|00002c80| 20 61 0a 25 20 20 20 20 | 62 61 74 63 68 20 66 69 | a.%    |batch fi|
|00002c90| 6c 65 2e 0a 25 0a 25 20 | 5c 44 65 73 63 72 69 62 |le..%.% |\Describ|
|00002ca0| 65 4d 61 63 72 6f 7b 5c | 73 68 6f 77 70 72 6f 67 |eMacro{\|showprog|
|00002cb0| 72 65 73 73 7d 0a 25 20 | 5c 44 65 73 63 72 69 62 |ress}.% |\Describ|
|00002cc0| 65 4d 61 63 72 6f 7b 5c | 6b 65 65 70 73 69 6c 65 |eMacro{\|keepsile|
|00002cd0| 6e 74 7d 0a 25 20 20 20 | 20 57 68 65 6e 20 74 68 |nt}.%   | When th|
|00002ce0| 65 20 6f 70 74 69 6f 6e | 20 5c 74 65 78 74 74 74 |e option| \texttt|
|00002cf0| 7b 73 74 61 74 73 7d 20 | 69 73 20 69 6e 63 6c 75 |{stats} |is inclu|
|00002d00| 64 65 64 20 69 6e 20 5c | 64 73 7b 7d 20 69 74 20 |ded in \|ds{} it |
|00002d10| 63 61 6e 0a 25 20 20 20 | 20 77 72 69 74 65 20 6d |can.%   | write m|
|00002d20| 65 73 73 61 67 65 20 74 | 6f 20 74 68 65 20 74 65 |essage t|o the te|
|00002d30| 72 6d 69 6e 61 6c 20 61 | 73 20 65 61 63 68 20 6c |rminal a|s each l|
|00002d40| 69 6e 65 20 6f 66 20 74 | 68 65 20 69 6e 70 75 74 |ine of t|he input|
|00002d50| 20 66 69 6c 65 28 73 29 | 20 69 73 0a 25 20 20 20 | file(s)| is.%   |
|00002d60| 20 70 72 6f 63 65 73 73 | 65 64 2e 20 54 68 69 73 | process|ed. This|
|00002d70| 20 6d 65 73 73 61 67 65 | 20 63 6f 6e 73 69 73 74 | message| consist|
|00002d80| 73 20 6f 66 20 61 20 73 | 69 6e 67 6c 65 20 63 68 |s of a s|ingle ch|
|00002d90| 61 72 61 63 74 65 72 2c | 20 69 6e 64 69 63 61 74 |aracter,| indicat|
|00002da0| 69 6e 67 0a 25 20 20 20 | 20 77 68 61 74 20 74 68 |ing.%   | what th|
|00002db0| 65 20 70 72 6f 67 72 61 | 6d 20 64 6f 65 73 20 77 |e progra|m does w|
|00002dc0| 69 74 68 20 74 68 61 74 | 20 70 61 72 74 69 63 75 |ith that| particu|
|00002dd0| 6c 61 72 20 6c 69 6e 65 | 2e 20 57 65 20 75 73 65 |lar line|. We use|
|00002de0| 20 74 68 65 0a 25 20 20 | 20 20 66 6f 6c 6c 6f 77 | the.%  |  follow|
|00002df0| 69 6e 67 20 63 68 61 72 | 61 63 74 65 72 73 3a 0a |ing char|acters:.|
|00002e00| 25 20 20 20 20 5c 62 65 | 67 69 6e 7b 69 74 65 6d |%    \be|gin{item|
|00002e10| 69 7a 65 7d 0a 25 20 5c | 69 74 65 6d 5b 5c 74 65 |ize}.% \|item[\te|
|00002e20| 78 74 74 74 7b 5c 25 7d | 5d 20 57 68 65 6e 65 76 |xttt{\%}|] Whenev|
|00002e30| 65 72 20 61 6e 20 69 6e | 70 75 74 20 6c 69 6e 65 |er an in|put line|
|00002e40| 20 69 73 20 72 65 6d 6f | 76 65 64 20 61 0a 25 20 | is remo|ved a.% |
|00002e50| 20 20 20 20 20 20 20 5c | 74 65 78 74 74 74 7b 5c |       \|texttt{\|
|00002e60| 25 7d 2d 63 68 61 72 61 | 63 74 65 72 20 69 73 20 |%}-chara|cter is |
|00002e70| 77 72 69 74 74 65 6e 20 | 74 6f 20 74 68 65 20 74 |written |to the t|
|00002e80| 65 72 6d 69 6e 61 6c 2e | 0a 25 20 5c 69 74 65 6d |erminal.|.% \item|
|00002e90| 5b 5c 74 65 78 74 74 74 | 7b 2e 7d 5d 20 57 68 65 |[\texttt|{.}] Whe|
|00002ea0| 6e 65 76 65 72 20 61 20 | 63 6f 64 65 20 6c 69 6e |never a |code lin|
|00002eb0| 65 20 69 73 20 70 61 73 | 73 65 64 20 6f 6e 20 74 |e is pas|sed on t|
|00002ec0| 6f 20 74 68 65 20 6f 75 | 74 70 75 74 20 66 69 6c |o the ou|tput fil|
|00002ed0| 65 0a 25 20 20 20 20 20 | 20 20 20 61 20 5c 74 65 |e.%     |   a \te|
|00002ee0| 78 74 74 74 7b 2e 7d 2d | 63 68 61 72 61 63 74 65 |xttt{.}-|characte|
|00002ef0| 72 20 69 73 20 77 72 69 | 74 74 65 6e 20 6f 6e 20 |r is wri|tten on |
|00002f00| 74 68 65 20 74 65 72 6d | 69 6e 61 6c 2e 0a 25 20 |the term|inal..% |
|00002f10| 5c 69 74 65 6d 5b 5c 74 | 65 78 74 74 74 7b 2f 7d |\item[\t|exttt{/}|
|00002f20| 5d 20 57 68 65 6e 20 61 | 20 6e 75 6d 62 65 72 20 |] When a| number |
|00002f30| 6f 66 20 65 6d 70 74 79 | 20 6c 69 6e 65 73 20 61 |of empty| lines a|
|00002f40| 70 70 65 61 72 20 69 6e | 20 61 20 72 6f 77 20 69 |ppear in| a row i|
|00002f50| 6e 20 74 68 65 0a 25 20 | 20 20 20 20 20 20 20 69 |n the.% |       i|
|00002f60| 6e 70 75 74 20 66 69 6c | 65 2c 20 61 74 20 6d 6f |nput fil|e, at mo|
|00002f70| 73 74 20 6f 6e 65 20 6f | 66 20 74 68 65 6d 20 69 |st one o|f them i|
|00002f80| 73 20 72 65 74 61 69 6e | 65 64 2e 20 54 68 65 20 |s retain|ed. The |
|00002f90| 5c 64 73 7b 7d 0a 25 20 | 20 20 20 20 20 20 20 70 |\ds{}.% |       p|
|00002fa0| 72 6f 67 72 61 6d 20 73 | 69 67 6e 61 6c 73 20 74 |rogram s|ignals t|
|00002fb0| 68 65 20 72 65 6d 6f 76 | 61 6c 20 6f 66 20 61 6e |he remov|al of an|
|00002fc0| 20 65 6d 70 74 79 20 6c | 69 6e 65 20 77 69 74 68 | empty l|ine with|
|00002fd0| 20 74 68 65 20 0a 25 20 | 20 20 20 20 20 20 20 5c | the .% |       \|
|00002fe0| 74 65 78 74 74 74 7b 2f | 7d 2d 63 68 61 72 61 63 |texttt{/|}-charac|
|00002ff0| 74 65 72 2e 0a 25 20 5c | 69 74 65 6d 5b 5c 74 65 |ter..% \|item[\te|
|00003000| 78 74 74 74 7b 3c 7d 5d | 20 57 68 65 6e 20 61 20 |xttt{<}]| When a |
|00003010| 60 67 75 61 72 64 20 6c | 69 6e 65 27 20 69 73 20 |`guard l|ine' is |
|00003020| 66 6f 75 6e 64 20 69 6e | 20 74 68 65 20 69 6e 70 |found in| the inp|
|00003030| 75 74 20 61 6e 64 20 69 | 74 0a 25 20 20 20 20 20 |ut and i|t.%     |
|00003040| 20 20 20 73 74 61 72 74 | 73 20 61 20 62 6c 6f 63 |   start|s a bloc|
|00003050| 6b 20 6f 66 20 6f 70 74 | 69 6f 6e 61 6c 6c 79 20 |k of opt|ionally |
|00003060| 69 6e 63 6c 75 64 65 64 | 20 63 6f 64 65 2c 20 74 |included| code, t|
|00003070| 68 69 73 20 69 73 20 73 | 69 67 6e 61 6c 6c 65 64 |his is s|ignalled|
|00003080| 0a 25 20 20 20 20 20 20 | 20 20 6f 6e 20 74 68 65 |.%      |  on the|
|00003090| 20 74 65 72 6d 69 6e 61 | 6c 20 62 79 20 73 68 6f | termina|l by sho|
|000030a0| 77 69 6e 67 20 74 68 65 | 20 5c 74 65 78 74 74 74 |wing the| \texttt|
|000030b0| 7b 3c 7d 2d 63 68 61 72 | 61 63 74 65 72 2c 20 74 |{<}-char|acter, t|
|000030c0| 6f 67 65 74 68 65 72 0a | 25 20 20 20 20 20 20 20 |ogether.|%       |
|000030d0| 20 77 69 74 68 20 74 68 | 65 20 62 6f 6f 6c 65 61 | with th|e boolea|
|000030e0| 6e 20 65 78 70 72 65 73 | 73 69 6f 6e 20 6f 66 20 |n expres|sion of |
|000030f0| 74 68 65 20 67 75 61 72 | 64 2e 0a 25 20 5c 69 74 |the guar|d..% \it|
|00003100| 65 6d 5b 5c 74 65 78 74 | 74 74 7b 3e 7d 5d 20 54 |em[\text|tt{>}] T|
|00003110| 68 65 20 65 6e 64 20 6f | 66 20 61 20 63 6f 6e 64 |he end o|f a cond|
|00003120| 69 74 69 6f 6e 61 6c 6c | 79 20 69 6e 63 6c 75 64 |itionall|y includ|
|00003130| 65 64 20 62 6c 6f 63 6b | 20 6f 66 20 63 6f 64 65 |ed block| of code|
|00003140| 20 69 73 0a 25 20 20 20 | 20 20 20 20 20 69 6e 64 | is.%   |     ind|
|00003150| 69 63 61 74 65 64 20 62 | 79 20 73 68 6f 77 69 6e |icated b|y showin|
|00003160| 67 20 74 68 65 20 5c 74 | 65 78 74 74 74 7b 3e 7d |g the \t|exttt{>}|
|00003170| 2d 63 68 61 72 61 63 74 | 65 72 2e 0a 25 20 20 20 |-charact|er..%   |
|00003180| 20 5c 65 6e 64 7b 69 74 | 65 6d 69 7a 65 7d 0a 25 | \end{it|emize}.%|
|00003190| 20 20 20 20 54 68 69 73 | 20 66 65 61 74 75 72 65 |    This| feature|
|000031a0| 20 69 73 20 74 75 72 6e | 65 64 20 6f 6e 20 62 79 | is turn|ed on by|
|000031b0| 20 64 65 66 61 75 6c 74 | 20 77 68 65 6e 20 74 68 | default| when th|
|000031c0| 65 20 6f 70 74 69 6f 6e | 0a 25 20 20 20 20 5c 74 |e option|.%    \t|
|000031d0| 65 78 74 74 74 7b 73 74 | 61 74 73 7d 20 69 73 20 |exttt{st|ats} is |
|000031e0| 69 6e 63 6c 75 64 65 64 | 2c 20 6f 74 68 65 72 77 |included|, otherw|
|000031f0| 69 73 65 20 69 74 20 69 | 73 20 74 75 72 6e 65 64 |ise it i|s turned|
|00003200| 20 6f 66 2e 20 54 68 65 | 0a 25 20 20 20 20 66 65 | of. The|.%    fe|
|00003210| 61 74 75 72 65 20 63 61 | 6e 20 62 65 20 74 6f 67 |ature ca|n be tog|
|00003220| 67 6c 65 64 20 77 69 74 | 68 20 74 68 65 20 63 6f |gled wit|h the co|
|00003230| 6d 6d 61 6e 64 73 20 7c | 5c 73 68 6f 77 70 72 6f |mmands ||\showpro|
|00003240| 67 72 65 73 73 7c 20 61 | 6e 64 0a 25 20 20 20 20 |gress| a|nd.%    |
|00003250| 7c 5c 6b 65 65 70 73 69 | 6c 65 6e 74 7c 0a 25 0a ||\keepsi|lent|.%.|
|00003260| 25 20 5c 44 65 73 63 72 | 69 62 65 4d 61 63 72 6f |% \Descr|ibeMacro|
|00003270| 7b 5c 70 72 65 61 6d 62 | 6c 65 7d 0a 25 20 5c 44 |{\preamb|le}.% \D|
|00003280| 65 73 63 72 69 62 65 4d | 61 63 72 6f 7b 5c 65 6e |escribeM|acro{\en|
|00003290| 64 70 72 65 61 6d 62 6c | 65 7d 0a 25 20 5c 44 65 |dpreambl|e}.% \De|
|000032a0| 73 63 72 69 62 65 4d 61 | 63 72 6f 7b 5c 70 6f 73 |scribeMa|cro{\pos|
|000032b0| 74 61 6d 62 6c 65 7d 0a | 25 20 5c 44 65 73 63 72 |tamble}.|% \Descr|
|000032c0| 69 62 65 4d 61 63 72 6f | 7b 5c 65 6e 64 70 6f 73 |ibeMacro|{\endpos|
|000032d0| 74 61 6d 62 6c 65 7d 0a | 25 20 20 20 20 49 74 20 |tamble}.|%    It |
|000032e0| 69 73 20 70 6f 73 73 69 | 62 6c 65 20 74 6f 20 61 |is possi|ble to a|
|000032f0| 64 64 20 61 20 6e 75 6d | 62 65 72 20 6f 66 20 6c |dd a num|ber of l|
|00003300| 69 6e 65 73 20 74 6f 20 | 74 68 65 20 6f 75 74 70 |ines to |the outp|
|00003310| 75 74 20 6f 66 0a 25 20 | 20 20 20 74 68 65 20 5c |ut of.% |   the \|
|00003320| 64 73 7b 7d 20 70 72 6f | 67 72 61 6d 2e 20 54 68 |ds{} pro|gram. Th|
|00003330| 65 20 69 6e 66 6f 72 6d | 61 74 69 6f 6e 20 79 6f |e inform|ation yo|
|00003340| 75 20 77 61 6e 74 20 74 | 6f 20 61 64 64 20 74 6f |u want t|o add to|
|00003350| 20 74 68 65 0a 25 20 20 | 20 20 73 74 61 72 74 20 | the.%  |  start |
|00003360| 6f 66 20 74 68 65 20 6f | 75 74 70 75 74 20 66 69 |of the o|utput fi|
|00003370| 6c 65 20 73 68 6f 75 6c | 64 20 62 65 20 6c 69 73 |le shoul|d be lis|
|00003380| 74 65 64 20 62 65 74 77 | 65 65 6e 20 74 68 65 20 |ted betw|een the |
|00003390| 7c 5c 70 72 65 61 6d 62 | 6c 65 7c 0a 25 20 20 20 ||\preamb|le|.%   |
|000033a0| 20 61 6e 64 20 7c 5c 65 | 6e 64 70 72 65 61 6d 62 | and |\e|ndpreamb|
|000033b0| 6c 65 7c 20 63 6f 6d 6d | 61 6e 64 73 3b 20 74 68 |le| comm|ands; th|
|000033c0| 65 20 6c 69 6e 65 73 20 | 79 6f 75 20 77 61 6e 74 |e lines |you want|
|000033d0| 20 74 6f 20 61 64 64 20 | 74 6f 20 74 68 65 20 65 | to add |to the e|
|000033e0| 6e 64 0a 25 20 20 20 20 | 6f 66 20 74 68 65 20 6f |nd.%    |of the o|
|000033f0| 75 74 70 75 74 20 66 69 | 6c 65 20 73 68 6f 75 6c |utput fi|le shoul|
|00003400| 64 20 62 65 20 6c 69 73 | 74 65 64 20 62 65 74 77 |d be lis|ted betw|
|00003410| 65 65 6e 20 74 68 65 20 | 7c 5c 70 6f 73 74 61 6d |een the ||\postam|
|00003420| 62 6c 65 7c 20 61 6e 64 | 0a 25 20 20 20 20 7c 5c |ble| and|.%    |\|
|00003430| 65 6e 64 70 6f 73 74 61 | 6d 62 6c 65 7c 20 63 6f |endposta|mble| co|
|00003440| 6d 6d 61 6e 64 73 2e 20 | 45 76 65 72 79 74 68 69 |mmands. |Everythi|
|00003450| 6e 67 20 74 68 61 74 20 | 5c 64 73 7b 7d 20 66 69 |ng that |\ds{} fi|
|00003460| 6e 64 73 0a 25 20 20 20 | 20 66 6f 72 20 62 6f 74 |nds.%   | for bot|
|00003470| 68 20 74 68 65 20 70 72 | 65 2d 20 61 6e 64 20 70 |h the pr|e- and p|
|00003480| 6f 73 74 61 6d 62 6c 65 | 20 69 74 20 77 72 69 74 |ostamble| it writ|
|00003490| 65 73 20 74 6f 20 74 68 | 65 20 6f 75 74 70 75 74 |es to th|e output|
|000034a0| 20 66 69 6c 65 2c 20 62 | 75 74 0a 25 20 20 20 20 | file, b|ut.%    |
|000034b0| 70 72 65 63 65 64 65 64 | 20 77 69 74 68 20 74 77 |preceded| with tw|
|000034c0| 6f 20 5c 25 2d 63 68 61 | 72 61 63 74 65 72 73 2e |o \%-cha|racters.|
|000034d0| 20 49 66 20 79 6f 75 20 | 69 6e 63 6c 75 64 65 20 | If you |include |
|000034e0| 61 20 7c 5e 5e 4d 7c 20 | 63 68 61 72 61 63 74 65 |a |^^M| |characte|
|000034f0| 72 0a 25 20 20 20 20 69 | 6e 20 6f 6e 65 20 6f 66 |r.%    i|n one of|
|00003500| 20 74 68 65 73 65 20 6c | 69 6e 65 73 2c 20 65 76 | these l|ines, ev|
|00003510| 65 72 79 74 68 69 6e 67 | 20 74 68 61 74 20 66 6f |erything| that fo|
|00003520| 6c 6c 6f 77 73 20 69 74 | 20 6f 6e 20 74 68 65 20 |llows it| on the |
|00003530| 73 61 6d 65 20 6c 69 6e | 65 0a 25 20 20 20 20 69 |same lin|e.%    i|
|00003540| 73 20 77 72 69 74 74 65 | 6e 20 74 6f 20 61 20 6e |s writte|n to a n|
|00003550| 65 77 20 6c 69 6e 65 20 | 69 6e 20 74 68 65 20 6f |ew line |in the o|
|00003560| 75 74 70 75 74 20 66 69 | 6c 65 2e 0a 25 20 20 20 |utput fi|le..%   |
|00003570| 20 54 68 69 73 20 60 66 | 65 61 74 75 72 65 27 20 | This `f|eature' |
|00003580| 63 61 6e 20 62 65 20 75 | 73 65 64 20 74 6f 20 61 |can be u|sed to a|
|00003590| 64 64 20 61 20 7c 5c 74 | 79 70 65 6f 75 74 7c 20 |dd a |\t|ypeout| |
|000035a0| 6f 72 20 7c 5c 6d 65 73 | 73 61 67 65 7c 20 74 6f |or |\mes|sage| to|
|000035b0| 20 74 68 65 0a 25 20 20 | 20 20 74 68 65 20 73 74 | the.%  |  the st|
|000035c0| 72 69 70 70 65 64 20 66 | 69 6c 65 2e 0a 25 0a 25 |ripped f|ile..%.%|
|000035d0| 20 5c 44 65 73 63 72 69 | 62 65 4d 61 63 72 6f 7b | \Descri|beMacro{|
|000035e0| 5c 67 65 6e 65 72 61 74 | 65 46 69 6c 65 7d 0a 25 |\generat|eFile}.%|
|000035f0| 20 20 20 20 54 68 65 20 | 6d 61 69 6e 20 72 65 61 |    The |main rea|
|00003600| 73 6f 6e 20 66 6f 72 20 | 63 6f 6e 73 74 72 75 63 |son for |construc|
|00003610| 74 69 6e 67 20 61 20 5c | 64 73 7b 7d 20 63 6f 6d |ting a \|ds{} com|
|00003620| 6d 61 6e 64 20 66 69 6c | 65 20 69 73 20 74 68 61 |mand fil|e is tha|
|00003630| 74 0a 25 20 20 20 20 6f | 6e 65 20 64 6f 65 73 6e |t.%    o|ne doesn|
|00003640| 27 74 20 77 61 6e 74 20 | 74 6f 20 74 79 70 65 20 |'t want |to type |
|00003650| 69 6e 20 74 68 65 20 69 | 6e 73 74 72 75 63 74 69 |in the i|nstructi|
|00003660| 6f 6e 73 20 66 6f 72 20 | 5c 54 65 58 5c 20 65 61 |ons for |\TeX\ ea|
|00003670| 63 68 20 74 69 6d 65 0a | 25 20 20 20 20 61 20 6d |ch time.|%    a m|
|00003680| 61 63 72 6f 20 66 69 6c | 65 20 69 73 20 73 74 72 |acro fil|e is str|
|00003690| 69 70 70 65 64 20 6f 66 | 20 69 74 73 20 63 6f 6d |ipped of| its com|
|000036a0| 6d 65 6e 74 73 2e 20 54 | 68 65 20 6d 61 63 72 6f |ments. T|he macro|
|000036b0| 20 7c 5c 67 65 6e 65 72 | 61 74 65 46 69 6c 65 7c | |\gener|ateFile||
|000036c0| 0a 25 20 20 20 20 69 73 | 20 75 73 65 64 20 74 6f |.%    is| used to|
|000036d0| 20 74 65 6c 6c 20 5c 54 | 65 58 5c 20 77 68 61 74 | tell \T|eX\ what|
|000036e0| 20 74 6f 20 64 6f 2e 20 | 49 74 73 20 73 79 6e 74 | to do. |Its synt|
|000036f0| 61 78 20 69 73 3a 0a 25 | 20 20 20 20 5c 62 65 67 |ax is:.%|    \beg|
|00003700| 69 6e 7b 71 75 6f 74 65 | 7d 0a 25 20 20 20 20 7c |in{quote|}.%    ||
|00003710| 5c 67 65 6e 65 72 61 74 | 65 46 69 6c 65 7b 7c 5c |\generat|eFile{|\|
|00003720| 6d 65 74 61 7b 6f 75 74 | 70 75 74 7d 7c 7d 7b 7c |meta{out|put}|}{||
|00003730| 5c 6d 65 74 61 7b 61 73 | 6b 7d 7c 7d 7b 7c 5b 7c |\meta{as|k}|}{|[||
|00003740| 5c 66 72 6f 6d 7b 7c 5e | 5e 41 0a 25 20 20 20 20 |\from{|^|^A.%    |
|00003750| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00003760| 5c 6d 65 74 61 7b 69 6e | 70 75 74 7d 7c 7d 7b 7c |\meta{in|put}|}{||
|00003770| 5c 6d 65 74 61 7b 6f 70 | 74 69 6f 6e 6c 69 73 74 |\meta{op|tionlist|
|00003780| 7d 7c 7d 7c 5d 2a 7c 7d | 7c 0a 25 20 20 20 20 5c |}|}|]*|}||.%    \|
|00003790| 65 6e 64 7b 71 75 6f 74 | 65 7d 0a 25 20 20 20 20 |end{quot|e}.%    |
|000037a0| 54 68 65 20 5c 6d 65 74 | 61 7b 6f 75 74 70 75 74 |The \met|a{output|
|000037b0| 7d 20 61 6e 64 20 5c 6d | 65 74 61 7b 69 6e 70 75 |} and \m|eta{inpu|
|000037c0| 74 7d 20 61 72 65 20 6e | 6f 72 6d 61 6c 20 66 69 |t} are n|ormal fi|
|000037d0| 6c 65 20 73 70 65 63 69 | 66 69 63 61 74 69 6f 6e |le speci|fication|
|000037e0| 73 0a 25 20 20 20 20 61 | 73 20 61 72 65 20 61 70 |s.%    a|s are ap|
|000037f0| 70 72 6f 70 72 69 61 74 | 65 20 66 6f 72 20 79 6f |propriat|e for yo|
|00003800| 75 72 20 63 6f 6d 70 75 | 74 65 72 20 73 79 73 74 |ur compu|ter syst|
|00003810| 65 6d 2e 20 54 68 65 20 | 5c 6d 65 74 61 7b 6f 70 |em. The |\meta{op|
|00003820| 74 69 6f 6e 6c 69 73 74 | 7d 0a 25 20 20 20 20 69 |tionlist|}.%    i|
|00003830| 73 20 61 20 63 6f 6d 6d | 61 20 73 65 70 61 72 61 |s a comm|a separa|
|00003840| 74 65 64 20 6c 69 73 74 | 20 6f 66 20 60 6f 70 74 |ted list| of `opt|
|00003850| 69 6f 6e 73 27 20 74 68 | 61 74 20 73 70 65 63 69 |ions' th|at speci|
|00003860| 66 79 20 77 68 69 63 68 | 0a 25 20 20 20 20 6f 70 |fy which|.%    op|
|00003870| 74 69 6f 6e 61 6c 20 63 | 6f 64 65 20 66 72 61 67 |tional c|ode frag|
|00003880| 6d 65 6e 74 73 20 69 6e | 20 5c 6d 65 74 61 7b 69 |ments in| \meta{i|
|00003890| 6e 70 75 74 7d 20 73 68 | 6f 75 6c 64 20 62 65 20 |nput} sh|ould be |
|000038a0| 69 6e 63 6c 75 64 65 64 | 20 69 6e 0a 25 20 20 20 |included| in.%   |
|000038b0| 20 5c 6d 65 74 61 7b 6f | 75 74 70 75 74 7d 2e 20 | \meta{o|utput}. |
|000038c0| 20 57 69 74 68 20 5c 6d | 65 74 61 7b 61 73 6b 7d | With \m|eta{ask}|
|000038d0| 20 79 6f 75 20 63 61 6e | 20 69 6e 73 74 72 75 63 | you can| instruc|
|000038e0| 74 20 5c 54 65 58 5c 20 | 74 6f 20 65 69 74 68 65 |t \TeX\ |to eithe|
|000038f0| 72 0a 25 20 20 20 20 73 | 69 6c 65 6e 74 6c 79 20 |r.%    s|ilently |
|00003900| 6f 76 65 72 77 72 69 74 | 65 20 61 20 70 72 65 76 |overwrit|e a prev|
|00003910| 69 6f 75 73 6c 79 20 65 | 78 69 73 74 69 6e 67 20 |iously e|xisting |
|00003920| 66 69 6c 65 20 28 7c 66 | 7c 29 20 6f 72 20 74 6f |file (|f||) or to|
|00003930| 20 69 73 73 75 65 20 61 | 0a 25 20 20 20 20 77 61 | issue a|.%    wa|
|00003940| 72 6e 69 6e 67 20 61 6e | 64 20 61 73 6b 20 79 6f |rning an|d ask yo|
|00003950| 75 20 69 66 20 69 74 20 | 73 68 6f 75 6c 64 20 6f |u if it |should o|
|00003960| 76 65 72 77 72 69 74 65 | 20 74 68 65 20 65 78 69 |verwrite| the exi|
|00003970| 73 74 69 6e 67 20 66 69 | 6c 65 0a 25 20 20 20 20 |sting fi|le.%    |
|00003980| 28 7c 74 7c 29 2e 0a 25 | 0a 25 20 20 20 20 49 74 |(|t|)..%|.%    It|
|00003990| 20 69 73 20 70 6f 73 73 | 69 62 6c 65 20 74 6f 20 | is poss|ible to |
|000039a0| 73 70 65 63 69 66 79 20 | 6d 75 6c 74 69 70 6c 65 |specify |multiple|
|000039b0| 20 69 6e 70 75 74 20 66 | 69 6c 65 73 2c 20 65 61 | input f|iles, ea|
|000039c0| 63 68 20 77 69 74 68 20 | 69 74 73 20 6f 77 6e 0a |ch with |its own.|
|000039d0| 25 20 20 20 20 5c 6d 65 | 74 61 7b 6f 70 74 69 6f |%    \me|ta{optio|
|000039e0| 6e 6c 69 73 74 7d 2e 20 | 54 68 69 73 20 69 73 20 |nlist}. |This is |
|000039f0| 69 6e 64 69 63 61 74 65 | 64 20 62 79 20 74 68 65 |indicate|d by the|
|00003a00| 20 6e 6f 74 61 74 69 6f | 6e 20 5b 5c 6c 64 6f 74 | notatio|n [\ldot|
|00003a10| 73 5d 2a 2e 0a 25 0a 25 | 20 5c 44 65 73 63 72 69 |s]*..%.%| \Descri|
|00003a20| 62 65 4d 61 63 72 6f 7b | 5c 69 6e 63 6c 75 64 65 |beMacro{|\include|
|00003a30| 7d 0a 25 20 5c 44 65 73 | 63 72 69 62 65 4d 61 63 |}.% \Des|cribeMac|
|00003a40| 72 6f 7b 5c 70 72 6f 63 | 65 73 73 46 69 6c 65 7d |ro{\proc|essFile}|
|00003a50| 0a 25 20 20 20 20 54 68 | 65 20 65 61 72 6c 69 65 |.%    Th|e earlie|
|00003a60| 72 20 76 65 72 73 69 6f | 6e 20 6f 66 20 74 68 65 |r versio|n of the|
|00003a70| 20 5c 64 73 7b 7d 20 70 | 72 6f 67 72 61 6d 20 73 | \ds{} p|rogram s|
|00003a80| 75 70 70 6f 72 74 65 64 | 20 61 0a 25 20 20 20 20 |upported| a.%    |
|00003a90| 64 69 66 66 65 72 65 6e | 74 20 6b 69 6e 64 20 6f |differen|t kind o|
|00003aa0| 66 20 63 6f 6d 6d 61 6e | 64 20 74 6f 20 74 65 6c |f comman|d to tel|
|00003ab0| 6c 20 5c 54 65 58 5c 20 | 77 68 61 74 20 74 6f 20 |l \TeX\ |what to |
|00003ac0| 64 6f 2e 20 54 68 69 73 | 20 63 6f 6d 6d 61 6e 64 |do. This| command|
|00003ad0| 0a 25 20 20 20 20 69 73 | 20 6c 65 73 73 20 70 6f |.%    is| less po|
|00003ae0| 77 65 72 66 75 6c 20 74 | 68 61 6e 20 7c 5c 67 65 |werful t|han |\ge|
|00003af0| 6e 65 72 61 74 65 46 69 | 6c 65 7c 3b 20 69 74 20 |nerateFi|le|; it |
|00003b00| 63 61 6e 20 62 65 20 75 | 73 65 64 20 77 68 65 6e |can be u|sed when|
|00003b10| 0a 25 20 20 20 20 5c 6d | 65 74 61 7b 6f 75 74 70 |.%    \m|eta{outp|
|00003b20| 75 74 7d 20 69 73 20 63 | 72 65 61 74 65 64 20 66 |ut} is c|reated f|
|00003b30| 72 6f 6d 20 6f 6e 65 20 | 5c 6d 65 74 61 7b 69 6e |rom one |\meta{in|
|00003b40| 70 75 74 7d 2e 20 54 68 | 65 20 73 79 6e 74 61 78 |put}. Th|e syntax|
|00003b50| 20 69 73 3a 0a 25 20 20 | 20 20 5c 62 65 67 69 6e | is:.%  |  \begin|
|00003b60| 7b 71 75 6f 74 65 7d 0a | 25 20 20 20 20 7c 5c 69 |{quote}.|%    |\i|
|00003b70| 6e 63 6c 75 64 65 7b 7c | 5c 6d 65 74 61 7b 6f 70 |nclude{||\meta{op|
|00003b80| 74 69 6f 6e 6c 69 73 74 | 7d 7c 7d 7c 0a 25 0a 25 |tionlist|}|}|.%.%|
|00003b90| 20 20 20 20 7c 5c 70 72 | 6f 63 65 73 73 46 69 6c |    |\pr|ocessFil|
|00003ba0| 65 7b 7c 5c 6d 65 74 61 | 7b 6e 61 6d 65 7d 7c 7d |e{|\meta|{name}|}|
|00003bb0| 7b 7c 5c 6d 65 74 61 7b | 69 6e 65 78 74 7d 5e 5e |{|\meta{|inext}^^|
|00003bc0| 41 0a 25 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |A.%     |        |
|00003bd0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00003be0| 20 7c 7d 7b 7c 5c 6d 65 | 74 61 7b 6f 75 74 65 78 | |}{|\me|ta{outex|
|00003bf0| 74 7d 5e 5e 41 0a 25 20 | 20 20 20 20 20 20 20 20 |t}^^A.% |        |
|00003c00| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00003c10| 20 20 20 20 20 7c 7d 7b | 7c 5c 6d 65 74 61 7b 61 |     |}{||\meta{a|
|00003c20| 73 6b 7d 7c 7d 7c 0a 25 | 20 20 20 20 5c 65 6e 64 |sk}|}|.%|    \end|
|00003c30| 7b 71 75 6f 74 65 7d 0a | 25 20 20 20 20 54 68 69 |{quote}.|%    Thi|
|00003c40| 73 20 63 6f 6d 6d 61 6e | 64 20 69 73 20 62 61 73 |s comman|d is bas|
|00003c50| 65 64 20 6f 6e 20 65 6e | 76 69 72 6f 6e 6d 65 6e |ed on en|vironmen|
|00003c60| 74 73 20 77 68 65 72 65 | 20 66 69 6c 65 6e 61 6d |ts where| filenam|
|00003c70| 65 73 20 61 72 65 0a 25 | 20 20 20 20 63 6f 6e 73 |es are.%|    cons|
|00003c80| 74 72 75 63 74 65 64 20 | 6f 66 20 74 77 6f 20 70 |tructed |of two p|
|00003c90| 61 72 74 73 2c 20 74 68 | 65 20 6e 61 6d 65 20 61 |arts, th|e name a|
|00003ca0| 6e 64 20 74 68 65 20 65 | 78 74 65 6e 73 69 6f 6e |nd the e|xtension|
|00003cb0| 2c 20 73 65 70 61 72 61 | 74 65 64 0a 25 20 20 20 |, separa|ted.%   |
|00003cc0| 20 77 69 74 68 20 61 20 | 64 6f 74 2e 20 54 68 65 | with a |dot. The|
|00003cd0| 20 73 79 6e 74 61 78 20 | 6f 66 20 74 68 69 73 20 | syntax |of this |
|00003ce0| 63 6f 6d 6d 61 6e 64 20 | 61 73 73 75 6d 65 73 20 |command |assumes |
|00003cf0| 74 68 61 74 20 74 68 65 | 0a 25 20 20 20 20 5c 6d |that the|.%    \m|
|00003d00| 65 74 61 7b 69 6e 70 75 | 74 7d 20 61 6e 64 20 5c |eta{inpu|t} and \|
|00003d10| 6d 65 74 61 7b 6f 75 74 | 70 75 74 7d 20 73 68 61 |meta{out|put} sha|
|00003d20| 72 65 20 74 68 65 20 73 | 61 6d 65 20 6e 61 6d 65 |re the s|ame name|
|00003d30| 20 61 6e 64 20 6f 6e 6c | 79 0a 25 20 20 20 20 64 | and onl|y.%    d|
|00003d40| 69 66 66 65 72 20 69 6e | 20 74 68 65 69 72 20 65 |iffer in| their e|
|00003d50| 78 74 65 6e 73 69 6f 6e | 2e 20 54 68 69 73 20 63 |xtension|. This c|
|00003d60| 6f 6d 6d 61 6e 64 20 69 | 73 20 72 65 74 61 69 6e |ommand i|s retain|
|00003d70| 65 64 20 74 6f 20 62 65 | 0a 25 20 20 20 20 62 61 |ed to be|.%    ba|
|00003d80| 63 6b 77 61 72 64 73 20 | 63 6f 6d 70 61 74 69 62 |ckwards |compatib|
|00003d90| 6c 65 20 77 69 74 68 20 | 74 68 65 20 6f 6c 64 65 |le with |the olde|
|00003da0| 72 20 76 65 72 73 69 6f | 6e 20 6f 66 20 5c 64 73 |r versio|n of \ds|
|00003db0| 7b 7d 2c 20 62 75 74 20 | 69 74 73 20 75 73 65 0a |{}, but |its use.|
|00003dc0| 25 20 20 20 20 69 73 20 | 6e 6f 74 20 65 6e 63 6f |%    is |not enco|
|00003dd0| 75 72 61 67 65 64 2e 0a | 25 0a 25 20 5c 44 65 73 |uraged..|%.% \Des|
|00003de0| 63 72 69 62 65 4d 61 63 | 72 6f 7b 5c 69 6e 70 75 |cribeMac|ro{\inpu|
|00003df0| 74 7d 0a 25 20 5c 44 65 | 73 63 72 69 62 65 4d 61 |t}.% \De|scribeMa|
|00003e00| 63 72 6f 7b 5c 62 61 74 | 63 68 69 6e 70 75 74 7d |cro{\bat|chinput}|
|00003e10| 20 0a 25 20 20 20 20 54 | 68 65 20 62 61 74 63 68 | .%    T|he batch|
|00003e20| 20 66 69 6c 65 20 63 6f | 6d 6d 61 6e 64 73 20 63 | file co|mmands c|
|00003e30| 61 6e 20 62 65 20 70 75 | 74 20 69 6e 74 6f 20 73 |an be pu|t into s|
|00003e40| 65 76 65 72 61 6c 20 62 | 61 74 63 68 20 66 69 6c |everal b|atch fil|
|00003e50| 65 73 20 77 68 69 63 68 | 0a 25 20 20 20 20 61 72 |es which|.%    ar|
|00003e60| 65 20 74 68 65 6e 20 65 | 78 65 63 75 74 65 64 20 |e then e|xecuted |
|00003e70| 66 72 6f 6d 20 61 20 6d | 61 73 74 65 72 20 62 61 |from a m|aster ba|
|00003e80| 74 63 68 20 66 69 6c 65 | 2e 20 54 68 69 73 20 69 |tch file|. This i|
|00003e90| 73 2c 20 66 6f 72 20 65 | 78 61 6d 70 6c 65 2c 0a |s, for e|xample,.|
|00003ea0| 25 20 20 20 20 75 73 65 | 66 75 6c 20 69 66 20 61 |%    use|ful if a|
|00003eb0| 20 64 69 73 74 72 69 62 | 75 74 69 6f 6e 20 63 6f | distrib|ution co|
|00003ec0| 6e 73 69 73 74 73 20 6f | 66 20 73 65 76 65 72 61 |nsists o|f severa|
|00003ed0| 6c 20 64 69 73 74 69 6e | 63 74 20 70 61 72 74 73 |l distin|ct parts|
|00003ee0| 2e 20 59 6f 75 0a 25 20 | 20 20 20 63 61 6e 20 74 |. You.% |   can t|
|00003ef0| 68 65 6e 20 77 72 69 74 | 65 20 69 6e 64 69 76 69 |hen writ|e indivi|
|00003f00| 64 75 61 6c 20 62 61 74 | 63 68 20 66 69 6c 65 73 |dual bat|ch files|
|00003f10| 20 66 6f 72 20 65 76 65 | 72 79 20 70 61 72 74 20 | for eve|ry part |
|00003f20| 61 6e 64 20 69 6e 0a 25 | 20 20 20 20 61 64 64 69 |and in.%|    addi|
|00003f30| 74 69 6f 6e 20 61 20 6d | 61 73 74 65 72 20 66 69 |tion a m|aster fi|
|00003f40| 6c 65 20 74 68 61 74 20 | 73 69 6d 70 6c 79 20 63 |le that |simply c|
|00003f50| 61 6c 6c 73 20 74 68 65 | 20 62 61 74 63 68 20 66 |alls the| batch f|
|00003f60| 69 6c 65 73 20 66 6f 72 | 20 74 68 65 0a 25 20 20 |iles for| the.%  |
|00003f70| 20 20 70 61 72 74 73 2e | 20 20 46 6f 72 20 74 68 |  parts.|  For th|
|00003f80| 69 73 2c 20 63 61 6c 6c | 20 74 68 65 20 69 6e 64 |is, call| the ind|
|00003f90| 69 76 69 64 75 61 6c 20 | 62 61 74 63 68 20 66 69 |ividual |batch fi|
|00003fa0| 6c 65 73 20 66 72 6f 6d | 20 74 68 65 20 6d 61 73 |les from| the mas|
|00003fb0| 74 65 72 0a 25 20 20 20 | 20 66 69 6c 65 20 77 69 |ter.%   | file wi|
|00003fc0| 74 68 20 74 68 65 20 63 | 6f 6d 6d 61 6e 64 20 7c |th the c|ommand ||
|00003fd0| 5c 62 61 74 63 68 69 6e | 70 75 74 7b 7c 5c 6d 65 |\batchin|put{|\me|
|00003fe0| 74 61 7b 66 69 6c 65 7d | 7c 7d 7c 2e 20 59 6f 75 |ta{file}||}|. You|
|00003ff0| 20 63 61 6e 20 6e 65 73 | 74 0a 25 20 20 20 20 62 | can nes|t.%    b|
|00004000| 61 74 63 68 20 66 69 6c | 65 73 20 75 70 20 74 6f |atch fil|es up to|
|00004010| 20 61 20 6e 65 73 74 69 | 6e 67 20 6c 65 76 65 6c | a nesti|ng level|
|00004020| 20 6f 66 20 74 65 6e 20 | 77 68 69 63 68 20 69 73 | of ten |which is|
|00004030| 20 6d 6f 72 65 20 74 68 | 61 6e 0a 25 20 20 20 20 | more th|an.%    |
|00004040| 73 75 66 66 69 63 69 65 | 6e 74 2e 20 44 6f 6e 27 |sufficie|nt. Don'|
|00004050| 74 20 75 73 65 20 7c 5c | 69 6e 70 75 74 7c 20 66 |t use |\|input| f|
|00004060| 6f 72 20 74 68 69 73 20 | 70 75 72 70 6f 73 65 2c |or this |purpose,|
|00004070| 20 74 68 69 73 20 63 6f | 6d 6d 61 6e 64 0a 25 20 | this co|mmand.% |
|00004080| 20 20 20 73 68 6f 75 6c | 64 20 62 65 20 75 73 65 |   shoul|d be use|
|00004090| 64 20 6f 6e 6c 79 20 66 | 6f 72 20 63 61 6c 6c 69 |d only f|or calli|
|000040a0| 6e 67 20 74 68 65 20 5c | 64 73 7b 7d 20 70 72 6f |ng the \|ds{} pro|
|000040b0| 67 72 61 6d 20 61 73 20 | 65 78 70 6c 61 69 6e 65 |gram as |explaine|
|000040c0| 64 0a 25 20 20 20 20 61 | 62 6f 76 65 20 61 6e 64 |d.%    a|bove and|
|000040d0| 20 69 73 20 69 67 6e 6f | 72 65 64 20 77 68 65 6e | is igno|red when|
|000040e0| 20 75 73 65 64 20 66 6f | 72 20 61 6e 79 20 6f 74 | used fo|r any ot|
|000040f0| 68 65 72 20 70 75 72 70 | 6f 73 65 2e 0a 25 0a 25 |her purp|ose..%.%|
|00004100| 20 5c 44 65 73 63 72 69 | 62 65 4d 61 63 72 6f 7b | \Descri|beMacro{|
|00004110| 5c 69 66 54 6f 70 6c 65 | 76 65 6c 7d 20 0a 25 20 |\ifTople|vel} .% |
|00004120| 20 20 20 57 68 65 6e 20 | 62 61 74 63 68 20 66 69 |   When |batch fi|
|00004130| 6c 65 73 20 61 72 65 20 | 6e 65 73 74 65 64 20 79 |les are |nested y|
|00004140| 6f 75 20 6d 61 79 20 77 | 61 6e 74 20 74 6f 20 73 |ou may w|ant to s|
|00004150| 75 70 70 72 65 73 73 20 | 63 65 72 74 61 69 6e 0a |uppress |certain.|
|00004160| 25 20 20 20 20 63 6f 6d | 6d 61 6e 64 73 20 69 6e |%    com|mands in|
|00004170| 20 74 68 65 20 6c 6f 77 | 65 72 2d 6c 65 76 65 6c | the low|er-level|
|00004180| 20 62 61 74 63 68 20 66 | 69 6c 65 73 20 73 75 63 | batch f|iles suc|
|00004190| 68 20 61 73 20 74 65 72 | 6d 69 6e 61 6c 0a 25 20 |h as ter|minal.% |
|000041a0| 20 20 20 6d 65 73 73 61 | 67 65 73 2e 20 46 6f 72 |   messa|ges. For|
|000041b0| 20 74 68 69 73 20 70 75 | 72 70 6f 73 65 20 79 6f | this pu|rpose yo|
|000041c0| 75 20 63 61 6e 20 75 73 | 65 20 74 68 65 20 7c 5c |u can us|e the |\|
|000041d0| 69 66 54 6f 70 6c 65 76 | 65 6c 7c 20 63 6f 6d 6d |ifToplev|el| comm|
|000041e0| 61 6e 64 0a 25 20 20 20 | 20 77 68 69 63 68 20 65 |and.%   | which e|
|000041f0| 78 65 63 75 74 65 73 20 | 69 74 73 20 61 72 67 75 |xecutes |its argu|
|00004200| 6d 65 6e 74 20 6f 6e 6c | 79 20 69 66 20 74 68 65 |ment onl|y if the|
|00004210| 20 63 75 72 72 65 6e 74 | 20 62 61 74 63 68 20 66 | current| batch f|
|00004220| 69 6c 65 20 69 73 20 74 | 68 65 0a 25 20 20 20 20 |ile is t|he.%    |
|00004230| 6f 75 74 65 72 6d 6f 73 | 74 20 6f 6e 65 2e 20 4d |outermos|t one. M|
|00004240| 61 6b 65 20 73 75 72 65 | 20 74 68 61 74 20 79 6f |ake sure| that yo|
|00004250| 75 20 70 75 74 20 74 68 | 65 20 6f 70 65 6e 69 6e |u put th|e openin|
|00004260| 67 20 62 72 61 63 65 20 | 6f 66 20 74 68 65 0a 25 |g brace |of the.%|
|00004270| 20 20 20 20 61 72 67 75 | 6d 65 6e 74 20 69 6e 74 |    argu|ment int|
|00004280| 6f 20 74 68 65 20 73 61 | 6d 65 20 6c 69 6e 65 20 |o the sa|me line |
|00004290| 61 73 20 74 68 65 20 63 | 6f 6d 6d 61 6e 64 20 69 |as the c|ommand i|
|000042a0| 74 73 65 6c 66 2c 20 6f | 74 68 65 72 77 69 73 65 |tself, o|therwise|
|000042b0| 20 74 68 65 0a 25 20 20 | 20 20 5c 64 73 7b 7d 20 | the.%  |  \ds{} |
|000042c0| 70 72 6f 67 72 61 6d 20 | 77 69 6c 6c 20 67 65 74 |program |will get|
|000042d0| 20 63 6f 6e 66 75 73 65 | 64 2e 0a 25 0a 25 20 5c | confuse|d..%.% \|
|000042e0| 73 65 63 74 69 6f 6e 7b | 43 6f 6e 64 69 74 69 6f |section{|Conditio|
|000042f0| 6e 61 6c 20 69 6e 63 6c | 75 73 69 6f 6e 20 6f 66 |nal incl|usion of|
|00004300| 20 63 6f 64 65 7d 0a 25 | 0a 25 20 20 20 20 57 68 | code}.%|.%    Wh|
|00004310| 65 6e 20 79 6f 75 20 75 | 73 65 20 74 68 65 20 5c |en you u|se the \|
|00004320| 64 73 7b 7d 20 70 72 6f | 67 72 61 6d 20 74 6f 20 |ds{} pro|gram to |
|00004330| 73 74 72 69 70 20 63 6f | 6d 6d 65 6e 74 73 20 6f |strip co|mments o|
|00004340| 75 74 20 6f 66 0a 25 20 | 20 20 20 5c 54 65 58 5c |ut of.% |   \TeX\|
|00004350| 20 6d 61 63 72 6f 20 66 | 69 6c 65 73 20 79 6f 75 | macro f|iles you|
|00004360| 20 68 61 76 65 20 74 68 | 65 20 70 6f 73 73 69 62 | have th|e possib|
|00004370| 69 6c 69 74 79 20 74 6f | 20 6d 61 6b 65 20 6d 6f |ility to| make mo|
|00004380| 72 65 20 74 68 61 6e 20 | 6f 6e 65 0a 25 20 20 20 |re than |one.%   |
|00004390| 20 73 74 72 69 70 70 65 | 64 20 6d 61 63 72 6f 20 | strippe|d macro |
|000043a0| 66 69 6c 65 20 66 72 6f | 6d 20 6f 6e 65 20 64 6f |file fro|m one do|
|000043b0| 63 75 6d 65 6e 74 65 64 | 20 66 69 6c 65 2e 20 54 |cumented| file. T|
|000043c0| 68 69 73 20 69 73 20 61 | 63 68 69 65 76 65 64 20 |his is a|chieved |
|000043d0| 62 79 0a 25 20 20 20 20 | 74 68 65 20 73 75 70 70 |by.%    |the supp|
|000043e0| 6f 72 74 20 66 6f 72 20 | 6f 70 74 69 6f 6e 61 6c |ort for |optional|
|000043f0| 20 63 6f 64 65 2e 20 54 | 68 65 20 6f 70 74 69 6f | code. T|he optio|
|00004400| 6e 61 6c 20 63 6f 64 65 | 20 69 73 20 6d 61 72 6b |nal code| is mark|
|00004410| 65 64 0a 25 20 20 20 20 | 69 6e 20 74 68 65 20 64 |ed.%    |in the d|
|00004420| 6f 63 75 6d 65 6e 74 65 | 64 20 66 69 6c 65 20 77 |ocumente|d file w|
|00004430| 69 74 68 20 61 20 60 67 | 75 61 72 64 27 2e 0a 25 |ith a `g|uard'..%|
|00004440| 0a 25 20 20 20 20 41 20 | 67 75 61 72 64 20 69 73 |.%    A |guard is|
|00004450| 20 61 20 62 6f 6f 6c 65 | 61 6e 20 65 78 70 72 65 | a boole|an expre|
|00004460| 73 73 69 6f 6e 20 74 68 | 61 74 20 69 73 20 65 6e |ssion th|at is en|
|00004470| 63 6c 6f 73 65 64 20 69 | 6e 20 7c 3c 7c 20 61 6e |closed i|n |<| an|
|00004480| 64 20 7c 3e 7c 2e 0a 25 | 20 20 20 20 49 74 20 61 |d |>|..%|    It a|
|00004490| 6c 73 6f 20 7b 5c 65 6d | 20 68 61 73 5c 2f 7d 20 |lso {\em| has\/} |
|000044a0| 74 6f 20 66 6f 6c 6c 6f | 77 20 74 68 65 20 7c 25 |to follo|w the |%|
|000044b0| 7c 20 61 74 20 74 68 65 | 20 62 65 67 69 6e 6e 69 || at the| beginni|
|000044c0| 6e 67 20 6f 66 20 74 68 | 65 20 6c 69 6e 65 2e 0a |ng of th|e line..|
|000044d0| 25 20 20 20 20 46 6f 72 | 20 65 78 61 6d 70 6c 65 |%    For| example|
|000044e0| 3a 0a 25 5c 62 65 67 69 | 6e 7b 76 65 72 62 61 74 |:.%\begi|n{verbat|
|000044f0| 69 6d 7d 0a 25 20 20 20 | 20 2e 2e 2e 0a 25 20 20 |im}.%   | ....%  |
|00004500| 20 20 25 3c 62 6f 6f 6c | 3e 5c 54 65 58 20 63 6f |  %<bool|>\TeX co|
|00004510| 64 65 0a 25 20 20 20 20 | 2e 2e 2e 0a 25 5c 65 6e |de.%    |....%\en|
|00004520| 64 7b 76 65 72 62 61 74 | 69 6d 7d 0a 25 20 20 20 |d{verbat|im}.%   |
|00004530| 20 49 6e 20 74 68 69 73 | 20 65 78 61 6d 70 6c 65 | In this| example|
|00004540| 20 74 68 65 20 6c 69 6e | 65 20 6f 66 20 63 6f 64 | the lin|e of cod|
|00004550| 65 20 77 69 6c 6c 20 62 | 65 20 69 6e 63 6c 75 64 |e will b|e includ|
|00004560| 65 64 20 69 6e 20 5c 6d | 65 74 61 7b 6f 75 74 70 |ed in \m|eta{outp|
|00004570| 75 74 7d 0a 25 20 20 20 | 20 69 66 20 74 68 65 20 |ut}.%   | if the |
|00004580| 6f 70 74 69 6f 6e 20 5c | 74 65 78 74 74 74 7b 62 |option \|texttt{b|
|00004590| 6f 6f 6c 7d 20 69 73 20 | 70 72 65 73 65 6e 74 20 |ool} is |present |
|000045a0| 69 6e 20 74 68 65 20 5c | 6d 65 74 61 7b 6f 70 74 |in the \|meta{opt|
|000045b0| 69 6f 6e 6c 69 73 74 7d | 20 6f 66 0a 25 20 20 20 |ionlist}| of.%   |
|000045c0| 20 74 68 65 20 7c 5c 67 | 65 6e 65 72 61 74 65 46 | the |\g|enerateF|
|000045d0| 69 6c 65 7c 20 63 6f 6d | 6d 61 6e 64 2e 0a 25 0a |ile| com|mand..%.|
|000045e0| 25 20 20 20 20 54 68 65 | 20 73 79 6e 74 61 78 20 |%    The| syntax |
|000045f0| 66 6f 72 20 74 68 65 20 | 62 6f 6f 6c 65 61 6e 20 |for the |boolean |
|00004600| 65 78 70 72 65 73 73 69 | 6f 6e 73 20 69 73 3a 0a |expressi|ons is:.|
|00004610| 25 0a 25 5c 44 65 6c 65 | 74 65 53 68 6f 72 74 56 |%.%\Dele|teShortV|
|00004620| 65 72 62 5c 7c 0a 25 20 | 20 20 20 5c 62 65 67 69 |erb\|.% |   \begi|
|00004630| 6e 7b 74 61 62 75 6c 61 | 72 7d 7b 6c 63 6c 7d 0a |n{tabula|r}{lcl}.|
|00004640| 25 20 20 20 20 5c 6d 65 | 74 61 7b 45 78 70 72 65 |%    \me|ta{Expre|
|00004650| 73 73 69 6f 6e 7d 20 26 | 20 24 3a 3a 3d 24 20 26 |ssion} &| $::=$ &|
|00004660| 20 5c 6d 65 74 61 7b 50 | 72 69 6d 61 72 79 7d 0a | \meta{P|rimary}.|
|00004670| 25 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |%       |        |
|00004680| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 5b 5c 7b |        |     [\{|
|00004690| 5c 74 65 78 74 74 74 7b | 7c 7d 2c 20 5c 74 65 78 |\texttt{||}, \tex|
|000046a0| 74 74 74 7b 2c 7d 5c 7d | 20 0a 25 20 20 20 20 20 |ttt{,}\}| .%     |
|000046b0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|000046c0| 20 20 20 20 20 20 20 5c | 6d 65 74 61 7b 50 72 69 |       \|meta{Pri|
|000046d0| 6d 61 72 79 7d 5d 2a 5c | 5c 0a 25 20 20 20 20 5c |mary}]*\|\.%    \|
|000046e0| 6d 65 74 61 7b 50 72 69 | 6d 61 72 79 7d 20 20 20 |meta{Pri|mary}   |
|000046f0| 20 26 20 24 3a 3a 3d 24 | 20 26 20 0a 25 20 20 20 | & $::=$| & .%   |
|00004700| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00004710| 20 20 20 20 20 5c 6d 65 | 74 61 7b 53 65 63 6f 6e |     \me|ta{Secon|
|00004720| 64 61 72 79 7d 20 5b 5c | 74 65 78 74 74 74 7b 5c |dary} [\|texttt{\|
|00004730| 26 7d 0a 25 20 20 20 20 | 20 20 20 20 20 20 20 20 |&}.%    |        |
|00004740| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 5c 6d 65 |        |     \me|
|00004750| 74 61 7b 53 65 63 6f 6e | 64 61 72 79 7d 5d 2a 5c |ta{Secon|dary}]*\|
|00004760| 5c 0a 25 20 20 20 20 5c | 6d 65 74 61 7b 53 65 63 |\.%    \|meta{Sec|
|00004770| 6f 6e 64 61 72 79 7d 20 | 20 26 20 24 3a 3a 3d 24 |ondary} | & $::=$|
|00004780| 20 26 20 0a 25 20 20 20 | 20 20 20 20 20 20 20 20 | & .%   |        |
|00004790| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 5c 6d 65 |        |     \me|
|000047a0| 74 61 7b 54 65 72 6d 69 | 6e 61 6c 7d 20 24 7c 24 |ta{Termi|nal} $|$|
|000047b0| 20 5c 74 65 78 74 74 74 | 7b 21 7d 5c 6d 65 74 61 | \texttt|{!}\meta|
|000047c0| 7b 53 65 63 6f 6e 64 61 | 72 79 7d 0a 25 20 20 20 |{Seconda|ry}.%   |
|000047d0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|000047e0| 20 20 20 20 20 24 7c 24 | 20 5c 74 65 78 74 74 74 |     $|$| \texttt|
|000047f0| 7b 28 7d 5c 6d 65 74 61 | 7b 45 78 70 72 65 73 73 |{(}\meta|{Express|
|00004800| 69 6f 6e 7d 5c 74 65 78 | 74 74 74 7b 29 7d 5c 5c |ion}\tex|ttt{)}\\|
|00004810| 0a 25 20 20 20 20 5c 65 | 6e 64 7b 74 61 62 75 6c |.%    \e|nd{tabul|
|00004820| 61 72 7d 0a 25 0a 25 20 | 20 20 20 54 68 65 20 5c |ar}.%.% |   The \|
|00004830| 74 65 78 74 74 74 7b 7c | 7d 20 73 74 61 6e 64 73 |texttt{||} stands|
|00004840| 20 66 6f 72 20 64 69 73 | 6a 75 6e 63 74 69 6f 6e | for dis|junction|
|00004850| 2c 20 74 68 65 20 5c 74 | 65 78 74 74 74 7b 5c 26 |, the \t|exttt{\&|
|00004860| 7d 20 73 74 61 6e 64 73 | 20 66 6f 72 0a 25 20 20 |} stands| for.%  |
|00004870| 20 20 63 6f 6e 6a 75 6e | 63 74 69 6f 6e 20 61 6e |  conjun|ction an|
|00004880| 64 20 74 68 65 20 5c 74 | 65 78 74 74 74 7b 21 7d |d the \t|exttt{!}|
|00004890| 5c 20 73 74 61 6e 64 73 | 20 66 6f 72 20 6e 65 67 |\ stands| for neg|
|000048a0| 61 74 69 6f 6e 2e 20 54 | 68 65 0a 25 20 20 20 20 |ation. T|he.%    |
|000048b0| 5c 6d 65 74 61 7b 54 65 | 72 6d 69 6e 61 6c 7d 20 |\meta{Te|rminal} |
|000048c0| 69 73 20 61 6e 79 20 73 | 65 71 75 65 6e 63 65 20 |is any s|equence |
|000048d0| 6f 66 20 6c 65 74 74 65 | 72 73 20 61 6e 64 20 65 |of lette|rs and e|
|000048e0| 76 61 6c 75 61 74 65 73 | 20 74 6f 0a 25 20 20 20 |valuates| to.%   |
|000048f0| 20 5c 6d 65 74 61 7b 74 | 72 75 65 7d 20 69 66 66 | \meta{t|rue} iff|
|00004900| 5c 66 6f 6f 74 6e 6f 74 | 65 7b 69 66 66 20 73 74 |\footnot|e{iff st|
|00004910| 61 6e 64 73 20 66 6f 72 | 20 60 69 66 20 61 6e 64 |ands for| `if and|
|00004920| 20 6f 6e 6c 79 20 69 66 | 27 7d 20 69 74 0a 25 20 | only if|'} it.% |
|00004930| 20 20 20 6f 63 63 75 72 | 73 20 69 6e 20 74 68 65 |   occur|s in the|
|00004940| 20 6c 69 73 74 20 6f 66 | 20 6f 70 74 69 6f 6e 73 | list of| options|
|00004950| 20 74 68 61 74 20 68 61 | 76 65 20 74 6f 20 62 65 | that ha|ve to be|
|00004960| 20 69 6e 63 6c 75 64 65 | 64 2e 0a 25 5c 4d 61 6b | include|d..%\Mak|
|00004970| 65 53 68 6f 72 74 56 65 | 72 62 5c 7c 0a 25 0a 25 |eShortVe|rb\|.%.%|
|00004980| 20 20 20 20 54 77 6f 20 | 6b 69 6e 64 73 20 6f 66 |    Two |kinds of|
|00004990| 20 6f 70 74 69 6f 6e 61 | 6c 20 63 6f 64 65 20 61 | optiona|l code a|
|000049a0| 72 65 20 73 75 70 70 6f | 72 74 65 64 3a 20 6f 6e |re suppo|rted: on|
|000049b0| 65 20 63 61 6e 20 65 69 | 74 68 65 72 20 68 61 76 |e can ei|ther hav|
|000049c0| 65 0a 25 20 20 20 20 6f | 70 74 69 6f 6e 61 6c 20 |e.%    o|ptional |
|000049d0| 63 6f 64 65 20 74 68 61 | 74 20 60 66 69 74 73 27 |code tha|t `fits'|
|000049e0| 20 6f 6e 20 6f 6e 65 20 | 6c 69 6e 65 20 6f 66 20 | on one |line of |
|000049f0| 74 65 78 74 2c 20 6c 69 | 6b 65 20 74 68 65 20 65 |text, li|ke the e|
|00004a00| 78 61 6d 70 6c 65 0a 25 | 20 20 20 20 61 62 6f 76 |xample.%|    abov|
|00004a10| 65 2c 20 6f 72 20 6f 6e | 65 20 63 61 6e 20 68 61 |e, or on|e can ha|
|00004a20| 76 65 20 62 6c 6f 63 6b | 73 20 6f 66 20 6f 70 74 |ve block|s of opt|
|00004a30| 69 6f 6e 61 6c 20 63 6f | 64 65 2e 0a 25 0a 25 20 |ional co|de..%.% |
|00004a40| 20 20 20 54 6f 20 64 69 | 73 74 69 6e 67 75 69 73 |   To di|stinguis|
|00004a50| 68 20 62 6f 74 68 20 6b | 69 6e 64 73 20 6f 66 20 |h both k|inds of |
|00004a60| 6f 70 74 69 6f 6e 61 6c | 20 63 6f 64 65 20 74 68 |optional| code th|
|00004a70| 65 20 60 67 75 61 72 64 | 20 6d 6f 64 69 66 69 65 |e `guard| modifie|
|00004a80| 72 27 0a 25 20 20 20 20 | 68 61 73 20 62 65 65 6e |r'.%    |has been|
|00004a90| 20 69 6e 74 72 6f 64 75 | 63 65 64 2e 20 54 68 65 | introdu|ced. The|
|00004aa0| 20 60 67 75 61 72 64 20 | 6d 6f 64 69 66 69 65 72 | `guard |modifier|
|00004ab0| 27 20 69 73 20 6f 6e 65 | 20 63 68 61 72 61 63 74 |' is one| charact|
|00004ac0| 65 72 20 74 68 61 74 0a | 25 20 20 20 20 69 6d 6d |er that.|%    imm|
|00004ad0| 65 64 69 61 74 65 6c 79 | 20 66 6f 6c 6c 6f 77 73 |ediately| follows|
|00004ae0| 20 74 68 65 20 7c 3c 7c | 20 6f 66 20 74 68 65 20 | the |<|| of the |
|00004af0| 67 75 61 72 64 2e 20 49 | 74 20 63 61 6e 20 62 65 |guard. I|t can be|
|00004b00| 20 65 69 74 68 65 72 20 | 7c 2a 7c 0a 25 20 20 20 | either ||*|.%   |
|00004b10| 20 66 6f 72 20 74 68 65 | 20 62 65 67 69 6e 6e 69 | for the| beginni|
|00004b20| 6e 67 20 6f 66 20 61 20 | 62 6c 6f 63 6b 20 6f 66 |ng of a |block of|
|00004b30| 20 63 6f 64 65 2c 20 6f | 72 20 7c 2f 7c 20 66 6f | code, o|r |/| fo|
|00004b40| 72 20 74 68 65 20 65 6e | 64 20 6f 66 20 61 0a 25 |r the en|d of a.%|
|00004b50| 20 20 20 20 62 6c 6f 63 | 6b 20 6f 66 20 63 6f 64 |    bloc|k of cod|
|00004b60| 65 5c 66 6f 6f 74 6e 6f | 74 65 7b 54 6f 20 62 65 |e\footno|te{To be|
|00004b70| 20 63 6f 6d 70 61 74 69 | 62 6c 65 20 77 69 74 68 | compati|ble with|
|00004b80| 20 74 68 65 20 65 61 72 | 6c 69 65 72 20 76 65 72 | the ear|lier ver|
|00004b90| 73 69 6f 6e 0a 25 20 20 | 20 20 6f 66 20 5c 64 73 |sion.%  |  of \ds|
|00004ba0| 7b 7d 20 61 6c 73 6f 20 | 5c 74 65 78 74 74 74 7b |{} also |\texttt{|
|00004bb0| 2b 7d 20 61 6e 64 20 5c | 74 65 78 74 74 74 7b 2d |+} and \|texttt{-|
|00004bc0| 7d 20 61 72 65 20 73 75 | 70 70 6f 72 74 65 64 20 |} are su|pported |
|00004bd0| 61 73 20 60 67 75 61 72 | 64 0a 25 20 20 20 20 6d |as `guar|d.%    m|
|00004be0| 6f 64 69 66 69 65 72 73 | 27 2e 20 20 48 6f 77 65 |odifiers|'.  Howe|
|00004bf0| 76 65 72 2c 20 74 68 65 | 72 65 20 69 73 20 61 6e |ver, the|re is an|
|00004c00| 20 69 6e 63 6f 6d 70 61 | 74 69 62 69 6c 69 74 79 | incompa|tibility|
|00004c10| 20 77 69 74 68 20 74 68 | 65 0a 25 20 20 20 20 65 | with th|e.%    e|
|00004c20| 61 72 6c 69 65 72 20 76 | 65 72 73 69 6f 6e 20 73 |arlier v|ersion s|
|00004c30| 69 6e 63 65 20 61 20 6c | 69 6e 65 20 77 69 74 68 |ince a l|ine with|
|00004c40| 20 61 20 5c 74 65 78 74 | 74 74 7b 2b 7d 2d 6d 6f | a \text|tt{+}-mo|
|00004c50| 64 69 66 69 65 64 20 67 | 75 61 72 64 20 69 73 0a |dified g|uard is.|
|00004c60| 25 20 20 20 20 6e 6f 74 | 20 69 6e 63 6c 75 64 65 |%    not| include|
|00004c70| 64 20 69 6e 73 69 64 65 | 20 61 20 62 6c 6f 63 6b |d inside| a block|
|00004c80| 20 77 69 74 68 20 61 20 | 67 75 61 72 64 20 74 68 | with a |guard th|
|00004c90| 61 74 20 65 76 61 6c 75 | 61 74 65 73 20 74 6f 20 |at evalu|ates to |
|00004ca0| 66 61 6c 73 65 2c 0a 25 | 20 20 20 20 69 6e 20 63 |false,.%|    in c|
|00004cb0| 6f 6e 74 72 61 73 74 20 | 74 6f 20 74 68 65 20 70 |ontrast |to the p|
|00004cc0| 72 65 76 69 6f 75 73 20 | 62 65 68 61 76 69 6f 75 |revious |behaviou|
|00004cd0| 72 2e 7d 2e 20 20 54 68 | 65 20 62 65 67 69 6e 6e |r.}.  Th|e beginn|
|00004ce0| 69 6e 67 20 61 6e 64 0a | 25 20 20 20 20 65 6e 64 |ing and.|%    end|
|00004cf0| 69 6e 67 20 67 75 61 72 | 64 73 20 66 6f 72 20 61 |ing guar|ds for a|
|00004d00| 20 62 6c 6f 63 6b 20 6f | 66 20 63 6f 64 65 20 68 | block o|f code h|
|00004d10| 61 76 65 20 74 6f 20 62 | 65 20 6f 6e 20 61 20 6c |ave to b|e on a l|
|00004d20| 69 6e 65 20 62 79 0a 25 | 20 20 20 20 74 68 65 6d |ine by.%|    them|
|00004d30| 73 65 6c 76 65 73 2e 0a | 25 0a 25 20 20 20 20 57 |selves..|%.%    W|
|00004d40| 68 65 6e 20 61 20 62 6c | 6f 63 6b 20 6f 66 20 63 |hen a bl|ock of c|
|00004d50| 6f 64 65 20 69 73 20 7b | 5c 65 6d 20 6e 6f 74 5c |ode is {|\em not\|
|00004d60| 2f 7d 20 69 6e 63 6c 75 | 64 65 64 2c 20 61 6e 79 |/} inclu|ded, any|
|00004d70| 20 67 75 61 72 64 73 20 | 74 68 61 74 20 6f 63 63 | guards |that occ|
|00004d80| 75 72 0a 25 20 20 20 20 | 77 69 74 68 69 6e 20 74 |ur.%    |within t|
|00004d90| 68 61 74 20 62 6c 6f 63 | 6b 20 61 72 65 20 7b 5c |hat bloc|k are {\|
|00004da0| 65 6d 20 6e 6f 74 5c 2f | 7d 20 65 76 61 6c 75 61 |em not\/|} evalua|
|00004db0| 74 65 64 2e 0a 25 0a 25 | 5c 53 74 6f 70 45 76 65 |ted..%.%|\StopEve|
|00004dc0| 6e 74 75 61 6c 6c 79 7b | 25 0a 25 5e 5e 41 20 5c |ntually{|%.%^^A \|
|00004dd0| 73 65 63 74 69 6f 6e 7b | 43 6f 6e 63 6c 75 73 69 |section{|Conclusi|
|00004de0| 6f 6e 7d 0a 25 20 20 5c | 50 72 69 6e 74 49 6e 64 |on}.%  \|PrintInd|
|00004df0| 65 78 0a 25 20 20 5c 50 | 72 69 6e 74 43 68 61 6e |ex.%  \P|rintChan|
|00004e00| 67 65 73 0a 25 5e 5e 41 | 20 5c 6d 61 6b 65 73 69 |ges.%^^A| \makesi|
|00004e10| 67 6e 61 74 75 72 65 0a | 25 20 7d 0a 25 0a 25 20 |gnature.|% }.%.% |
|00004e20| 5c 73 65 63 74 69 6f 6e | 7b 50 72 6f 64 75 63 69 |\section|{Produci|
|00004e30| 6e 67 20 74 68 65 20 64 | 6f 63 75 6d 65 6e 74 61 |ng the d|ocumenta|
|00004e40| 74 69 6f 6e 7d 0a 25 0a | 25 20 20 20 20 57 65 20 |tion}.%.|%    We |
|00004e50| 70 72 6f 76 69 64 65 20 | 61 20 73 68 6f 72 74 20 |provide |a short |
|00004e60| 64 72 69 76 65 72 20 66 | 69 6c 65 20 74 68 61 74 |driver f|ile that|
|00004e70| 20 63 61 6e 20 62 65 20 | 65 78 74 72 61 63 74 65 | can be |extracte|
|00004e80| 64 20 62 79 20 74 68 65 | 0a 25 20 20 20 20 5c 64 |d by the|.%    \d|
|00004e90| 73 7b 7d 20 70 72 6f 67 | 72 61 6d 20 75 73 69 6e |s{} prog|ram usin|
|00004ea0| 67 20 74 68 65 20 74 68 | 65 20 63 6f 6e 64 69 74 |g the th|e condit|
|00004eb0| 69 6f 6e 61 6c 20 60 5c | 74 65 78 74 73 66 7b 64 |ional `\|textsf{d|
|00004ec0| 72 69 76 65 72 7d 27 2e | 20 20 54 6f 0a 25 20 20 |river}'.|  To.%  |
|00004ed0| 20 20 61 6c 6c 6f 77 20 | 74 68 65 20 75 73 65 20 |  allow |the use |
|00004ee0| 6f 66 20 5c 74 65 78 74 | 74 74 7b 64 6f 63 73 74 |of \text|tt{docst|
|00004ef0| 72 69 70 2e 64 74 78 7d | 20 61 73 20 61 20 70 72 |rip.dtx}| as a pr|
|00004f00| 6f 67 72 61 6d 20 61 74 | 20 49 6e 69 5c 54 65 58 |ogram at| Ini\TeX|
|00004f10| 7b 7d 0a 25 20 20 20 20 | 74 69 6d 65 20 28 65 2e |{}.%    |time (e.|
|00004f20| 67 2e 2c 20 74 6f 20 73 | 74 72 69 70 0a 25 20 20 |g., to s|trip.%  |
|00004f30| 20 20 6f 66 66 20 69 74 | 73 20 6f 77 6e 20 63 6f |  off it|s own co|
|00004f40| 6d 6d 65 6e 74 73 29 20 | 77 65 20 6e 65 65 64 20 |mments) |we need |
|00004f50| 74 6f 20 61 64 64 20 61 | 20 62 69 74 20 6f 66 20 |to add a| bit of |
|00004f60| 70 72 69 6d 69 74 69 76 | 65 20 63 6f 64 65 2e 0a |primitiv|e code..|
|00004f70| 25 20 20 20 20 57 69 74 | 68 20 74 68 69 73 20 65 |%    Wit|h this e|
|00004f80| 78 74 72 61 20 63 68 65 | 63 6b 69 6e 67 20 69 74 |xtra che|cking it|
|00004f90| 20 69 73 20 73 74 69 6c | 6c 20 70 6f 73 73 69 62 | is stil|l possib|
|00004fa0| 6c 65 20 74 6f 20 70 72 | 6f 63 65 73 73 20 74 68 |le to pr|ocess th|
|00004fb0| 69 73 0a 25 20 20 20 20 | 66 69 6c 65 20 77 69 74 |is.%    |file wit|
|00004fc0| 68 20 5c 4c 61 54 65 58 | 65 7b 7d 20 74 6f 20 74 |h \LaTeX|e{} to t|
|00004fd0| 79 70 65 73 65 74 20 74 | 68 65 20 64 6f 63 75 6d |ypeset t|he docum|
|00004fe0| 65 6e 74 61 74 69 6f 6e | 2e 0a 25 20 5c 63 68 61 |entation|..% \cha|
|00004ff0| 6e 67 65 73 7b 32 2e 31 | 62 7d 7b 31 39 39 33 2f |nges{2.1|b}{1993/|
|00005000| 30 32 2f 32 33 7d 7b 41 | 64 64 65 64 20 66 6f 6e |02/23}{A|dded fon|
|00005010| 74 64 65 66 69 6e 69 74 | 69 6f 6e 73 20 66 6f 72 |tdefinit|ions for|
|00005020| 20 64 6f 63 20 74 6f 20 | 74 68 65 20 64 72 69 76 | doc to |the driv|
|00005030| 65 72 0a 25 20 20 20 20 | 20 20 20 20 20 20 20 20 |er.%    |        |
|00005040| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 66 69 |        |      fi|
|00005050| 6c 65 2c 20 69 6e 20 6f | 72 64 65 72 20 74 6f 20 |le, in o|rder to |
|00005060| 67 65 74 20 74 68 65 20 | 6c 61 79 6f 75 74 20 6f |get the |layout o|
|00005070| 66 20 74 68 65 20 63 6f | 64 65 0a 25 20 20 20 20 |f the co|de.%    |
|00005080| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00005090| 20 20 20 20 20 20 72 69 | 67 68 74 3b 20 61 6c 73 |      ri|ght; als|
|000050a0| 6f 20 61 64 64 65 64 20 | 74 68 65 20 6c 61 79 6f |o added |the layo|
|000050b0| 75 74 20 64 65 66 69 6e | 69 74 69 6f 6e 73 0a 25 |ut defin|itions.%|
|000050c0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|000050d0| 20 20 20 20 20 20 20 20 | 20 20 74 68 61 74 20 61 |        |  that a|
|000050e0| 72 65 20 69 6e 20 65 66 | 66 65 63 74 20 69 6e 20 |re in ef|fect in |
|000050f0| 5c 74 65 78 74 74 74 7b | 64 6f 63 2e 64 72 76 7d |\texttt{|doc.drv}|
|00005100| 7d 0a 25 20 5c 63 68 61 | 6e 67 65 73 7b 32 2e 31 |}.% \cha|nges{2.1|
|00005110| 63 7d 7b 31 39 39 33 2f | 30 32 2f 32 33 7d 7b 52 |c}{1993/|02/23}{R|
|00005120| 65 6d 6f 76 65 20 64 65 | 66 69 6e 69 74 69 6f 6e |emove de|finition|
|00005130| 73 20 66 6f 72 20 66 6f | 6e 74 73 20 61 67 61 69 |s for fo|nts agai|
|00005140| 6e 7d 0a 25 20 5c 63 68 | 61 6e 67 65 73 7b 32 2e |n}.% \ch|anges{2.|
|00005150| 32 66 7d 7b 31 39 39 34 | 2f 30 32 2f 32 36 7d 7b |2f}{1994|/02/26}{|
|00005160| 41 6c 6c 6f 77 20 64 69 | 72 65 63 74 20 70 72 6f |Allow di|rect pro|
|00005170| 63 65 73 73 69 6e 67 20 | 6f 66 20 73 6f 75 72 63 |cessing |of sourc|
|00005180| 65 7d 0a 25 20 20 20 20 | 5c 62 65 67 69 6e 7b 6d |e}.%    |\begin{m|
|00005190| 61 63 72 6f 63 6f 64 65 | 7d 0a 25 3c 2a 64 72 69 |acrocode|}.%<*dri|
|000051a0| 76 65 72 3e 0a 25 20 20 | 20 20 5c 65 6e 64 7b 6d |ver>.%  |  \end{m|
|000051b0| 61 63 72 6f 63 6f 64 65 | 7d 0a 25 20 20 20 20 49 |acrocode|}.%    I|
|000051c0| 66 20 7c 5c 64 6f 63 75 | 6d 65 6e 74 63 6c 61 73 |f |\docu|mentclas|
|000051d0| 73 7c 20 69 73 20 75 6e | 64 65 66 69 6e 65 64 2c |s| is un|defined,|
|000051e0| 20 65 2e 67 2e 2c 20 69 | 66 20 49 6e 69 5c 54 65 | e.g., i|f Ini\Te|
|000051f0| 58 7b 7d 20 6f 72 20 70 | 6c 61 69 6e 0a 25 20 20 |X{} or p|lain.%  |
|00005200| 20 20 5c 54 65 58 7b 7d | 20 69 73 20 75 73 65 64 |  \TeX{}| is used|
|00005210| 20 66 6f 72 20 66 6f 72 | 6d 61 74 74 69 6e 67 2c | for for|matting,|
|00005220| 20 77 65 20 62 79 70 61 | 73 73 20 74 68 65 20 64 | we bypa|ss the d|
|00005230| 72 69 76 65 72 20 66 69 | 6c 65 2e 0a 25 20 20 20 |river fi|le..%   |
|00005240| 20 5c 62 65 67 69 6e 7b | 6d 61 63 72 6f 63 6f 64 | \begin{|macrocod|
|00005250| 65 7d 0a 5c 69 66 78 5c | 64 6f 63 75 6d 65 6e 74 |e}.\ifx\|document|
|00005260| 63 6c 61 73 73 5c 75 6e | 64 65 66 69 6e 65 64 0a |class\un|defined.|
|00005270| 5c 65 6c 73 65 0a 25 20 | 20 20 20 5c 65 6e 64 7b |\else.% |   \end{|
|00005280| 6d 61 63 72 6f 63 6f 64 | 65 7d 0a 25 20 20 20 20 |macrocod|e}.%    |
|00005290| 4f 74 68 65 72 77 69 73 | 65 20 77 65 20 70 72 6f |Otherwis|e we pro|
|000052a0| 63 65 73 73 20 74 68 65 | 20 66 6f 6c 6c 6f 77 69 |cess the| followi|
|000052b0| 6e 67 20 6c 69 6e 65 73 | 20 77 68 69 63 68 20 77 |ng lines| which w|
|000052c0| 69 6c 6c 20 72 65 73 75 | 6c 74 20 69 6e 0a 25 20 |ill resu|lt in.% |
|000052d0| 20 20 20 66 6f 72 6d 61 | 74 74 69 6e 67 20 74 68 |   forma|tting th|
|000052e0| 65 20 64 6f 63 75 6d 65 | 6e 74 61 74 69 6f 6e 2e |e docume|ntation.|
|000052f0| 0a 25 20 20 20 20 5c 62 | 65 67 69 6e 7b 6d 61 63 |.%    \b|egin{mac|
|00005300| 72 6f 63 6f 64 65 7d 0a | 5c 64 6f 63 75 6d 65 6e |rocode}.|\documen|
|00005310| 74 63 6c 61 73 73 7b 6c | 74 78 64 6f 63 7d 0a 20 |tclass{l|txdoc}. |
|00005320| 20 20 20 5c 45 6e 61 62 | 6c 65 43 72 6f 73 73 72 |   \Enab|leCrossr|
|00005330| 65 66 73 0a 20 25 20 20 | 20 20 5c 44 69 73 61 62 |efs. %  |  \Disab|
|00005340| 6c 65 43 72 6f 73 73 72 | 65 66 73 20 20 20 20 25 |leCrossr|efs    %|
|00005350| 20 75 73 65 20 5c 44 69 | 73 61 62 6c 65 43 72 6f | use \Di|sableCro|
|00005360| 73 73 72 65 66 73 20 69 | 66 20 74 68 65 0a 20 20 |ssrefs i|f the.  |
|00005370| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00005380| 20 20 20 20 20 20 20 20 | 20 25 20 69 6e 64 65 78 |        | % index|
|00005390| 20 69 73 20 72 65 61 64 | 79 0a 20 20 20 5c 52 65 | is read|y.   \Re|
|000053a0| 63 6f 72 64 43 68 61 6e | 67 65 73 0a 20 25 20 20 |cordChan|ges. %  |
|000053b0| 20 5c 4f 6e 6c 79 44 65 | 73 63 72 69 70 74 69 6f | \OnlyDe|scriptio|
|000053c0| 6e 0a 20 20 20 5c 74 79 | 70 65 6f 75 74 7b 45 78 |n.   \ty|peout{Ex|
|000053d0| 70 65 63 74 20 73 6f 6d | 65 20 55 6e 64 65 72 2d |pect som|e Under-|
|000053e0| 20 61 6e 64 20 6f 76 65 | 72 66 75 6c 6c 20 62 6f | and ove|rfull bo|
|000053f0| 78 65 73 7d 0a 5c 62 65 | 67 69 6e 7b 64 6f 63 75 |xes}.\be|gin{docu|
|00005400| 6d 65 6e 74 7d 0a 20 20 | 5c 44 6f 63 49 6e 70 75 |ment}.  |\DocInpu|
|00005410| 74 7b 64 6f 63 73 74 72 | 69 70 2e 64 74 78 7d 0a |t{docstr|ip.dtx}.|
|00005420| 25 20 20 20 20 5c 65 6e | 64 7b 6d 61 63 72 6f 63 |%    \en|d{macroc|
|00005430| 6f 64 65 7d 0a 25 20 20 | 20 20 57 65 20 63 61 6e |ode}.%  |  We can|
|00005440| 6e 6f 74 20 63 61 6c 6c | 20 7c 5c 65 6e 64 7b 64 |not call| |\end{d|
|00005450| 6f 63 75 6d 65 6e 74 7d | 7c 20 61 74 20 74 68 69 |ocument}|| at thi|
|00005460| 73 20 70 6f 69 6e 74 20 | 62 65 63 61 75 73 65 20 |s point |because |
|00005470| 74 68 69 73 20 77 6f 75 | 6c 64 0a 25 20 20 20 20 |this wou|ld.%    |
|00005480| 6c 65 61 76 65 20 74 68 | 65 20 7c 5c 69 66 78 7c |leave th|e |\ifx||
|00005490| 20 66 72 6f 6d 20 61 62 | 6f 76 65 20 75 6e 66 69 | from ab|ove unfi|
|000054a0| 6e 69 73 68 65 64 20 61 | 6e 64 20 74 68 65 20 75 |nished a|nd the u|
|000054b0| 73 65 72 20 77 6f 75 6c | 64 20 67 65 74 20 61 0a |ser woul|d get a.|
|000054c0| 25 20 20 20 20 77 61 72 | 6e 69 6e 67 20 6d 65 73 |%    war|ning mes|
|000054d0| 73 61 67 65 2e 20 54 68 | 65 72 65 66 6f 72 65 20 |sage. Th|erefore |
|000054e0| 77 65 20 64 6f 20 73 6f | 6d 65 20 7c 5c 65 78 70 |we do so|me |\exp|
|000054f0| 61 6e 64 61 66 74 65 72 | 7c 20 70 72 6f 63 65 73 |andafter|| proces|
|00005500| 73 69 6e 67 3b 0a 25 20 | 20 20 20 68 69 64 69 6e |sing;.% |   hidin|
|00005510| 67 20 74 68 65 20 7c 5c | 65 6e 64 7b 64 6f 63 75 |g the |\|end{docu|
|00005520| 6d 65 6e 74 7d 7c 20 66 | 6f 72 20 61 20 6d 6f 6d |ment}| f|or a mom|
|00005530| 65 6e 74 20 69 6e 20 61 | 20 73 63 72 61 74 63 68 |ent in a| scratch|
|00005540| 20 6d 61 63 72 6f 20 66 | 6f 72 0a 25 20 20 20 20 | macro f|or.%    |
|00005550| 65 61 73 69 65 72 20 70 | 72 6f 63 65 73 73 69 6e |easier p|rocessin|
|00005560| 67 2e 0a 25 20 20 20 20 | 5c 62 65 67 69 6e 7b 6d |g..%    |\begin{m|
|00005570| 61 63 72 6f 63 6f 64 65 | 7d 0a 5c 72 65 6e 65 77 |acrocode|}.\renew|
|00005580| 63 6f 6d 6d 61 6e 64 5c | 6e 65 78 74 7b 5c 65 6e |command\|next{\en|
|00005590| 64 7b 64 6f 63 75 6d 65 | 6e 74 7d 7d 0a 5c 65 78 |d{docume|nt}}.\ex|
|000055a0| 70 61 6e 64 61 66 74 65 | 72 5c 6e 65 78 74 5c 66 |pandafte|r\next\f|
|000055b0| 69 0a 25 3c 2f 64 72 69 | 76 65 72 3e 0a 25 20 20 |i.%</dri|ver>.%  |
|000055c0| 20 20 5c 65 6e 64 7b 6d | 61 63 72 6f 63 6f 64 65 |  \end{m|acrocode|
|000055d0| 7d 0a 25 0a 25 0a 25 20 | 5c 73 65 63 74 69 6f 6e |}.%.%.% |\section|
|000055e0| 7b 54 68 65 20 69 6d 70 | 6c 65 6d 65 6e 74 61 74 |{The imp|lementat|
|000055f0| 69 6f 6e 7d 0a 25 0a 25 | 20 5c 73 75 62 73 65 63 |ion}.%.%| \subsec|
|00005600| 74 69 6f 6e 7b 44 65 63 | 6c 61 72 61 74 69 6f 6e |tion{Dec|laration|
|00005610| 73 20 61 6e 64 20 69 6e | 69 74 69 61 6c 69 7a 61 |s and in|itializa|
|00005620| 74 69 6f 6e 73 7d 0a 25 | 0a 25 20 20 20 20 49 6e |tions}.%|.%    In|
|00005630| 20 6f 72 64 65 72 20 74 | 6f 20 62 65 20 61 62 6c | order t|o be abl|
|00005640| 65 20 74 6f 20 69 6e 63 | 6c 75 64 65 20 74 68 65 |e to inc|lude the|
|00005650| 20 5c 74 65 78 74 74 74 | 7b 40 7d 2d 73 69 67 6e | \texttt|{@}-sign|
|00005660| 20 69 6e 20 63 6f 6e 74 | 72 6f 6c 0a 25 20 20 20 | in cont|rol.%   |
|00005670| 20 73 65 71 75 65 6e 63 | 65 73 20 69 74 73 20 63 | sequenc|es its c|
|00005680| 61 74 65 67 6f 72 79 20 | 63 6f 64 65 20 69 73 20 |ategory |code is |
|00005690| 63 68 61 6e 67 65 64 20 | 74 6f 20 5c 6d 65 74 61 |changed |to \meta|
|000056a0| 7b 6c 65 74 74 65 72 7d | 2e 20 20 54 68 65 0a 25 |{letter}|.  The.%|
|000056b0| 20 20 20 20 60 70 72 6f | 67 72 61 6d 27 20 67 75 |    `pro|gram' gu|
|000056c0| 61 72 64 20 68 65 72 65 | 20 61 6c 6c 6f 77 73 20 |ard here| allows |
|000056d0| 6d 6f 73 74 20 6f 66 20 | 74 68 65 20 63 6f 64 65 |most of |the code|
|000056e0| 20 74 6f 20 62 65 20 65 | 78 63 6c 75 64 65 64 20 | to be e|xcluded |
|000056f0| 77 68 65 6e 0a 25 20 20 | 20 20 65 78 74 72 61 63 |when.%  |  extrac|
|00005700| 74 69 6e 67 20 74 68 65 | 20 64 72 69 76 65 72 20 |ting the| driver |
|00005710| 66 69 6c 65 2e 0a 25 20 | 20 20 20 5c 62 65 67 69 |file..% |   \begi|
|00005720| 6e 7b 6d 61 63 72 6f 63 | 6f 64 65 7d 0a 25 3c 2a |n{macroc|ode}.%<*|
|00005730| 70 72 6f 67 72 61 6d 3e | 0a 5c 63 61 74 63 6f 64 |program>|.\catcod|
|00005740| 65 60 5c 40 3d 31 31 0a | 25 20 20 20 20 5c 65 6e |e`\@=11.|%    \en|
|00005750| 64 7b 6d 61 63 72 6f 63 | 6f 64 65 7d 0a 25 0a 25 |d{macroc|ode}.%.%|
|00005760| 20 20 20 20 57 68 65 6e | 20 77 65 20 77 61 6e 74 |    When| we want|
|00005770| 20 74 6f 20 77 72 69 74 | 65 20 6d 75 6c 74 69 70 | to writ|e multip|
|00005780| 6c 65 20 6c 69 6e 65 73 | 20 74 6f 20 74 68 65 20 |le lines| to the |
|00005790| 74 65 72 6d 69 6e 61 6c | 20 77 69 74 68 20 6f 6e |terminal| with on|
|000057a0| 65 0a 25 20 20 20 20 73 | 74 61 74 65 6d 65 6e 74 |e.%    s|tatement|
|000057b0| 2c 20 77 65 20 6e 65 65 | 64 20 61 20 63 68 61 72 |, we nee|d a char|
|000057c0| 61 63 74 65 72 20 74 68 | 61 74 20 74 65 6c 6c 73 |acter th|at tells|
|000057d0| 20 5c 54 65 58 5c 20 74 | 6f 20 62 72 65 61 6b 20 | \TeX\ t|o break |
|000057e0| 74 68 65 20 6c 69 6e 65 | 73 2e 0a 25 20 20 20 20 |the line|s..%    |
|000057f0| 57 65 20 75 73 65 20 5c | 76 65 72 62 3d 5e 5e 4a |We use \|verb=^^J|
|00005800| 3d 20 66 6f 72 20 74 68 | 69 73 20 70 75 72 70 6f |= for th|is purpo|
|00005810| 73 65 2e 0a 25 20 20 20 | 20 5c 62 65 67 69 6e 7b |se..%   | \begin{|
|00005820| 6d 61 63 72 6f 63 6f 64 | 65 7d 0a 5c 6e 65 77 6c |macrocod|e}.\newl|
|00005830| 69 6e 65 63 68 61 72 3d | 60 5c 5e 5e 4a 0a 25 20 |inechar=|`\^^J.% |
|00005840| 20 20 20 5c 65 6e 64 7b | 6d 61 63 72 6f 63 6f 64 |   \end{|macrocod|
|00005850| 65 7d 0a 25 0a 25 20 5c | 73 75 62 73 75 62 73 65 |e}.%.% \|subsubse|
|00005860| 63 74 69 6f 6e 7b 54 6f | 6b 65 6e 20 72 65 67 69 |ction{To|ken regi|
|00005870| 73 74 65 72 73 7d 0a 25 | 20 5c 62 65 67 69 6e 7b |sters}.%| \begin{|
|00005880| 6d 61 63 72 6f 7d 7b 5c | 54 65 72 6d 69 6e 61 6c |macro}{\|Terminal|
|00005890| 53 74 72 69 6e 67 7d 0a | 25 20 5c 63 68 61 6e 67 |String}.|% \chang|
|000058a0| 65 73 7b 32 2e 30 6d 7d | 7b 31 39 39 32 2f 30 34 |es{2.0m}|{1992/04|
|000058b0| 2f 32 32 7d 7b 52 65 6e | 61 6d 65 64 20 66 72 6f |/22}{Ren|amed fro|
|000058c0| 6d 20 5c 74 65 78 74 74 | 74 7b 5c 62 73 6c 20 62 |m \textt|t{\bsl b|
|000058d0| 6f 6f 6c 54 6f 6b 73 7d | 7d 0a 25 20 20 20 20 41 |oolToks}|}.%    A|
|000058e0| 20 74 6f 6b 65 6e 20 72 | 65 67 69 73 74 65 72 20 | token r|egister |
|000058f0| 69 73 20 61 6c 6c 6f 63 | 61 74 65 64 20 74 68 61 |is alloc|ated tha|
|00005900| 74 20 77 69 6c 6c 20 62 | 65 20 75 73 65 64 20 74 |t will b|e used t|
|00005910| 6f 20 61 63 63 75 6d 75 | 6c 61 74 65 0a 25 20 20 |o accumu|late.%  |
|00005920| 20 20 74 68 65 20 74 6f | 6b 65 6e 73 20 74 68 61 |  the to|kens tha|
|00005930| 74 20 6d 61 6b 65 20 75 | 70 20 61 20 5c 6d 65 74 |t make u|p a \met|
|00005940| 61 7b 54 65 72 6d 69 6e | 61 6c 7d 20 69 6e 20 74 |a{Termin|al} in t|
|00005950| 68 65 20 70 72 6f 63 65 | 73 73 0a 25 20 20 20 20 |he proce|ss.%    |
|00005960| 6f 66 20 73 63 61 6e 6e | 69 6e 67 20 67 75 61 72 |of scann|ing guar|
|00005970| 64 73 2e 0a 25 20 20 20 | 20 5c 62 65 67 69 6e 7b |ds..%   | \begin{|
|00005980| 6d 61 63 72 6f 63 6f 64 | 65 7d 0a 5c 6e 65 77 74 |macrocod|e}.\newt|
|00005990| 6f 6b 73 5c 54 65 72 6d | 69 6e 61 6c 53 74 72 69 |oks\Term|inalStri|
|000059a0| 6e 67 0a 25 20 20 20 20 | 5c 65 6e 64 7b 6d 61 63 |ng.%    |\end{mac|
|000059b0| 72 6f 63 6f 64 65 7d 0a | 25 20 5c 65 6e 64 7b 6d |rocode}.|% \end{m|
|000059c0| 61 63 72 6f 7d 0a 25 0a | 25 20 5c 73 75 62 73 75 |acro}.%.|% \subsu|
|000059d0| 62 73 65 63 74 69 6f 6e | 7b 53 77 69 74 63 68 65 |bsection|{Switche|
|000059e0| 73 7d 0a 25 20 5c 62 65 | 67 69 6e 7b 6d 61 63 72 |s}.% \be|gin{macr|
|000059f0| 6f 7d 7b 5c 69 66 4f 66 | 66 7d 0a 25 20 5c 62 65 |o}{\ifOf|f}.% \be|
|00005a00| 67 69 6e 7b 6d 61 63 72 | 6f 7d 7b 5c 69 66 47 65 |gin{macr|o}{\ifGe|
|00005a10| 6e 65 72 61 74 65 7d 0a | 25 20 20 20 20 54 68 65 |nerate}.|%    The|
|00005a20| 20 73 77 69 74 63 68 20 | 5c 76 65 72 62 3d 5c 69 | switch |\verb=\i|
|00005a30| 66 4f 66 66 3d 20 77 69 | 6c 6c 20 62 65 20 75 73 |fOff= wi|ll be us|
|00005a40| 65 64 20 74 6f 20 73 69 | 67 6e 61 6c 20 69 66 20 |ed to si|gnal if |
|00005a50| 63 6f 64 65 20 6c 69 6e | 65 73 0a 25 20 20 20 20 |code lin|es.%    |
|00005a60| 68 61 76 65 20 74 6f 20 | 62 65 20 69 6e 63 6c 75 |have to |be inclu|
|00005a70| 64 65 64 20 69 6e 20 74 | 68 65 20 6f 75 74 70 75 |ded in t|he outpu|
|00005a80| 74 2e 20 20 54 68 65 20 | 70 72 6f 67 72 61 6d 20 |t.  The |program |
|00005a90| 77 69 6c 6c 20 63 68 65 | 63 6b 20 69 66 20 61 0a |will che|ck if a.|
|00005aa0| 25 20 20 20 20 66 69 6c | 65 20 6f 66 20 74 68 65 |%    fil|e of the|
|00005ab0| 20 73 61 6d 65 20 6e 61 | 6d 65 20 61 73 20 74 68 | same na|me as th|
|00005ac0| 65 20 66 69 6c 65 20 69 | 74 20 77 6f 75 6c 64 20 |e file i|t would |
|00005ad0| 62 65 20 63 72 65 61 74 | 69 6e 67 20 61 6c 72 65 |be creat|ing alre|
|00005ae0| 61 64 79 0a 25 20 20 20 | 20 65 78 69 73 74 73 2e |ady.%   | exists.|
|00005af0| 20 54 68 65 20 73 77 69 | 74 63 68 20 5c 76 65 72 | The swi|tch \ver|
|00005b00| 62 3d 5c 69 66 47 65 6e | 65 72 61 74 65 3d 20 69 |b=\ifGen|erate= i|
|00005b10| 73 20 75 73 65 64 20 74 | 6f 20 69 6e 64 69 63 61 |s used t|o indica|
|00005b20| 74 65 20 69 66 20 74 68 | 65 0a 25 20 20 20 20 73 |te if th|e.%    s|
|00005b30| 74 72 69 70 70 65 64 20 | 66 69 6c 65 20 68 61 73 |tripped |file has|
|00005b40| 20 74 6f 20 62 65 20 67 | 65 6e 65 72 61 74 65 64 | to be g|enerated|
|00005b50| 2e 0a 25 20 20 20 20 5c | 62 65 67 69 6e 7b 6d 61 |..%    \|begin{ma|
|00005b60| 63 72 6f 63 6f 64 65 7d | 0a 5c 6e 65 77 69 66 5c |crocode}|.\newif\|
|00005b70| 69 66 4f 66 66 0a 5c 6e | 65 77 69 66 5c 69 66 47 |ifOff.\n|ewif\ifG|
|00005b80| 65 6e 65 72 61 74 65 0a | 25 20 20 20 20 5c 65 6e |enerate.|%    \en|
|00005b90| 64 7b 6d 61 63 72 6f 63 | 6f 64 65 7d 0a 25 20 5c |d{macroc|ode}.% \|
|00005ba0| 65 6e 64 7b 6d 61 63 72 | 6f 7d 0a 25 20 5c 65 6e |end{macr|o}.% \en|
|00005bb0| 64 7b 6d 61 63 72 6f 7d | 0a 25 0a 25 20 5c 62 65 |d{macro}|.%.% \be|
|00005bc0| 67 69 6e 7b 6d 61 63 72 | 6f 7d 7b 5c 69 66 43 6f |gin{macr|o}{\ifCo|
|00005bd0| 6e 74 69 6e 75 65 7d 0a | 25 20 20 20 20 54 68 65 |ntinue}.|%    The|
|00005be0| 20 73 77 69 74 63 68 20 | 5c 76 65 72 62 3d 5c 69 | switch |\verb=\i|
|00005bf0| 66 43 6f 6e 74 69 6e 75 | 65 3d 20 69 73 20 75 73 |fContinu|e= is us|
|00005c00| 65 64 20 69 6e 20 76 61 | 72 69 6f 75 73 20 70 6c |ed in va|rious pl|
|00005c10| 61 63 65 73 20 69 6e 20 | 74 68 65 0a 25 20 20 20 |aces in |the.%   |
|00005c20| 20 70 72 6f 67 72 61 6d | 20 74 6f 20 69 6e 64 69 | program| to indi|
|00005c30| 63 61 74 65 20 69 66 20 | 61 20 5c 76 65 72 62 3d |cate if |a \verb=|
|00005c40| 5c 6c 6f 6f 70 3d 20 68 | 61 73 20 74 6f 20 65 6e |\loop= h|as to en|
|00005c50| 64 2e 0a 25 20 20 20 20 | 5c 62 65 67 69 6e 7b 6d |d..%    |\begin{m|
|00005c60| 61 63 72 6f 63 6f 64 65 | 7d 0a 5c 6e 65 77 69 66 |acrocode|}.\newif|
|00005c70| 5c 69 66 43 6f 6e 74 69 | 6e 75 65 0a 25 20 20 20 |\ifConti|nue.%   |
|00005c80| 20 5c 65 6e 64 7b 6d 61 | 63 72 6f 63 6f 64 65 7d | \end{ma|crocode}|
|00005c90| 0a 25 20 5c 65 6e 64 7b | 6d 61 63 72 6f 7d 0a 25 |.% \end{|macro}.%|
|00005ca0| 0a 25 20 5c 62 65 67 69 | 6e 7b 6d 61 63 72 6f 7d |.% \begi|n{macro}|
|00005cb0| 7b 5c 69 66 54 65 72 6d | 69 6e 61 6c 7d 0a 25 20 |{\ifTerm|inal}.% |
|00005cc0| 20 20 20 54 68 65 20 6d | 61 63 72 6f 73 20 74 68 |   The m|acros th|
|00005cd0| 61 74 20 70 61 72 73 65 | 20 74 68 65 20 62 6f 6f |at parse| the boo|
|00005ce0| 6c 65 61 6e 20 65 78 70 | 72 65 73 73 69 6f 6e 20 |lean exp|ression |
|00005cf0| 69 6e 20 74 68 65 20 67 | 75 61 72 64 73 20 6e 65 |in the g|uards ne|
|00005d00| 65 64 0a 25 20 20 20 20 | 61 20 73 77 69 74 63 68 |ed.%    |a switch|
|00005d10| 20 74 6f 20 69 6e 64 69 | 63 61 74 65 20 69 66 20 | to indi|cate if |
|00005d20| 61 20 5c 6d 65 74 61 7b | 54 65 72 6d 69 6e 61 6c |a \meta{|Terminal|
|00005d30| 7d 20 68 61 73 20 62 65 | 65 6e 20 66 6f 75 6e 64 |} has be|en found|
|00005d40| 2e 0a 25 20 5c 63 68 61 | 6e 67 65 73 7b 32 2e 30 |..% \cha|nges{2.0|
|00005d50| 6c 7d 7b 31 39 39 32 2f | 30 34 2f 31 37 7d 7b 52 |l}{1992/|04/17}{R|
|00005d60| 65 6e 61 6d 65 64 20 66 | 72 6f 6d 20 5c 74 65 78 |enamed f|rom \tex|
|00005d70| 74 74 74 7b 5c 62 73 6c | 20 69 66 4e 61 6d 65 7d |ttt{\bsl| ifName}|
|00005d80| 2e 7d 0a 25 20 20 20 20 | 5c 62 65 67 69 6e 7b 6d |.}.%    |\begin{m|
|00005d90| 61 63 72 6f 63 6f 64 65 | 7d 0a 5c 6e 65 77 69 66 |acrocode|}.\newif|
|00005da0| 5c 69 66 54 65 72 6d 69 | 6e 61 6c 0a 25 20 20 20 |\ifTermi|nal.%   |
|00005db0| 20 5c 65 6e 64 7b 6d 61 | 63 72 6f 63 6f 64 65 7d | \end{ma|crocode}|
|00005dc0| 0a 25 20 5c 65 6e 64 7b | 6d 61 63 72 6f 7d 0a 25 |.% \end{|macro}.%|
|00005dd0| 0a 25 20 5c 62 65 67 69 | 6e 7b 6d 61 63 72 6f 7d |.% \begi|n{macro}|
|00005de0| 7b 5c 69 66 46 6f 72 6c | 69 73 74 7d 0a 25 20 5c |{\ifForl|ist}.% \|
|00005df0| 63 68 61 6e 67 65 73 7b | 32 2e 30 67 7d 7b 31 39 |changes{|2.0g}{19|
|00005e00| 39 31 2f 30 36 2f 30 35 | 7d 7b 4d 61 63 72 6f 20 |91/06/05|}{Macro |
|00005e10| 61 64 64 65 64 2e 7d 0a | 25 20 20 20 20 54 68 65 |added.}.|%    The|
|00005e20| 20 70 72 6f 67 72 61 6d | 20 63 6f 6e 74 61 69 6e | program| contain|
|00005e30| 73 20 61 6e 20 69 6d 70 | 6c 65 6d 65 6e 74 61 74 |s an imp|lementat|
|00005e40| 69 6f 6e 20 6f 66 20 61 | 20 66 6f 72 2d 6c 6f 6f |ion of a| for-loo|
|00005e50| 70 2c 20 62 61 73 65 64 | 20 6f 6e 0a 25 20 20 20 |p, based| on.%   |
|00005e60| 20 70 6c 61 69 6e 20 5c | 54 65 58 7b 7d 27 73 20 | plain \|TeX{}'s |
|00005e70| 5c 76 65 72 62 3d 5c 6c | 6f 6f 70 3d 20 6d 61 63 |\verb=\l|oop= mac|
|00005e80| 72 6f 73 2e 20 54 68 65 | 20 69 6d 70 6c 65 6d 65 |ros. The| impleme|
|00005e90| 6e 74 61 74 69 6f 6e 20 | 6e 65 65 64 73 20 61 0a |ntation |needs a.|
|00005ea0| 25 20 20 20 20 73 77 69 | 74 63 68 20 74 6f 20 74 |%    swi|tch to t|
|00005eb0| 65 72 6d 69 6e 61 74 65 | 20 74 68 65 20 6c 6f 6f |erminate| the loo|
|00005ec0| 70 2e 0a 25 20 20 20 20 | 5c 62 65 67 69 6e 7b 6d |p..%    |\begin{m|
|00005ed0| 61 63 72 6f 63 6f 64 65 | 7d 0a 5c 6e 65 77 69 66 |acrocode|}.\newif|
|00005ee0| 5c 69 66 46 6f 72 6c 69 | 73 74 0a 25 20 20 20 20 |\ifForli|st.%    |
|00005ef0| 5c 65 6e 64 7b 6d 61 63 | 72 6f 63 6f 64 65 7d 0a |\end{mac|rocode}.|
|00005f00| 25 20 5c 65 6e 64 7b 6d | 61 63 72 6f 7d 0a 25 0a |% \end{m|acro}.%.|
|00005f10| 25 20 5c 62 65 67 69 6e | 7b 6d 61 63 72 6f 7d 7b |% \begin|{macro}{|
|00005f20| 5c 69 66 44 65 66 61 75 | 6c 74 7d 0a 25 20 20 20 |\ifDefau|lt}.%   |
|00005f30| 20 54 68 65 20 73 77 69 | 74 63 68 20 5c 76 65 72 | The swi|tch \ver|
|00005f40| 62 3d 5c 69 66 44 65 66 | 61 75 6c 74 3d 20 69 73 |b=\ifDef|ault= is|
|00005f50| 20 75 73 65 64 20 74 6f | 20 69 6e 64 69 63 61 74 | used to| indicat|
|00005f60| 65 20 77 68 65 74 68 65 | 72 20 74 68 65 0a 25 20 |e whethe|r the.% |
|00005f70| 20 20 20 64 65 66 61 75 | 6c 74 20 62 61 74 63 68 |   defau|lt batch|
|00005f80| 20 66 69 6c 65 20 68 61 | 73 20 74 6f 20 62 65 20 | file ha|s to be |
|00005f90| 75 73 65 64 2e 0a 25 20 | 5c 63 68 61 6e 67 65 73 |used..% |\changes|
|00005fa0| 7b 32 2e 30 66 7d 7b 31 | 39 39 31 2f 30 36 2f 30 |{2.0f}{1|991/06/0|
|00005fb0| 34 7d 7b 4d 61 63 72 6f | 20 61 64 64 65 64 2e 7d |4}{Macro| added.}|
|00005fc0| 20 0a 25 20 20 20 20 5c | 62 65 67 69 6e 7b 6d 61 | .%    \|begin{ma|
|00005fd0| 63 72 6f 63 6f 64 65 7d | 0a 5c 6e 65 77 69 66 5c |crocode}|.\newif\|
|00005fe0| 69 66 44 65 66 61 75 6c | 74 0a 25 20 20 20 20 5c |ifDefaul|t.%    \|
|00005ff0| 65 6e 64 7b 6d 61 63 72 | 6f 63 6f 64 65 7d 0a 25 |end{macr|ocode}.%|
|00006000| 20 5c 65 6e 64 7b 6d 61 | 63 72 6f 7d 0a 25 0a 25 | \end{ma|cro}.%.%|
|00006010| 20 5c 62 65 67 69 6e 7b | 6d 61 63 72 6f 7d 7b 5c | \begin{|macro}{\|
|00006020| 69 66 4d 6f 72 65 46 69 | 6c 65 73 7d 0a 25 20 20 |ifMoreFi|les}.%  |
|00006030| 20 20 54 68 65 20 73 77 | 69 74 63 68 20 5c 76 65 |  The sw|itch \ve|
|00006040| 72 62 3d 5c 69 66 4d 6f | 72 65 46 69 6c 65 73 3d |rb=\ifMo|reFiles=|
|00006050| 20 69 73 20 75 73 65 64 | 20 74 6f 20 64 65 63 69 | is used| to deci|
|00006060| 64 65 20 69 66 20 74 68 | 65 20 75 73 65 72 0a 25 |de if th|e user.%|
|00006070| 20 20 20 20 77 61 6e 74 | 73 20 6d 6f 72 65 20 66 |    want|s more f|
|00006080| 69 6c 65 73 20 74 6f 20 | 62 65 20 70 72 6f 63 65 |iles to |be proce|
|00006090| 73 73 65 64 2e 20 49 74 | 20 69 73 20 75 73 65 64 |ssed. It| is used|
|000060a0| 20 6f 6e 6c 79 20 69 6e | 20 69 6e 74 65 72 61 63 | only in| interac|
|000060b0| 74 69 76 65 0a 25 20 20 | 20 20 6d 6f 64 65 3b 20 |tive.%  |  mode; |
|000060c0| 69 6e 69 74 69 61 6c 6c | 79 20 69 74 20 65 76 61 |initiall|y it eva|
|000060d0| 6c 75 61 74 65 73 20 74 | 6f 20 5c 6d 65 74 61 7b |luates t|o \meta{|
|000060e0| 74 72 75 65 7d 2e 0a 25 | 20 5c 63 68 61 6e 67 65 |true}..%| \change|
|000060f0| 73 7b 32 2e 30 68 7d 7b | 31 39 39 31 2f 30 36 2f |s{2.0h}{|1991/06/|
|00006100| 31 39 7d 7b 4d 61 63 72 | 6f 20 61 64 64 65 64 2e |19}{Macr|o added.|
|00006110| 7d 0a 25 20 20 20 20 5c | 62 65 67 69 6e 7b 6d 61 |}.%    \|begin{ma|
|00006120| 63 72 6f 63 6f 64 65 7d | 0a 5c 6e 65 77 69 66 5c |crocode}|.\newif\|
|00006130| 69 66 4d 6f 72 65 46 69 | 6c 65 73 20 5c 4d 6f 72 |ifMoreFi|les \Mor|
|00006140| 65 46 69 6c 65 73 74 72 | 75 65 0a 25 20 20 20 20 |eFilestr|ue.%    |
|00006150| 5c 65 6e 64 7b 6d 61 63 | 72 6f 63 6f 64 65 7d 0a |\end{mac|rocode}.|
|00006160| 25 20 5c 65 6e 64 7b 6d | 61 63 72 6f 7d 0a 25 0a |% \end{m|acro}.%.|
|00006170| 25 20 5c 73 75 62 73 75 | 62 73 65 63 74 69 6f 6e |% \subsu|bsection|
|00006180| 7b 43 6f 75 6e 74 20 72 | 65 67 69 73 74 65 72 73 |{Count r|egisters|
|00006190| 7d 0a 25 20 5c 62 65 67 | 69 6e 7b 6d 61 63 72 6f |}.% \beg|in{macro|
|000061a0| 7d 7b 5c 62 6c 6f 63 6b | 4c 65 76 65 6c 7d 0a 25 |}{\block|Level}.%|
|000061b0| 20 20 20 20 4f 70 74 69 | 6f 6e 61 6c 6c 79 20 69 |    Opti|onally i|
|000061c0| 6e 63 6c 75 64 65 64 20 | 62 6c 6f 63 6b 73 20 6f |ncluded |blocks o|
|000061d0| 66 20 63 6f 64 65 20 63 | 61 6e 20 62 65 20 6e 65 |f code c|an be ne|
|000061e0| 73 74 65 64 2e 20 54 68 | 65 20 63 6f 75 6e 74 65 |sted. Th|e counte|
|000061f0| 72 0a 25 20 20 20 20 5c | 76 65 72 62 3d 5c 62 6c |r.%    \|verb=\bl|
|00006200| 6f 63 6b 4c 65 76 65 6c | 3d 20 77 69 6c 6c 20 62 |ockLevel|= will b|
|00006210| 65 20 75 73 65 64 20 74 | 6f 20 6b 65 65 70 20 74 |e used t|o keep t|
|00006220| 72 61 63 6b 20 6f 66 20 | 74 68 65 20 6c 65 76 65 |rack of |the leve|
|00006230| 6c 20 6f 66 0a 25 20 20 | 20 20 6e 65 73 74 69 6e |l of.%  |  nestin|
|00006240| 67 2e 20 20 49 74 73 20 | 69 6e 69 74 69 61 6c 20 |g.  Its |initial |
|00006250| 76 61 6c 75 65 20 69 73 | 20 7a 65 72 6f 2e 0a 25 |value is| zero..%|
|00006260| 20 20 20 20 5c 62 65 67 | 69 6e 7b 6d 61 63 72 6f |    \beg|in{macro|
|00006270| 63 6f 64 65 7d 0a 5c 6e | 65 77 63 6f 75 6e 74 5c |code}.\n|ewcount\|
|00006280| 62 6c 6f 63 6b 4c 65 76 | 65 6c 20 5c 62 6c 6f 63 |blockLev|el \bloc|
|00006290| 6b 4c 65 76 65 6c 5c 7a | 40 0a 25 20 20 20 20 5c |kLevel\z|@.%    \|
|000062a0| 65 6e 64 7b 6d 61 63 72 | 6f 63 6f 64 65 7d 0a 25 |end{macr|ocode}.%|
|000062b0| 20 5c 65 6e 64 7b 6d 61 | 63 72 6f 7d 0a 25 0a 25 | \end{ma|cro}.%.%|
|000062c0| 20 5c 62 65 67 69 6e 7b | 6d 61 63 72 6f 7d 7b 5c | \begin{|macro}{\|
|000062d0| 6f 66 66 4c 65 76 65 6c | 7d 0a 25 20 20 20 20 54 |offLevel|}.%    T|
|000062e0| 68 65 20 63 6f 75 6e 74 | 20 72 65 67 69 73 74 65 |he count| registe|
|000062f0| 72 20 20 5c 76 65 72 62 | 3d 5c 6f 66 66 4c 65 76 |r  \verb|=\offLev|
|00006300| 65 6c 3d 20 69 73 20 75 | 73 65 64 20 74 6f 0a 25 |el= is u|sed to.%|
|00006310| 20 20 20 20 63 6f 75 6e | 74 20 74 68 65 20 6e 75 |    coun|t the nu|
|00006320| 6d 62 65 72 20 6f 66 20 | 6c 65 76 65 6c 73 20 73 |mber of |levels s|
|00006330| 69 6e 63 65 20 74 68 65 | 20 66 69 72 73 74 20 62 |ince the| first b|
|00006340| 6c 6f 63 6b 20 77 68 6f | 73 65 20 67 75 61 72 64 |lock who|se guard|
|00006350| 0a 25 20 20 20 20 65 76 | 61 6c 75 61 74 65 64 20 |.%    ev|aluated |
|00006360| 74 6f 20 66 61 6c 73 65 | 2e 20 20 57 68 65 6e 20 |to false|.  When |
|00006370| 74 68 69 73 20 6e 75 6d | 62 65 72 20 72 65 61 63 |this num|ber reac|
|00006380| 68 65 73 20 7a 65 72 6f | 20 61 67 61 69 6e 20 77 |hes zero| again w|
|00006390| 65 20 73 65 74 20 74 68 | 65 0a 25 20 20 20 20 73 |e set th|e.%    s|
|000063a0| 77 69 74 63 68 20 5c 76 | 65 72 62 3d 5c 69 66 4f |witch \v|erb=\ifO|
|000063b0| 66 66 3d 20 74 6f 20 66 | 61 6c 73 65 20 61 67 61 |ff= to f|alse aga|
|000063c0| 69 6e 2e 0a 25 20 20 20 | 20 5c 62 65 67 69 6e 7b |in..%   | \begin{|
|000063d0| 6d 61 63 72 6f 63 6f 64 | 65 7d 0a 5c 6e 65 77 63 |macrocod|e}.\newc|
|000063e0| 6f 75 6e 74 5c 6f 66 66 | 4c 65 76 65 6c 20 5c 6f |ount\off|Level \o|
|000063f0| 66 66 4c 65 76 65 6c 20 | 5c 7a 40 0a 25 20 20 20 |ffLevel |\z@.%   |
+--------+-------------------------+-------------------------+--------+--------+