home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / unix / volume13 / m4 / part02 < prev    next >
SHell self-extracting ARchive  |  1988-02-27  |  26.4 KB

open in: MacOS 8.1     |     Win98     |     DOS

browse contents    |     view JSON data     |     view as text


This file was processed as: SHell self-extracting ARchive (archive/shar).

ConfidenceProgramDetectionMatch TypeSupport
100% dexvert Newsgroup Content (archive/news) magic Supported
100% dexvert SHell self-extracting ARchive (archive/shar) magic Supported
100% dexvert Internet Message Format (text/imf) magic Supported
1% dexvert Text File (text/txt) fallback Supported
100% file news or mail, ASCII text default
100% checkBytes Printable ASCII default
100% perlTextCheck Likely Text (Perl) default
100% siegfried fmt/329 Shell Archive Format default
100% detectItEasy Format: plain text[LF] default (weak)
100% xdgMime message/rfc822 default



hex view
+--------+-------------------------+-------------------------+--------+--------+
|00000000| 53 75 62 6a 65 63 74 3a | 20 20 76 31 33 69 30 33 |Subject:| v13i03|
|00000010| 39 3a 20 20 50 75 62 6c | 69 63 20 64 6f 6d 61 69 |9: Publ|ic domai|
|00000020| 6e 64 20 4d 34 20 6d 61 | 63 72 6f 20 70 72 6f 63 |nd M4 ma|cro proc|
|00000030| 65 73 73 6f 72 2c 20 50 | 61 72 74 30 32 2f 30 32 |essor, P|art02/02|
|00000040| 0a 4e 65 77 73 67 72 6f | 75 70 73 3a 20 63 6f 6d |.Newsgro|ups: com|
|00000050| 70 2e 73 6f 75 72 63 65 | 73 2e 75 6e 69 78 0a 53 |p.source|s.unix.S|
|00000060| 65 6e 64 65 72 3a 20 73 | 6f 75 72 63 65 73 0a 41 |ender: s|ources.A|
|00000070| 70 70 72 6f 76 65 64 3a | 20 72 73 61 6c 7a 40 75 |pproved:| rsalz@u|
|00000080| 75 6e 65 74 2e 55 55 2e | 4e 45 54 0a 0a 53 75 62 |unet.UU.|NET..Sub|
|00000090| 6d 69 74 74 65 64 2d 62 | 79 3a 20 4f 7a 61 6e 20 |mitted-b|y: Ozan |
|000000a0| 59 69 67 69 74 20 3c 79 | 75 6e 65 78 75 73 21 6f |Yigit <y|unexus!o|
|000000b0| 7a 3e 0a 50 6f 73 74 69 | 6e 67 2d 6e 75 6d 62 65 |z>.Posti|ng-numbe|
|000000c0| 72 3a 20 56 6f 6c 75 6d | 65 20 31 33 2c 20 49 73 |r: Volum|e 13, Is|
|000000d0| 73 75 65 20 33 39 0a 41 | 72 63 68 69 76 65 2d 6e |sue 39.A|rchive-n|
|000000e0| 61 6d 65 3a 20 6d 34 2f | 70 61 72 74 30 32 0a 0a |ame: m4/|part02..|
|000000f0| 23 21 20 2f 62 69 6e 2f | 73 68 0a 23 20 54 68 69 |#! /bin/|sh.# Thi|
|00000100| 73 20 69 73 20 61 20 73 | 68 65 6c 6c 20 61 72 63 |s is a s|hell arc|
|00000110| 68 69 76 65 2c 20 6d 65 | 61 6e 69 6e 67 3a 0a 23 |hive, me|aning:.#|
|00000120| 20 31 2e 20 52 65 6d 6f | 76 65 20 65 76 65 72 79 | 1. Remo|ve every|
|00000130| 74 68 69 6e 67 20 61 62 | 6f 76 65 20 74 68 65 20 |thing ab|ove the |
|00000140| 23 21 20 2f 62 69 6e 2f | 73 68 20 6c 69 6e 65 2e |#! /bin/|sh line.|
|00000150| 0a 23 20 32 2e 20 53 61 | 76 65 20 74 68 65 20 72 |.# 2. Sa|ve the r|
|00000160| 65 73 75 6c 74 69 6e 67 | 20 74 65 78 74 20 69 6e |esulting| text in|
|00000170| 20 61 20 66 69 6c 65 2e | 0a 23 20 33 2e 20 45 78 | a file.|.# 3. Ex|
|00000180| 65 63 75 74 65 20 74 68 | 65 20 66 69 6c 65 20 77 |ecute th|e file w|
|00000190| 69 74 68 20 2f 62 69 6e | 2f 73 68 20 28 6e 6f 74 |ith /bin|/sh (not|
|000001a0| 20 63 73 68 29 20 74 6f | 20 63 72 65 61 74 65 20 | csh) to| create |
|000001b0| 74 68 65 20 66 69 6c 65 | 73 3a 0a 23 09 61 63 6b |the file|s:.#.ack|
|000001c0| 2e 6d 34 0a 23 09 68 61 | 6e 6f 69 2e 6d 34 0a 23 |.m4.#.ha|noi.m4.#|
|000001d0| 09 68 61 73 68 2e 6d 34 | 0a 23 09 73 71 72 6f 6f |.hash.m4|.#.sqroo|
|000001e0| 74 2e 6d 34 0a 23 09 73 | 74 72 69 6e 67 2e 6d 34 |t.m4.#.s|tring.m4|
|000001f0| 0a 23 09 74 65 73 74 2e | 6d 34 0a 23 09 52 45 41 |.#.test.|m4.#.REA|
|00000200| 44 4d 45 0a 23 09 4d 41 | 4e 49 46 45 53 54 0a 23 |DME.#.MA|NIFEST.#|
|00000210| 09 6d 34 2e 31 0a 65 78 | 70 6f 72 74 20 50 41 54 |.m4.1.ex|port PAT|
|00000220| 48 3b 20 50 41 54 48 3d | 2f 62 69 6e 3a 24 50 41 |H; PATH=|/bin:$PA|
|00000230| 54 48 0a 65 63 68 6f 20 | 73 68 61 72 3a 20 65 78 |TH.echo |shar: ex|
|00000240| 74 72 61 63 74 69 6e 67 | 20 22 27 61 63 6b 2e 6d |tracting| "'ack.m|
|00000250| 34 27 22 20 27 28 31 32 | 31 20 63 68 61 72 61 63 |4'" '(12|1 charac|
|00000260| 74 65 72 73 29 27 0a 69 | 66 20 74 65 73 74 20 2d |ters)'.i|f test -|
|00000270| 66 20 27 61 63 6b 2e 6d | 34 27 0a 74 68 65 6e 0a |f 'ack.m|4'.then.|
|00000280| 09 65 63 68 6f 20 73 68 | 61 72 3a 20 77 69 6c 6c |.echo sh|ar: will|
|00000290| 20 6e 6f 74 20 6f 76 65 | 72 2d 77 72 69 74 65 20 | not ove|r-write |
|000002a0| 65 78 69 73 74 69 6e 67 | 20 66 69 6c 65 20 22 27 |existing| file "'|
|000002b0| 61 63 6b 2e 6d 34 27 22 | 0a 65 6c 73 65 0a 73 65 |ack.m4'"|.else.se|
|000002c0| 64 20 27 73 2f 5e 09 58 | 2f 2f 27 20 3c 3c 20 5c |d 's/^.X|//' << \|
|000002d0| 53 48 41 52 5f 45 4f 46 | 20 3e 20 27 61 63 6b 2e |SHAR_EOF| > 'ack.|
|000002e0| 6d 34 27 0a 09 58 64 65 | 66 69 6e 65 28 44 45 43 |m4'..Xde|fine(DEC|
|000002f0| 52 2c 60 65 76 61 6c 28 | 24 31 2d 31 29 27 29 0a |R,`eval(|$1-1)').|
|00000300| 09 58 64 65 66 69 6e 65 | 28 61 63 6b 2c 20 60 69 |.Xdefine|(ack, `i|
|00000310| 66 65 6c 73 65 28 24 31 | 2c 30 2c 69 6e 63 72 28 |felse($1|,0,incr(|
|00000320| 24 32 29 2c 24 32 2c 30 | 2c 60 61 63 6b 28 44 45 |$2),$2,0|,`ack(DE|
|00000330| 43 52 28 24 31 29 2c 31 | 29 27 2c 0a 09 58 60 61 |CR($1),1|)',..X`a|
|00000340| 63 6b 28 44 45 43 52 28 | 24 31 29 2c 20 61 63 6b |ck(DECR(|$1), ack|
|00000350| 28 24 31 2c 44 45 43 52 | 28 24 32 29 29 29 27 29 |($1,DECR|($2)))')|
|00000360| 27 29 0a 53 48 41 52 5f | 45 4f 46 0a 69 66 20 74 |').SHAR_|EOF.if t|
|00000370| 65 73 74 20 31 32 31 20 | 2d 6e 65 20 22 60 77 63 |est 121 |-ne "`wc|
|00000380| 20 2d 63 20 3c 20 27 61 | 63 6b 2e 6d 34 27 60 22 | -c < 'a|ck.m4'`"|
|00000390| 0a 74 68 65 6e 0a 09 65 | 63 68 6f 20 73 68 61 72 |.then..e|cho shar|
|000003a0| 3a 20 65 72 72 6f 72 20 | 74 72 61 6e 73 6d 69 74 |: error |transmit|
|000003b0| 74 69 6e 67 20 22 27 61 | 63 6b 2e 6d 34 27 22 20 |ting "'a|ck.m4'" |
|000003c0| 27 28 73 68 6f 75 6c 64 | 20 68 61 76 65 20 62 65 |'(should| have be|
|000003d0| 65 6e 20 31 32 31 20 63 | 68 61 72 61 63 74 65 72 |en 121 c|haracter|
|000003e0| 73 29 27 0a 66 69 0a 66 | 69 20 23 20 65 6e 64 20 |s)'.fi.f|i # end |
|000003f0| 6f 66 20 6f 76 65 72 77 | 72 69 74 69 6e 67 20 63 |of overw|riting c|
|00000400| 68 65 63 6b 0a 65 63 68 | 6f 20 73 68 61 72 3a 20 |heck.ech|o shar: |
|00000410| 65 78 74 72 61 63 74 69 | 6e 67 20 22 27 68 61 6e |extracti|ng "'han|
|00000420| 6f 69 2e 6d 34 27 22 20 | 27 28 32 31 35 20 63 68 |oi.m4'" |'(215 ch|
|00000430| 61 72 61 63 74 65 72 73 | 29 27 0a 69 66 20 74 65 |aracters|)'.if te|
|00000440| 73 74 20 2d 66 20 27 68 | 61 6e 6f 69 2e 6d 34 27 |st -f 'h|anoi.m4'|
|00000450| 0a 74 68 65 6e 0a 09 65 | 63 68 6f 20 73 68 61 72 |.then..e|cho shar|
|00000460| 3a 20 77 69 6c 6c 20 6e | 6f 74 20 6f 76 65 72 2d |: will n|ot over-|
|00000470| 77 72 69 74 65 20 65 78 | 69 73 74 69 6e 67 20 66 |write ex|isting f|
|00000480| 69 6c 65 20 22 27 68 61 | 6e 6f 69 2e 6d 34 27 22 |ile "'ha|noi.m4'"|
|00000490| 0a 65 6c 73 65 0a 73 65 | 64 20 27 73 2f 5e 09 58 |.else.se|d 's/^.X|
|000004a0| 2f 2f 27 20 3c 3c 20 5c | 53 48 41 52 5f 45 4f 46 |//' << \|SHAR_EOF|
|000004b0| 20 3e 20 27 68 61 6e 6f | 69 2e 6d 34 27 0a 09 58 | > 'hano|i.m4'..X|
|000004c0| 64 65 66 69 6e 65 28 44 | 45 43 52 2c 60 65 76 61 |define(D|ECR,`eva|
|000004d0| 6c 28 24 31 2d 31 29 27 | 29 0a 09 58 64 65 66 69 |l($1-1)'|)..Xdefi|
|000004e0| 6e 65 28 68 61 6e 6f 69 | 2c 20 60 74 72 61 6e 73 |ne(hanoi|, `trans|
|000004f0| 28 41 2c 20 42 2c 20 43 | 2c 20 24 31 29 27 29 0a |(A, B, C|, $1)').|
|00000500| 09 58 0a 09 58 64 65 66 | 69 6e 65 28 6d 6f 76 65 |.X..Xdef|ine(move|
|00000510| 64 2c 60 6d 6f 76 65 20 | 64 69 73 6b 20 66 72 6f |d,`move |disk fro|
|00000520| 6d 20 24 31 20 74 6f 20 | 24 32 0a 09 58 27 29 0a |m $1 to |$2..X').|
|00000530| 09 58 0a 09 58 64 65 66 | 69 6e 65 28 74 72 61 6e |.X..Xdef|ine(tran|
|00000540| 73 2c 20 60 69 66 65 6c | 73 65 28 24 34 2c 31 2c |s, `ifel|se($4,1,|
|00000550| 60 6d 6f 76 65 64 28 24 | 31 2c 24 32 29 27 2c 0a |`moved($|1,$2)',.|
|00000560| 09 58 09 60 74 72 61 6e | 73 28 24 31 2c 24 33 2c |.X.`tran|s($1,$3,|
|00000570| 24 32 2c 44 45 43 52 28 | 24 34 29 29 6d 6f 76 65 |$2,DECR(|$4))move|
|00000580| 64 28 24 31 2c 24 32 29 | 74 72 61 6e 73 28 24 33 |d($1,$2)|trans($3|
|00000590| 2c 24 32 2c 24 31 2c 44 | 45 43 52 28 24 34 29 29 |,$2,$1,D|ECR($4))|
|000005a0| 27 29 27 29 0a 53 48 41 | 52 5f 45 4f 46 0a 69 66 |')').SHA|R_EOF.if|
|000005b0| 20 74 65 73 74 20 32 31 | 35 20 2d 6e 65 20 22 60 | test 21|5 -ne "`|
|000005c0| 77 63 20 2d 63 20 3c 20 | 27 68 61 6e 6f 69 2e 6d |wc -c < |'hanoi.m|
|000005d0| 34 27 60 22 0a 74 68 65 | 6e 0a 09 65 63 68 6f 20 |4'`".the|n..echo |
|000005e0| 73 68 61 72 3a 20 65 72 | 72 6f 72 20 74 72 61 6e |shar: er|ror tran|
|000005f0| 73 6d 69 74 74 69 6e 67 | 20 22 27 68 61 6e 6f 69 |smitting| "'hanoi|
|00000600| 2e 6d 34 27 22 20 27 28 | 73 68 6f 75 6c 64 20 68 |.m4'" '(|should h|
|00000610| 61 76 65 20 62 65 65 6e | 20 32 31 35 20 63 68 61 |ave been| 215 cha|
|00000620| 72 61 63 74 65 72 73 29 | 27 0a 66 69 0a 66 69 20 |racters)|'.fi.fi |
|00000630| 23 20 65 6e 64 20 6f 66 | 20 6f 76 65 72 77 72 69 |# end of| overwri|
|00000640| 74 69 6e 67 20 63 68 65 | 63 6b 0a 65 63 68 6f 20 |ting che|ck.echo |
|00000650| 73 68 61 72 3a 20 65 78 | 74 72 61 63 74 69 6e 67 |shar: ex|tracting|
|00000660| 20 22 27 68 61 73 68 2e | 6d 34 27 22 20 27 28 34 | "'hash.|m4'" '(4|
|00000670| 32 35 20 63 68 61 72 61 | 63 74 65 72 73 29 27 0a |25 chara|cters)'.|
|00000680| 69 66 20 74 65 73 74 20 | 2d 66 20 27 68 61 73 68 |if test |-f 'hash|
|00000690| 2e 6d 34 27 0a 74 68 65 | 6e 0a 09 65 63 68 6f 20 |.m4'.the|n..echo |
|000006a0| 73 68 61 72 3a 20 77 69 | 6c 6c 20 6e 6f 74 20 6f |shar: wi|ll not o|
|000006b0| 76 65 72 2d 77 72 69 74 | 65 20 65 78 69 73 74 69 |ver-writ|e existi|
|000006c0| 6e 67 20 66 69 6c 65 20 | 22 27 68 61 73 68 2e 6d |ng file |"'hash.m|
|000006d0| 34 27 22 0a 65 6c 73 65 | 0a 73 65 64 20 27 73 2f |4'".else|.sed 's/|
|000006e0| 5e 09 58 2f 2f 27 20 3c | 3c 20 5c 53 48 41 52 5f |^.X//' <|< \SHAR_|
|000006f0| 45 4f 46 20 3e 20 27 68 | 61 73 68 2e 6d 34 27 0a |EOF > 'h|ash.m4'.|
|00000700| 09 58 64 6e 6c 09 54 68 | 69 73 20 70 72 6f 62 61 |.Xdnl.Th|is proba|
|00000710| 62 6c 79 20 77 69 6c 6c | 20 6e 6f 74 20 72 75 6e |bly will| not run|
|00000720| 20 6f 6e 20 61 6e 79 20 | 6d 34 20 74 68 61 74 20 | on any |m4 that |
|00000730| 63 61 6e 6e 6f 74 0a 09 | 58 64 6e 6c 09 68 61 6e |cannot..|Xdnl.han|
|00000740| 64 6c 65 20 63 68 61 72 | 20 63 6f 6e 73 74 61 6e |dle char| constan|
|00000750| 74 73 20 69 6e 20 65 76 | 61 6c 2e 0a 09 58 64 6e |ts in ev|al...Xdn|
|00000760| 6c 0a 09 58 63 68 61 6e | 67 65 71 75 6f 74 65 28 |l..Xchan|gequote(|
|00000770| 3c 2c 3e 29 20 64 65 66 | 69 6e 65 28 48 41 53 48 |<,>) def|ine(HASH|
|00000780| 56 41 4c 2c 39 39 29 20 | 64 6e 6c 0a 09 58 64 65 |VAL,99) |dnl..Xde|
|00000790| 66 69 6e 65 28 68 61 73 | 68 2c 3c 65 76 61 6c 28 |fine(has|h,<eval(|
|000007a0| 73 74 72 28 73 75 62 73 | 74 72 28 24 31 2c 31 29 |str(subs|tr($1,1)|
|000007b0| 2c 30 29 25 48 41 53 48 | 56 41 4c 29 3e 29 20 64 |,0)%HASH|VAL)>) d|
|000007c0| 6e 6c 0a 09 58 64 65 66 | 69 6e 65 28 73 74 72 2c |nl..Xdef|ine(str,|
|000007d0| 0a 09 58 09 3c 69 66 65 | 6c 73 65 28 24 31 2c 22 |..X.<ife|lse($1,"|
|000007e0| 2c 24 32 2c 0a 09 58 09 | 09 3c 73 74 72 28 73 75 |,$2,..X.|.<str(su|
|000007f0| 62 73 74 72 28 3c 24 31 | 3e 2c 31 29 2c 3c 65 76 |bstr(<$1|>,1),<ev|
|00000800| 61 6c 28 24 32 2b 27 73 | 75 62 73 74 72 28 24 31 |al($2+'s|ubstr($1|
|00000810| 2c 30 2c 31 29 27 29 3e | 29 3e 29 0a 09 58 09 3e |,0,1)')>|)>)..X.>|
|00000820| 29 20 64 6e 6c 0a 09 58 | 64 65 66 69 6e 65 28 4b |) dnl..X|define(K|
|00000830| 45 59 57 4f 52 44 2c 3c | 24 31 2c 68 61 73 68 28 |EYWORD,<|$1,hash(|
|00000840| 24 31 29 2c 3e 29 20 64 | 6e 6c 0a 09 58 64 65 66 |$1),>) d|nl..Xdef|
|00000850| 69 6e 65 28 54 53 54 41 | 52 54 2c 0a 09 58 3c 73 |ine(TSTA|RT,..X<s|
|00000860| 74 72 75 63 74 20 70 72 | 65 68 61 73 68 20 7b 0a |truct pr|ehash {.|
|00000870| 09 58 09 63 68 61 72 20 | 2a 6b 65 79 77 6f 72 64 |.X.char |*keyword|
|00000880| 3b 0a 09 58 09 69 6e 74 | 20 20 20 68 61 73 68 76 |;..X.int| hashv|
|00000890| 61 6c 3b 0a 09 58 7d 20 | 6b 65 79 74 61 62 5b 5d |al;..X} |keytab[]|
|000008a0| 20 3d 20 7b 3e 29 20 64 | 6e 6c 0a 09 58 64 65 66 | = {>) d|nl..Xdef|
|000008b0| 69 6e 65 28 54 45 4e 44 | 2c 3c 09 22 22 2c 30 0a |ine(TEND|,<."",0.|
|000008c0| 09 58 7d 3b 3e 29 20 64 | 6e 6c 0a 53 48 41 52 5f |.X};>) d|nl.SHAR_|
|000008d0| 45 4f 46 0a 69 66 20 74 | 65 73 74 20 34 32 35 20 |EOF.if t|est 425 |
|000008e0| 2d 6e 65 20 22 60 77 63 | 20 2d 63 20 3c 20 27 68 |-ne "`wc| -c < 'h|
|000008f0| 61 73 68 2e 6d 34 27 60 | 22 0a 74 68 65 6e 0a 09 |ash.m4'`|".then..|
|00000900| 65 63 68 6f 20 73 68 61 | 72 3a 20 65 72 72 6f 72 |echo sha|r: error|
|00000910| 20 74 72 61 6e 73 6d 69 | 74 74 69 6e 67 20 22 27 | transmi|tting "'|
|00000920| 68 61 73 68 2e 6d 34 27 | 22 20 27 28 73 68 6f 75 |hash.m4'|" '(shou|
|00000930| 6c 64 20 68 61 76 65 20 | 62 65 65 6e 20 34 32 35 |ld have |been 425|
|00000940| 20 63 68 61 72 61 63 74 | 65 72 73 29 27 0a 66 69 | charact|ers)'.fi|
|00000950| 0a 66 69 20 23 20 65 6e | 64 20 6f 66 20 6f 76 65 |.fi # en|d of ove|
|00000960| 72 77 72 69 74 69 6e 67 | 20 63 68 65 63 6b 0a 65 |rwriting| check.e|
|00000970| 63 68 6f 20 73 68 61 72 | 3a 20 65 78 74 72 61 63 |cho shar|: extrac|
|00000980| 74 69 6e 67 20 22 27 73 | 71 72 6f 6f 74 2e 6d 34 |ting "'s|qroot.m4|
|00000990| 27 22 20 27 28 32 33 38 | 20 63 68 61 72 61 63 74 |'" '(238| charact|
|000009a0| 65 72 73 29 27 0a 69 66 | 20 74 65 73 74 20 2d 66 |ers)'.if| test -f|
|000009b0| 20 27 73 71 72 6f 6f 74 | 2e 6d 34 27 0a 74 68 65 | 'sqroot|.m4'.the|
|000009c0| 6e 0a 09 65 63 68 6f 20 | 73 68 61 72 3a 20 77 69 |n..echo |shar: wi|
|000009d0| 6c 6c 20 6e 6f 74 20 6f | 76 65 72 2d 77 72 69 74 |ll not o|ver-writ|
|000009e0| 65 20 65 78 69 73 74 69 | 6e 67 20 66 69 6c 65 20 |e existi|ng file |
|000009f0| 22 27 73 71 72 6f 6f 74 | 2e 6d 34 27 22 0a 65 6c |"'sqroot|.m4'".el|
|00000a00| 73 65 0a 73 65 64 20 27 | 73 2f 5e 09 58 2f 2f 27 |se.sed '|s/^.X//'|
|00000a10| 20 3c 3c 20 5c 53 48 41 | 52 5f 45 4f 46 20 3e 20 | << \SHA|R_EOF > |
|00000a20| 27 73 71 72 6f 6f 74 2e | 6d 34 27 0a 09 58 64 65 |'sqroot.|m4'..Xde|
|00000a30| 66 69 6e 65 28 73 71 75 | 61 72 65 5f 72 6f 6f 74 |fine(squ|are_root|
|00000a40| 2c 20 0a 09 58 09 60 69 | 66 65 6c 73 65 28 65 76 |, ..X.`i|felse(ev|
|00000a50| 61 6c 28 24 31 3c 30 29 | 2c 31 2c 6e 65 67 61 74 |al($1<0)|,1,negat|
|00000a60| 69 76 65 2d 73 71 75 61 | 72 65 2d 72 6f 6f 74 2c |ive-squa|re-root,|
|00000a70| 0a 09 58 09 09 09 20 20 | 20 20 20 60 73 71 75 61 |..X... | `squa|
|00000a80| 72 65 5f 72 6f 6f 74 5f | 61 75 78 28 24 31 2c 20 |re_root_|aux($1, |
|00000a90| 31 2c 20 65 76 61 6c 28 | 28 24 31 2b 31 29 2f 32 |1, eval(|($1+1)/2|
|00000aa0| 29 29 27 29 27 29 0a 09 | 58 64 65 66 69 6e 65 28 |))')')..|Xdefine(|
|00000ab0| 73 71 75 61 72 65 5f 72 | 6f 6f 74 5f 61 75 78 2c |square_r|oot_aux,|
|00000ac0| 0a 09 58 09 60 69 66 65 | 6c 73 65 28 24 33 2c 20 |..X.`ife|lse($3, |
|00000ad0| 24 32 2c 20 24 33 2c 0a | 09 58 09 09 24 33 2c 20 |$2, $3,.|.X..$3, |
|00000ae0| 65 76 61 6c 28 24 31 2f | 24 32 29 2c 20 24 33 2c |eval($1/|$2), $3,|
|00000af0| 0a 09 58 09 09 60 73 71 | 75 61 72 65 5f 72 6f 6f |..X..`sq|uare_roo|
|00000b00| 74 5f 61 75 78 28 24 31 | 2c 20 24 33 2c 20 65 76 |t_aux($1|, $3, ev|
|00000b10| 61 6c 28 28 24 33 2b 28 | 24 31 2f 24 33 29 29 2f |al(($3+(|$1/$3))/|
|00000b20| 32 29 29 27 29 27 29 0a | 53 48 41 52 5f 45 4f 46 |2))')').|SHAR_EOF|
|00000b30| 0a 69 66 20 74 65 73 74 | 20 32 33 38 20 2d 6e 65 |.if test| 238 -ne|
|00000b40| 20 22 60 77 63 20 2d 63 | 20 3c 20 27 73 71 72 6f | "`wc -c| < 'sqro|
|00000b50| 6f 74 2e 6d 34 27 60 22 | 0a 74 68 65 6e 0a 09 65 |ot.m4'`"|.then..e|
|00000b60| 63 68 6f 20 73 68 61 72 | 3a 20 65 72 72 6f 72 20 |cho shar|: error |
|00000b70| 74 72 61 6e 73 6d 69 74 | 74 69 6e 67 20 22 27 73 |transmit|ting "'s|
|00000b80| 71 72 6f 6f 74 2e 6d 34 | 27 22 20 27 28 73 68 6f |qroot.m4|'" '(sho|
|00000b90| 75 6c 64 20 68 61 76 65 | 20 62 65 65 6e 20 32 33 |uld have| been 23|
|00000ba0| 38 20 63 68 61 72 61 63 | 74 65 72 73 29 27 0a 66 |8 charac|ters)'.f|
|00000bb0| 69 0a 66 69 20 23 20 65 | 6e 64 20 6f 66 20 6f 76 |i.fi # e|nd of ov|
|00000bc0| 65 72 77 72 69 74 69 6e | 67 20 63 68 65 63 6b 0a |erwritin|g check.|
|00000bd0| 65 63 68 6f 20 73 68 61 | 72 3a 20 65 78 74 72 61 |echo sha|r: extra|
|00000be0| 63 74 69 6e 67 20 22 27 | 73 74 72 69 6e 67 2e 6d |cting "'|string.m|
|00000bf0| 34 27 22 20 27 28 32 30 | 34 20 63 68 61 72 61 63 |4'" '(20|4 charac|
|00000c00| 74 65 72 73 29 27 0a 69 | 66 20 74 65 73 74 20 2d |ters)'.i|f test -|
|00000c10| 66 20 27 73 74 72 69 6e | 67 2e 6d 34 27 0a 74 68 |f 'strin|g.m4'.th|
|00000c20| 65 6e 0a 09 65 63 68 6f | 20 73 68 61 72 3a 20 77 |en..echo| shar: w|
|00000c30| 69 6c 6c 20 6e 6f 74 20 | 6f 76 65 72 2d 77 72 69 |ill not |over-wri|
|00000c40| 74 65 20 65 78 69 73 74 | 69 6e 67 20 66 69 6c 65 |te exist|ing file|
|00000c50| 20 22 27 73 74 72 69 6e | 67 2e 6d 34 27 22 0a 65 | "'strin|g.m4'".e|
|00000c60| 6c 73 65 0a 73 65 64 20 | 27 73 2f 5e 09 58 2f 2f |lse.sed |'s/^.X//|
|00000c70| 27 20 3c 3c 20 5c 53 48 | 41 52 5f 45 4f 46 20 3e |' << \SH|AR_EOF >|
|00000c80| 20 27 73 74 72 69 6e 67 | 2e 6d 34 27 0a 09 58 0a | 'string|.m4'..X.|
|00000c90| 09 58 64 65 66 69 6e 65 | 28 73 74 72 69 6e 67 2c |.Xdefine|(string,|
|00000ca0| 60 69 6e 74 65 67 65 72 | 20 24 31 28 6c 65 6e 28 |`integer| $1(len(|
|00000cb0| 73 75 62 73 74 72 28 24 | 32 2c 31 29 29 29 0a 09 |substr($|2,1)))..|
|00000cc0| 58 73 74 72 28 24 31 2c | 73 75 62 73 74 72 28 24 |Xstr($1,|substr($|
|00000cd0| 32 2c 31 29 2c 30 29 0a | 09 58 64 61 74 61 20 24 |2,1),0).|.Xdata $|
|00000ce0| 31 28 6c 65 6e 28 73 75 | 62 73 74 72 28 24 32 2c |1(len(su|bstr($2,|
|00000cf0| 31 29 29 29 2f 45 4f 53 | 2f 0a 09 58 27 29 0a 09 |1)))/EOS|/..X')..|
|00000d00| 58 0a 09 58 64 65 66 69 | 6e 65 28 73 74 72 2c 60 |X..Xdefi|ne(str,`|
|00000d10| 69 66 65 6c 73 65 28 24 | 32 2c 22 2c 2c 64 61 74 |ifelse($|2,",,dat|
|00000d20| 61 20 24 31 28 69 6e 63 | 72 28 24 33 29 29 2f 60 |a $1(inc|r($3))/`|
|00000d30| 4c 45 54 27 73 75 62 73 | 74 72 28 24 32 2c 30 2c |LET'subs|tr($2,0,|
|00000d40| 31 29 2f 0a 09 58 60 73 | 74 72 28 24 31 2c 73 75 |1)/..X`s|tr($1,su|
|00000d50| 62 73 74 72 28 24 32 2c | 31 29 2c 69 6e 63 72 28 |bstr($2,|1),incr(|
|00000d60| 24 33 29 29 27 29 27 29 | 0a 53 48 41 52 5f 45 4f |$3))')')|.SHAR_EO|
|00000d70| 46 0a 69 66 20 74 65 73 | 74 20 32 30 34 20 2d 6e |F.if tes|t 204 -n|
|00000d80| 65 20 22 60 77 63 20 2d | 63 20 3c 20 27 73 74 72 |e "`wc -|c < 'str|
|00000d90| 69 6e 67 2e 6d 34 27 60 | 22 0a 74 68 65 6e 0a 09 |ing.m4'`|".then..|
|00000da0| 65 63 68 6f 20 73 68 61 | 72 3a 20 65 72 72 6f 72 |echo sha|r: error|
|00000db0| 20 74 72 61 6e 73 6d 69 | 74 74 69 6e 67 20 22 27 | transmi|tting "'|
|00000dc0| 73 74 72 69 6e 67 2e 6d | 34 27 22 20 27 28 73 68 |string.m|4'" '(sh|
|00000dd0| 6f 75 6c 64 20 68 61 76 | 65 20 62 65 65 6e 20 32 |ould hav|e been 2|
|00000de0| 30 34 20 63 68 61 72 61 | 63 74 65 72 73 29 27 0a |04 chara|cters)'.|
|00000df0| 66 69 0a 66 69 20 23 20 | 65 6e 64 20 6f 66 20 6f |fi.fi # |end of o|
|00000e00| 76 65 72 77 72 69 74 69 | 6e 67 20 63 68 65 63 6b |verwriti|ng check|
|00000e10| 0a 65 63 68 6f 20 73 68 | 61 72 3a 20 65 78 74 72 |.echo sh|ar: extr|
|00000e20| 61 63 74 69 6e 67 20 22 | 27 74 65 73 74 2e 6d 34 |acting "|'test.m4|
|00000e30| 27 22 20 27 28 37 38 37 | 33 20 63 68 61 72 61 63 |'" '(787|3 charac|
|00000e40| 74 65 72 73 29 27 0a 69 | 66 20 74 65 73 74 20 2d |ters)'.i|f test -|
|00000e50| 66 20 27 74 65 73 74 2e | 6d 34 27 0a 74 68 65 6e |f 'test.|m4'.then|
|00000e60| 0a 09 65 63 68 6f 20 73 | 68 61 72 3a 20 77 69 6c |..echo s|har: wil|
|00000e70| 6c 20 6e 6f 74 20 6f 76 | 65 72 2d 77 72 69 74 65 |l not ov|er-write|
|00000e80| 20 65 78 69 73 74 69 6e | 67 20 66 69 6c 65 20 22 | existin|g file "|
|00000e90| 27 74 65 73 74 2e 6d 34 | 27 22 0a 65 6c 73 65 0a |'test.m4|'".else.|
|00000ea0| 73 65 64 20 27 73 2f 5e | 09 58 2f 2f 27 20 3c 3c |sed 's/^|.X//' <<|
|00000eb0| 20 5c 53 48 41 52 5f 45 | 4f 46 20 3e 20 27 74 65 | \SHAR_E|OF > 'te|
|00000ec0| 73 74 2e 6d 34 27 0a 09 | 58 23 0a 09 58 23 20 74 |st.m4'..|X#..X# t|
|00000ed0| 65 73 74 20 66 69 6c 65 | 20 66 6f 72 20 6d 70 20 |est file| for mp |
|00000ee0| 28 6e 6f 74 20 63 6f 6d | 70 72 65 68 65 6e 73 69 |(not com|prehensi|
|00000ef0| 76 65 29 0a 09 58 23 0a | 09 58 23 20 69 6e 63 6c |ve)..X#.|.X# incl|
|00000f00| 75 64 65 20 73 74 72 69 | 6e 67 20 6d 61 63 72 6f |ude stri|ng macro|
|00000f10| 73 0a 09 58 23 0a 09 58 | 69 6e 63 6c 75 64 65 28 |s..X#..X|include(|
|00000f20| 73 74 72 69 6e 67 2e 6d | 34 29 0a 09 58 23 0a 09 |string.m|4)..X#..|
|00000f30| 58 23 20 63 72 65 61 74 | 65 20 73 6f 6d 65 20 66 |X# creat|e some f|
|00000f40| 6f 72 74 72 61 73 68 20 | 73 74 72 69 6e 67 73 20 |ortrash |strings |
|00000f50| 66 6f 72 20 61 6e 20 65 | 76 65 6e 20 75 67 6c 69 |for an e|ven ugli|
|00000f60| 65 72 20 6c 61 6e 67 75 | 61 67 65 0a 09 58 23 0a |er langu|age..X#.|
|00000f70| 09 58 73 74 72 69 6e 67 | 28 54 45 58 54 2c 20 22 |.Xstring|(TEXT, "|
|00000f80| 74 65 78 74 22 29 0a 09 | 58 73 74 72 69 6e 67 28 |text")..|Xstring(|
|00000f90| 44 41 54 41 2c 20 22 64 | 61 74 61 22 29 0a 09 58 |DATA, "d|ata")..X|
|00000fa0| 73 74 72 69 6e 67 28 42 | 45 47 49 4e 2c 20 22 62 |string(B|EGIN, "b|
|00000fb0| 65 67 69 6e 22 29 0a 09 | 58 73 74 72 69 6e 67 28 |egin")..|Xstring(|
|00000fc0| 45 4e 44 2c 20 22 65 6e | 64 22 29 0a 09 58 73 74 |END, "en|d")..Xst|
|00000fd0| 72 69 6e 67 28 49 46 2c | 20 22 69 66 22 29 0a 09 |ring(IF,| "if")..|
|00000fe0| 58 73 74 72 69 6e 67 28 | 54 48 45 4e 2c 20 22 74 |Xstring(|THEN, "t|
|00000ff0| 68 65 6e 22 29 0a 09 58 | 73 74 72 69 6e 67 28 45 |hen")..X|string(E|
|00001000| 4c 53 45 2c 20 22 65 6c | 73 65 22 29 0a 09 58 73 |LSE, "el|se")..Xs|
|00001010| 74 72 69 6e 67 28 43 41 | 53 45 2c 20 22 63 61 73 |tring(CA|SE, "cas|
|00001020| 65 22 29 0a 09 58 73 74 | 72 69 6e 67 28 52 45 50 |e")..Xst|ring(REP|
|00001030| 45 41 54 2c 20 22 72 65 | 70 65 61 74 22 29 0a 09 |EAT, "re|peat")..|
|00001040| 58 73 74 72 69 6e 67 28 | 57 48 49 4c 45 2c 20 22 |Xstring(|WHILE, "|
|00001050| 77 68 69 6c 65 22 29 0a | 09 58 73 74 72 69 6e 67 |while").|.Xstring|
|00001060| 28 44 45 46 41 55 4c 54 | 2c 20 22 64 65 66 61 75 |(DEFAULT|, "defau|
|00001070| 6c 74 22 29 0a 09 58 73 | 74 72 69 6e 67 28 55 4e |lt")..Xs|tring(UN|
|00001080| 54 49 4c 2c 20 22 75 6e | 74 69 6c 22 29 0a 09 58 |TIL, "un|til")..X|
|00001090| 73 74 72 69 6e 67 28 46 | 55 4e 43 54 49 4f 4e 2c |string(F|UNCTION,|
|000010a0| 20 22 66 75 6e 63 74 69 | 6f 6e 22 29 0a 09 58 73 | "functi|on")..Xs|
|000010b0| 74 72 69 6e 67 28 50 52 | 4f 43 45 44 55 52 45 2c |tring(PR|OCEDURE,|
|000010c0| 20 22 70 72 6f 63 65 64 | 75 72 65 22 29 0a 09 58 | "proced|ure")..X|
|000010d0| 73 74 72 69 6e 67 28 45 | 58 54 45 52 4e 41 4c 2c |string(E|XTERNAL,|
|000010e0| 20 22 65 78 74 65 72 6e | 61 6c 22 29 0a 09 58 73 | "extern|al")..Xs|
|000010f0| 74 72 69 6e 67 28 46 4f | 52 57 41 52 44 2c 20 22 |tring(FO|RWARD, "|
|00001100| 66 6f 72 77 61 72 64 22 | 29 0a 09 58 73 74 72 69 |forward"|)..Xstri|
|00001110| 6e 67 28 54 59 50 45 2c | 20 22 74 79 70 65 22 29 |ng(TYPE,| "type")|
|00001120| 0a 09 58 73 74 72 69 6e | 67 28 56 41 52 2c 20 22 |..Xstrin|g(VAR, "|
|00001130| 76 61 72 22 29 0a 09 58 | 73 74 72 69 6e 67 28 43 |var")..X|string(C|
|00001140| 4f 4e 53 54 2c 20 22 63 | 6f 6e 73 74 22 29 0a 09 |ONST, "c|onst")..|
|00001150| 58 73 74 72 69 6e 67 28 | 50 52 4f 47 52 41 4d 2c |Xstring(|PROGRAM,|
|00001160| 20 22 70 72 6f 67 72 61 | 6d 22 29 0a 09 58 73 74 | "progra|m")..Xst|
|00001170| 72 69 6e 67 28 49 4e 50 | 55 54 2c 20 22 69 6e 70 |ring(INP|UT, "inp|
|00001180| 75 74 22 29 0a 09 58 73 | 74 72 69 6e 67 28 4f 55 |ut")..Xs|tring(OU|
|00001190| 54 50 55 54 2c 20 22 6f | 75 74 70 75 74 22 29 0a |TPUT, "o|utput").|
|000011a0| 09 58 23 0a 09 58 64 69 | 76 65 72 74 28 32 29 0a |.X#..Xdi|vert(2).|
|000011b0| 09 58 64 69 76 65 72 73 | 69 6f 6e 20 23 31 0a 09 |.Xdivers|ion #1..|
|000011c0| 58 64 69 76 65 72 74 28 | 33 29 0a 09 58 64 69 76 |Xdivert(|3)..Xdiv|
|000011d0| 65 72 73 69 6f 6e 20 23 | 32 0a 09 58 64 69 76 65 |ersion #|2..Xdive|
|000011e0| 72 74 28 34 29 0a 09 58 | 64 69 76 65 72 73 69 6f |rt(4)..X|diversio|
|000011f0| 6e 20 23 33 0a 09 58 64 | 69 76 65 72 74 28 35 29 |n #3..Xd|ivert(5)|
|00001200| 0a 09 58 64 69 76 65 72 | 73 69 6f 6e 20 23 34 0a |..Xdiver|sion #4.|
|00001210| 09 58 64 69 76 65 72 74 | 28 30 29 0a 09 58 64 65 |.Xdivert|(0)..Xde|
|00001220| 66 69 6e 65 28 61 62 63 | 2c 78 78 78 29 0a 09 58 |fine(abc|,xxx)..X|
|00001230| 69 66 64 65 66 28 60 61 | 62 63 27 2c 64 65 66 69 |ifdef(`a|bc',defi|
|00001240| 6e 65 64 2c 75 6e 64 65 | 66 69 6e 65 64 29 0a 09 |ned,unde|fined)..|
|00001250| 58 23 0a 09 58 23 20 76 | 37 20 6d 34 20 64 6f 65 |X#..X# v|7 m4 doe|
|00001260| 73 20 74 68 69 73 20 77 | 72 6f 6e 67 2e 20 54 68 |s this w|rong. Th|
|00001270| 65 20 72 69 67 68 74 20 | 6f 75 74 70 75 74 20 69 |e right |output i|
|00001280| 73 20 0a 09 58 23 20 09 | 74 68 69 73 20 69 73 20 |s ..X# .|this is |
|00001290| 41 20 76 45 72 79 20 6c | 6f 6e 20 73 45 6e 74 45 |A vEry l|on sEntE|
|000012a0| 6e 43 45 0a 09 58 23 20 | 73 65 65 20 6d 34 20 64 |nCE..X# |see m4 d|
|000012b0| 6f 63 75 6d 65 6e 74 61 | 74 69 6f 6e 20 66 6f 72 |ocumenta|tion for|
|000012c0| 20 74 72 61 6e 73 6c 69 | 74 2e 0a 09 58 23 0a 09 | transli|t...X#..|
|000012d0| 58 74 72 61 6e 73 6c 69 | 74 28 60 74 68 69 73 20 |Xtransli|t(`this |
|000012e0| 69 73 20 61 20 76 65 72 | 79 20 6c 6f 6e 67 20 73 |is a ver|y long s|
|000012f0| 65 6e 74 65 6e 63 65 27 | 2c 20 61 62 63 64 65 66 |entence'|, abcdef|
|00001300| 67 2c 20 41 42 43 44 45 | 46 29 0a 09 58 23 0a 09 |g, ABCDE|F)..X#..|
|00001310| 58 23 20 69 6e 63 6c 75 | 64 65 20 74 6f 77 65 72 |X# inclu|de tower|
|00001320| 73 2d 6f 66 2d 68 61 6e | 6f 69 0a 09 58 23 0a 09 |s-of-han|oi..X#..|
|00001330| 58 69 6e 63 6c 75 64 65 | 28 68 61 6e 6f 69 2e 6d |Xinclude|(hanoi.m|
|00001340| 34 29 0a 09 58 23 0a 09 | 58 23 20 73 6f 6d 65 20 |4)..X#..|X# some |
|00001350| 72 65 61 73 6f 6e 61 62 | 6c 65 20 73 65 74 20 6f |reasonab|le set o|
|00001360| 66 20 64 69 73 6b 73 0a | 09 58 23 0a 09 58 68 61 |f disks.|.X#..Xha|
|00001370| 6e 6f 69 28 36 29 0a 09 | 58 23 0a 09 58 23 20 69 |noi(6)..|X#..X# i|
|00001380| 6e 63 6c 75 64 65 20 61 | 63 6b 65 72 6d 61 6e 6e |nclude a|ckermann|
|00001390| 27 73 20 66 75 6e 63 74 | 69 6f 6e 0a 09 58 23 0a |'s funct|ion..X#.|
|000013a0| 09 58 69 6e 63 6c 75 64 | 65 28 61 63 6b 2e 6d 34 |.Xinclud|e(ack.m4|
|000013b0| 29 0a 09 58 23 0a 09 58 | 23 20 73 6f 6d 65 74 68 |)..X#..X|# someth|
|000013c0| 69 6e 67 20 6c 69 6b 65 | 20 28 33 2c 33 29 20 77 |ing like| (3,3) w|
|000013d0| 69 6c 6c 20 62 6c 6f 77 | 20 61 77 61 79 20 75 6e |ill blow| away un|
|000013e0| 2a 78 20 6d 34 2e 0a 09 | 58 23 0a 09 58 61 63 6b |*x m4...|X#..Xack|
|000013f0| 28 32 2c 33 29 0a 09 58 | 23 0a 09 58 23 20 69 6e |(2,3)..X|#..X# in|
|00001400| 63 6c 75 64 65 20 61 20 | 73 71 75 61 72 65 5f 72 |clude a |square_r|
|00001410| 6f 6f 74 20 66 75 6e 63 | 74 69 6f 6e 20 66 6f 72 |oot func|tion for|
|00001420| 20 66 69 78 65 64 20 6e | 75 6d 73 0a 09 58 23 0a | fixed n|ums..X#.|
|00001430| 09 58 69 6e 63 6c 75 64 | 65 28 73 71 72 6f 6f 74 |.Xinclud|e(sqroot|
|00001440| 2e 6d 34 29 0a 09 58 23 | 0a 09 58 23 20 73 6f 6d |.m4)..X#|..X# som|
|00001450| 65 20 73 71 75 61 72 65 | 20 72 6f 6f 74 73 2e 0a |e square| roots..|
|00001460| 09 58 23 0a 09 58 73 71 | 75 61 72 65 5f 72 6f 6f |.X#..Xsq|uare_roo|
|00001470| 74 28 31 35 29 0a 09 58 | 73 71 75 61 72 65 5f 72 |t(15)..X|square_r|
|00001480| 6f 6f 74 28 31 30 30 29 | 0a 09 58 73 71 75 61 72 |oot(100)|..Xsquar|
|00001490| 65 5f 72 6f 6f 74 28 2d | 34 29 0a 09 58 73 71 75 |e_root(-|4)..Xsqu|
|000014a0| 61 72 65 5f 72 6f 6f 74 | 28 32 31 33 37 32 29 0a |are_root|(21372).|
|000014b0| 09 58 23 0a 09 58 23 20 | 73 6f 6d 65 20 74 65 78 |.X#..X# |some tex|
|000014c0| 74 75 61 6c 20 6d 61 74 | 65 72 69 61 6c 20 66 6f |tual mat|erial fo|
|000014d0| 72 20 65 6e 6a 6f 79 6d | 65 6e 74 2e 0a 09 58 23 |r enjoym|ent...X#|
|000014e0| 0a 09 58 5b 74 61 6b 65 | 6e 20 66 72 6f 6d 20 74 |..X[take|n from t|
|000014f0| 68 65 20 27 43 6c 65 6d | 73 6f 6e 20 55 6e 69 76 |he 'Clem|son Univ|
|00001500| 65 72 73 69 74 79 20 43 | 6f 6d 70 75 74 65 72 20 |ersity C|omputer |
|00001510| 4e 65 77 73 6c 65 74 74 | 65 72 27 2c 0a 09 58 20 |Newslett|er',..X |
|00001520| 53 65 70 74 65 6d 62 65 | 72 20 31 39 38 31 2c 20 |Septembe|r 1981, |
|00001530| 70 70 2e 20 36 2d 37 5d | 0a 09 58 20 20 20 20 20 |pp. 6-7]|..X |
|00001540| 0a 09 58 49 20 61 6d 20 | 61 20 77 69 7a 61 72 64 |..XI am |a wizard|
|00001550| 20 69 6e 20 74 68 65 20 | 6d 61 67 69 63 61 6c 20 | in the |magical |
|00001560| 4b 69 6e 67 64 6f 6d 20 | 6f 66 20 54 72 61 6e 73 |Kingdom |of Trans|
|00001570| 66 6f 72 6d 61 74 69 6f | 6e 20 61 6e 64 20 49 0a |formatio|n and I.|
|00001580| 09 58 73 6c 61 79 20 64 | 72 61 67 6f 6e 73 20 66 |.Xslay d|ragons f|
|00001590| 6f 72 20 61 20 6c 69 76 | 69 6e 67 2e 20 20 41 63 |or a liv|ing. Ac|
|000015a0| 74 75 61 6c 6c 79 2c 20 | 49 20 61 6d 20 61 20 73 |tually, |I am a s|
|000015b0| 79 73 74 65 6d 73 20 70 | 72 6f 67 72 61 6d 6d 65 |ystems p|rogramme|
|000015c0| 72 2e 0a 09 58 4f 6e 65 | 20 6f 66 20 74 68 65 20 |r...XOne| of the |
|000015d0| 70 72 6f 62 6c 65 6d 73 | 20 77 69 74 68 20 73 79 |problems| with sy|
|000015e0| 73 74 65 6d 73 20 70 72 | 6f 67 72 61 6d 6d 69 6e |stems pr|ogrammin|
|000015f0| 67 20 69 73 20 65 78 70 | 6c 61 69 6e 69 6e 67 20 |g is exp|laining |
|00001600| 74 6f 0a 09 58 6e 6f 6e | 2d 63 6f 6d 70 75 74 65 |to..Xnon|-compute|
|00001610| 72 20 65 6e 74 68 75 73 | 69 61 73 74 73 20 77 68 |r enthus|iasts wh|
|00001620| 61 74 20 74 68 61 74 20 | 69 73 2e 20 20 41 6c 6c |at that |is. All|
|00001630| 20 6f 66 20 74 68 65 20 | 74 65 72 6d 73 20 49 20 | of the |terms I |
|00001640| 75 73 65 20 74 6f 0a 09 | 58 64 65 73 63 72 69 62 |use to..|Xdescrib|
|00001650| 65 20 6d 79 20 6a 6f 62 | 20 61 72 65 20 74 6f 74 |e my job| are tot|
|00001660| 61 6c 6c 79 20 6d 65 61 | 6e 69 6e 67 6c 65 73 73 |ally mea|ningless|
|00001670| 20 74 6f 20 74 68 65 6d | 2e 20 20 55 73 75 61 6c | to them|. Usual|
|00001680| 6c 79 20 6d 79 20 72 65 | 73 70 6f 6e 73 65 0a 09 |ly my re|sponse..|
|00001690| 58 74 6f 20 71 75 65 73 | 74 69 6f 6e 73 20 61 62 |Xto ques|tions ab|
|000016a0| 6f 75 74 20 6d 79 20 77 | 6f 72 6b 20 69 73 20 74 |out my w|ork is t|
|000016b0| 6f 20 73 61 79 20 61 73 | 20 6c 69 74 74 6c 65 20 |o say as| little |
|000016c0| 61 73 20 70 6f 73 73 69 | 62 6c 65 2e 20 20 46 6f |as possi|ble. Fo|
|000016d0| 72 0a 09 58 69 6e 73 74 | 61 6e 63 65 2c 20 69 66 |r..Xinst|ance, if|
|000016e0| 20 73 6f 6d 65 6f 6e 65 | 20 61 73 6b 73 20 77 68 | someone| asks wh|
|000016f0| 61 74 20 68 61 70 70 65 | 6e 65 64 20 61 74 20 77 |at happe|ned at w|
|00001700| 6f 72 6b 20 74 68 69 73 | 20 77 65 65 6b 2c 20 49 |ork this| week, I|
|00001710| 20 73 61 79 0a 09 58 22 | 4e 6f 74 68 69 6e 67 20 | say..X"|Nothing |
|00001720| 6d 75 63 68 22 20 61 6e | 64 20 74 68 65 6e 20 49 |much" an|d then I|
|00001730| 20 63 68 61 6e 67 65 20 | 74 68 65 20 73 75 62 6a | change |the subj|
|00001740| 65 63 74 2e 0a 09 58 20 | 20 20 20 20 0a 09 58 57 |ect...X | ..XW|
|00001750| 69 74 68 20 74 68 65 20 | 61 73 73 69 73 74 61 6e |ith the |assistan|
|00001760| 63 65 20 6f 66 20 6d 79 | 20 62 72 6f 74 68 65 72 |ce of my| brother|
|00001770| 2c 20 61 20 6d 65 63 68 | 61 6e 69 63 61 6c 20 65 |, a mech|anical e|
|00001780| 6e 67 69 6e 65 65 72 2c | 20 49 20 68 61 76 65 20 |ngineer,| I have |
|00001790| 64 65 76 69 73 65 64 0a | 09 58 61 6e 20 61 6e 61 |devised.|.Xan ana|
|000017a0| 6c 6f 67 79 20 74 68 61 | 74 20 65 76 65 72 79 6f |logy tha|t everyo|
|000017b0| 6e 65 20 63 61 6e 20 75 | 6e 64 65 72 73 74 61 6e |ne can u|nderstan|
|000017c0| 64 2e 20 20 54 68 65 20 | 61 6e 61 6c 6f 67 79 20 |d. The |analogy |
|000017d0| 64 65 73 63 72 69 62 65 | 73 20 74 68 65 0a 09 58 |describe|s the..X|
|000017e0| 22 4b 69 6e 67 64 6f 6d | 20 6f 66 20 54 72 61 6e |"Kingdom| of Tran|
|000017f0| 73 66 6f 72 6d 61 74 69 | 6f 6e 22 20 77 68 65 72 |sformati|on" wher|
|00001800| 65 20 74 72 61 76 65 6c | 65 72 73 20 77 61 6e 64 |e travel|ers wand|
|00001810| 65 72 20 61 6e 64 20 61 | 72 65 20 6d 61 67 69 63 |er and a|re magic|
|00001820| 61 6c 6c 79 0a 09 58 74 | 72 61 6e 73 66 6f 72 6d |ally..Xt|ransform|
|00001830| 65 64 2e 20 20 54 68 69 | 73 20 6b 69 6e 67 64 6f |ed. Thi|s kingdo|
|00001840| 6d 20 69 73 20 74 68 65 | 20 63 6f 6d 70 75 74 65 |m is the| compute|
|00001850| 72 20 61 6e 64 20 74 68 | 65 20 74 72 61 76 65 6c |r and th|e travel|
|00001860| 65 72 73 20 61 72 65 20 | 69 6e 66 6f 72 6d 61 74 |ers are |informat|
|00001870| 69 6f 6e 2e 0a 09 58 54 | 68 65 20 70 75 72 70 6f |ion...XT|he purpo|
|00001880| 73 65 20 6f 66 20 74 68 | 65 20 63 6f 6d 70 75 74 |se of th|e comput|
|00001890| 65 72 20 69 73 20 74 6f | 20 63 68 61 6e 67 65 20 |er is to| change |
|000018a0| 69 6e 66 6f 72 6d 61 74 | 69 6f 6e 20 74 6f 20 61 |informat|ion to a|
|000018b0| 20 6d 6f 72 65 20 6d 65 | 61 6e 69 6e 67 66 75 6c | more me|aningful|
|000018c0| 0a 09 58 66 6f 72 6d 61 | 2e 20 20 54 68 65 20 6c |..Xforma|. The l|
|000018d0| 61 77 20 6f 66 20 63 6f | 6e 73 65 72 76 61 74 69 |aw of co|nservati|
|000018e0| 6f 6e 20 61 70 70 6c 69 | 65 73 20 68 65 72 65 3a |on appli|es here:|
|000018f0| 20 20 54 68 65 20 63 6f | 6d 70 75 74 65 72 20 6e | The co|mputer n|
|00001900| 65 76 65 72 20 63 72 65 | 61 74 65 73 0a 09 58 61 |ever cre|ates..Xa|
|00001910| 6e 64 20 6e 65 76 65 72 | 20 69 6e 74 65 6e 74 69 |nd never| intenti|
|00001920| 6f 6e 61 6c 6c 79 20 64 | 65 73 74 72 6f 79 73 20 |onally d|estroys |
|00001930| 64 61 74 61 2e 20 20 57 | 69 74 68 20 6e 6f 20 66 |data. W|ith no f|
|00001940| 75 72 74 68 65 72 20 61 | 64 6f 2c 20 6c 65 74 20 |urther a|do, let |
|00001950| 75 73 20 74 72 61 76 65 | 6c 0a 09 58 74 6f 20 74 |us trave|l..Xto t|
|00001960| 68 65 20 4b 69 6e 67 64 | 6f 6d 20 6f 66 20 54 72 |he Kingd|om of Tr|
|00001970| 61 6e 73 66 6f 72 6d 61 | 74 69 6f 6e 3a 0a 09 58 |ansforma|tion:..X|
|00001980| 20 20 20 20 20 0a 09 58 | 49 6e 20 61 20 6c 61 6e | ..X|In a lan|
|00001990| 64 20 66 61 72 2c 20 66 | 61 72 20 61 77 61 79 2c |d far, f|ar away,|
|000019a0| 20 74 68 65 72 65 20 69 | 73 20 61 20 6d 61 67 69 | there i|s a magi|
|000019b0| 63 61 6c 20 6b 69 6e 67 | 64 6f 6d 20 63 61 6c 6c |cal king|dom call|
|000019c0| 65 64 20 74 68 65 20 4b | 69 6e 67 64 6f 6d 20 6f |ed the K|ingdom o|
|000019d0| 66 0a 09 58 54 72 61 6e | 73 66 6f 72 6d 61 74 69 |f..XTran|sformati|
|000019e0| 6f 6e 2e 20 20 41 20 6b | 69 6e 67 20 72 75 6c 65 |on. A k|ing rule|
|000019f0| 73 20 6f 76 65 72 20 74 | 68 69 73 20 6c 61 6e 64 |s over t|his land|
|00001a00| 20 61 6e 64 20 65 6d 70 | 6c 6f 79 73 20 61 20 43 | and emp|loys a C|
|00001a10| 6f 75 6e 63 69 6c 20 6f | 66 0a 09 58 57 69 7a 61 |ouncil o|f..XWiza|
|00001a20| 72 64 72 79 2e 20 20 54 | 68 65 20 6d 61 69 6e 20 |rdry. T|he main |
|00001a30| 70 75 72 70 6f 73 65 20 | 6f 66 20 74 68 69 73 20 |purpose |of this |
|00001a40| 6b 69 6e 67 64 6f 6d 20 | 69 73 20 74 6f 20 70 72 |kingdom |is to pr|
|00001a50| 6f 76 69 64 65 20 61 20 | 77 61 79 20 66 6f 72 0a |ovide a |way for.|
|00001a60| 09 58 6e 65 69 67 68 62 | 6f 72 69 6e 67 20 6b 69 |.Xneighb|oring ki|
|00001a70| 6e 67 64 6f 6d 73 20 74 | 6f 20 74 72 61 6e 73 66 |ngdoms t|o transf|
|00001a80| 6f 72 6d 20 63 69 74 69 | 7a 65 6e 73 20 69 6e 74 |orm citi|zens int|
|00001a90| 6f 20 6d 6f 72 65 20 75 | 73 65 66 75 6c 20 63 69 |o more u|seful ci|
|00001aa0| 74 69 7a 65 6e 73 2e 20 | 20 54 68 69 73 0a 09 58 |tizens. | This..X|
|00001ab0| 69 73 20 64 6f 6e 65 20 | 62 79 20 61 6c 6c 6f 77 |is done |by allow|
|00001ac0| 69 6e 67 20 74 68 65 20 | 63 69 74 69 7a 65 6e 73 |ing the |citizens|
|00001ad0| 20 74 6f 20 65 6e 74 65 | 72 20 74 68 65 20 6b 69 | to ente|r the ki|
|00001ae0| 6e 67 64 6f 6d 20 61 74 | 20 6f 6e 65 20 6f 66 20 |ngdom at| one of |
|00001af0| 69 74 73 20 70 6f 72 74 | 73 0a 09 58 61 6e 64 20 |its port|s..Xand |
|00001b00| 74 6f 20 74 72 61 76 65 | 6c 20 61 6e 79 20 6f 66 |to trave|l any of|
|00001b10| 20 74 68 65 20 6d 61 6e | 79 20 72 6f 75 74 65 73 | the man|y routes|
|00001b20| 20 69 6e 20 74 68 65 20 | 6b 69 6e 67 64 6f 6d 2e | in the |kingdom.|
|00001b30| 20 20 54 68 65 79 20 61 | 72 65 20 6d 61 67 69 63 | They a|re magic|
|00001b40| 61 6c 6c 79 0a 09 58 74 | 72 61 6e 73 66 6f 72 6d |ally..Xt|ransform|
|00001b50| 65 64 20 61 6c 6f 6e 67 | 20 74 68 65 20 77 61 79 |ed along| the way|
|00001b60| 2e 20 20 54 68 65 20 69 | 6e 63 6f 6d 65 20 6f 66 |. The i|ncome of|
|00001b70| 20 74 68 65 20 4b 69 6e | 67 64 6f 6d 20 6f 66 20 | the Kin|gdom of |
|00001b80| 54 72 61 6e 73 66 6f 72 | 6d 61 74 69 6f 6e 0a 09 |Transfor|mation..|
|00001b90| 58 63 6f 6d 65 73 20 66 | 72 6f 6d 20 74 68 65 20 |Xcomes f|rom the |
|00001ba0| 6d 61 6e 79 20 74 6f 6c | 6c 20 72 6f 61 64 73 20 |many tol|l roads |
|00001bb0| 77 69 74 68 69 6e 20 69 | 74 73 20 62 6f 75 6e 64 |within i|ts bound|
|00001bc0| 61 72 69 65 73 2e 0a 09 | 58 20 20 20 20 20 0a 09 |aries...|X ..|
|00001bd0| 58 54 68 65 20 4b 69 6e | 67 64 6f 6d 20 6f 66 20 |XThe Kin|gdom of |
|00001be0| 54 72 61 6e 73 66 6f 72 | 6d 61 74 69 6f 6e 20 77 |Transfor|mation w|
|00001bf0| 61 73 20 63 72 65 61 74 | 65 64 20 77 68 65 6e 20 |as creat|ed when |
|00001c00| 73 65 76 65 72 61 6c 20 | 6b 69 6e 67 64 6f 6d 73 |several |kingdoms|
|00001c10| 20 67 6f 74 0a 09 58 74 | 6f 67 65 74 68 65 72 20 | got..Xt|ogether |
|00001c20| 61 6e 64 20 64 69 73 63 | 6f 76 65 72 65 64 20 61 |and disc|overed a|
|00001c30| 20 6d 75 74 75 61 6c 20 | 6e 65 65 64 20 66 6f 72 | mutual |need for|
|00001c40| 20 6e 65 77 20 74 61 6c | 65 6e 74 73 20 61 6e 64 | new tal|ents and|
|00001c50| 20 61 62 69 6c 69 74 69 | 65 73 20 66 6f 72 0a 09 | abiliti|es for..|
|00001c60| 58 63 69 74 69 7a 65 6e | 73 2e 20 20 54 68 65 79 |Xcitizen|s. They|
|00001c70| 20 65 6d 70 6c 6f 79 65 | 64 20 43 54 4b 2c 20 49 | employe|d CTK, I|
|00001c80| 6e 63 2e 20 28 43 72 65 | 61 74 6f 72 73 20 6f 66 |nc. (Cre|ators of|
|00001c90| 20 54 72 61 6e 73 66 6f | 72 6d 61 74 69 6f 6e 2c | Transfo|rmation,|
|00001ca0| 20 49 6e 63 2e 29 20 74 | 6f 0a 09 58 63 72 65 61 | Inc.) t|o..Xcrea|
|00001cb0| 74 65 20 74 68 69 73 20 | 6b 69 6e 67 64 6f 6d 2e |te this |kingdom.|
|00001cc0| 20 20 43 54 4b 20 64 65 | 73 69 67 6e 65 64 20 74 | CTK de|signed t|
|00001cd0| 68 65 20 63 6f 75 6e 74 | 72 79 2c 20 69 74 73 20 |he count|ry, its |
|00001ce0| 74 72 61 6e 73 70 6f 72 | 74 61 74 69 6f 6e 20 72 |transpor|tation r|
|00001cf0| 6f 75 74 65 73 2c 0a 09 | 58 61 6e 64 20 69 74 73 |outes,..|Xand its|
|00001d00| 20 6c 61 77 73 20 6f 66 | 20 74 72 61 6e 73 66 6f | laws of| transfo|
|00001d10| 72 6d 61 74 69 6f 6e 2c | 20 61 6e 64 20 63 72 65 |rmation,| and cre|
|00001d20| 61 74 65 64 20 74 68 65 | 20 6d 61 6a 6f 72 20 68 |ated the| major h|
|00001d30| 69 67 68 77 61 79 20 73 | 79 73 74 65 6d 2e 0a 09 |ighway s|ystem...|
|00001d40| 58 20 20 20 20 20 0a 09 | 58 48 61 7a 61 72 64 73 |X ..|XHazards|
|00001d50| 0a 09 58 3d 3d 3d 3d 3d | 3d 3d 0a 09 58 20 20 20 |..X=====|==..X |
|00001d60| 20 20 0a 09 58 42 65 63 | 61 75 73 65 20 6d 61 67 | ..XBec|ause mag|
|00001d70| 69 63 20 69 73 20 6e 6f | 74 20 74 72 75 6c 79 20 |ic is no|t truly |
|00001d80| 63 6f 6e 74 72 6f 6c 6c | 61 62 6c 65 2c 20 43 54 |controll|able, CT|
|00001d90| 4b 20 69 6e 76 61 72 69 | 61 62 6c 79 2c 20 62 75 |K invari|ably, bu|
|00001da0| 74 20 75 6e 6b 6e 6f 77 | 69 6e 67 6c 79 2c 0a 09 |t unknow|ingly,..|
|00001db0| 58 63 72 65 61 74 65 73 | 20 64 72 61 67 6f 6e 73 |Xcreates| dragons|
|00001dc0| 2e 20 20 44 72 61 67 6f | 6e 73 20 61 72 65 20 68 |. Drago|ns are h|
|00001dd0| 75 67 65 20 66 69 72 65 | 2d 62 72 65 61 74 68 69 |uge fire|-breathi|
|00001de0| 6e 67 20 62 65 61 73 74 | 73 20 77 68 69 63 68 20 |ng beast|s which |
|00001df0| 73 6f 6d 65 74 69 6d 65 | 73 0a 09 58 69 6e 6a 75 |sometime|s..Xinju|
|00001e00| 72 65 20 6f 72 20 6b 69 | 6c 6c 20 74 72 61 76 65 |re or ki|ll trave|
|00001e10| 6c 65 72 73 2e 20 20 46 | 6f 72 74 75 6e 61 74 65 |lers. F|ortunate|
|00001e20| 6c 79 2c 20 74 68 65 79 | 20 64 6f 20 6e 6f 74 20 |ly, they| do not |
|00001e30| 74 72 61 76 65 6c 2c 20 | 62 75 74 20 61 6c 77 61 |travel, |but alwa|
|00001e40| 79 73 0a 09 58 72 65 6d | 61 69 6e 20 6e 65 61 72 |ys..Xrem|ain near|
|00001e50| 20 74 68 65 69 72 20 64 | 65 6e 2e 0a 09 58 20 20 | their d|en...X |
|00001e60| 20 20 20 0a 09 58 4f 74 | 68 65 72 20 68 61 7a 61 | ..XOt|her haza|
|00001e70| 72 64 73 20 61 6c 73 6f | 20 65 78 69 73 74 20 77 |rds also| exist w|
|00001e80| 68 69 63 68 20 61 72 65 | 20 70 6f 74 65 6e 74 69 |hich are| potenti|
|00001e90| 61 6c 6c 79 20 68 61 72 | 6d 66 75 6c 2e 20 20 41 |ally har|mful. A|
|00001ea0| 73 20 74 68 65 20 72 6f | 61 64 73 0a 09 58 62 65 |s the ro|ads..Xbe|
|00001eb0| 63 6f 6d 65 20 6f 6c 64 | 65 72 20 61 6e 64 20 6d |come old|er and m|
|00001ec0| 6f 72 65 20 77 65 61 74 | 68 65 72 62 65 61 74 65 |ore weat|herbeate|
|00001ed0| 6e 2c 20 70 6f 74 2d 68 | 6f 6c 65 73 20 77 69 6c |n, pot-h|oles wil|
|00001ee0| 6c 20 64 65 76 65 6c 6f | 70 2c 20 74 72 65 65 73 |l develo|p, trees|
|00001ef0| 20 77 69 6c 6c 0a 09 58 | 66 61 6c 6c 20 6f 6e 20 | will..X|fall on |
|00001f00| 74 72 61 76 65 6c 65 72 | 73 2c 20 65 74 63 2e 20 |traveler|s, etc. |
|00001f10| 20 43 54 4b 20 6d 61 69 | 6e 74 65 6e 61 6e 63 65 | CTK mai|ntenance|
|00001f20| 20 6d 65 6e 20 61 72 65 | 20 63 61 6c 6c 65 64 20 | men are| called |
|00001f30| 74 6f 20 66 69 78 20 74 | 68 65 73 65 0a 09 58 70 |to fix t|hese..Xp|
|00001f40| 72 6f 62 6c 65 6d 73 2e | 0a 09 58 20 20 20 20 20 |roblems.|..X |
|00001f50| 0a 09 58 57 69 7a 61 72 | 64 73 0a 09 58 3d 3d 3d |..XWizar|ds..X===|
|00001f60| 3d 3d 3d 3d 0a 09 58 20 | 20 20 20 20 0a 09 58 54 |====..X | ..XT|
|00001f70| 68 65 20 77 69 7a 61 72 | 64 73 20 70 6c 61 79 20 |he wizar|ds play |
|00001f80| 61 20 6d 61 6a 6f 72 20 | 72 6f 6c 65 20 69 6e 20 |a major |role in |
|00001f90| 63 72 65 61 74 69 6e 67 | 20 61 6e 64 20 6d 61 69 |creating| and mai|
|00001fa0| 6e 74 61 69 6e 69 6e 67 | 20 74 68 65 20 6b 69 6e |ntaining| the kin|
|00001fb0| 67 64 6f 6d 20 62 75 74 | 0a 09 58 67 65 74 20 6c |gdom but|..Xget l|
|00001fc0| 69 74 74 6c 65 20 63 72 | 65 64 69 74 20 66 6f 72 |ittle cr|edit for|
|00001fd0| 20 74 68 65 69 72 20 77 | 6f 72 6b 20 62 65 63 61 | their w|ork beca|
|00001fe0| 75 73 65 20 69 74 20 69 | 73 20 70 65 72 66 6f 72 |use it i|s perfor|
|00001ff0| 6d 65 64 20 73 65 63 72 | 65 74 6c 79 2e 20 20 54 |med secr|etly. T|
|00002000| 68 65 0a 09 58 77 69 7a | 61 72 64 73 20 64 6f 20 |he..Xwiz|ards do |
|00002010| 6e 6f 74 20 77 61 6e 20 | 74 68 65 20 77 6f 72 6b |not wan |the work|
|00002020| 65 72 73 20 6f 72 20 74 | 72 61 76 65 6c 65 72 73 |ers or t|ravelers|
|00002030| 20 74 6f 20 6c 65 61 72 | 6e 20 74 68 65 69 72 20 | to lear|n their |
|00002040| 69 6e 63 61 6e 74 61 74 | 69 6f 6e 73 0a 09 58 62 |incantat|ions..Xb|
|00002050| 65 63 61 75 73 65 20 6d | 61 6e 79 20 6c 61 77 73 |ecause m|any laws|
|00002060| 20 77 6f 75 6c 64 20 62 | 65 20 62 72 6f 6b 65 6e | would b|e broken|
|00002070| 20 61 6e 64 20 63 68 61 | 6f 73 20 77 6f 75 6c 64 | and cha|os would|
|00002080| 20 72 65 73 75 6c 74 2e | 0a 09 58 20 20 20 20 20 | result.|..X |
|00002090| 0a 09 58 43 54 4b 27 73 | 20 67 72 61 6e 64 20 64 |..XCTK's| grand d|
|000020a0| 65 73 69 67 6e 20 69 73 | 20 61 6c 77 61 79 73 20 |esign is| always |
|000020b0| 67 65 6e 65 72 61 6c 20 | 65 6e 6f 75 67 68 20 74 |general |enough t|
|000020c0| 6f 20 62 65 20 61 70 70 | 6c 69 63 61 62 6c 65 20 |o be app|licable |
|000020d0| 69 6e 20 6d 61 6e 79 0a | 09 58 64 69 66 66 65 72 |in many.|.Xdiffer|
|000020e0| 65 6e 74 20 73 69 74 75 | 61 74 69 6f 6e 73 2e 20 |ent situ|ations. |
|000020f0| 20 41 73 20 61 20 72 65 | 73 75 6c 74 2c 20 69 74 | As a re|sult, it|
|00002100| 20 69 73 20 6f 66 74 65 | 6e 20 64 69 66 66 69 63 | is ofte|n diffic|
|00002110| 75 6c 74 20 74 6f 20 75 | 73 65 2e 20 20 54 68 65 |ult to u|se. The|
|00002120| 0a 09 58 66 69 72 73 74 | 20 64 75 74 79 20 6f 66 |..Xfirst| duty of|
|00002130| 20 74 68 65 20 77 69 7a | 61 72 64 73 20 69 73 20 | the wiz|ards is |
|00002140| 74 6f 20 74 61 69 6c 6f | 72 20 74 68 65 20 74 72 |to tailo|r the tr|
|00002150| 61 6e 73 66 6f 72 6d 61 | 74 69 6f 6e 20 6c 61 77 |ansforma|tion law|
|00002160| 73 20 73 6f 20 61 73 20 | 74 6f 20 62 65 0a 09 58 |s so as |to be..X|
|00002170| 6d 6f 72 65 20 62 65 6e | 65 66 69 63 69 61 6c 20 |more ben|eficial |
|00002180| 61 6e 64 20 65 61 73 69 | 65 72 20 74 6f 20 75 73 |and easi|er to us|
|00002190| 65 20 69 6e 20 74 68 65 | 69 72 20 70 61 72 74 69 |e in the|ir parti|
|000021a0| 63 75 6c 61 72 20 65 6e | 76 69 72 6f 6e 6d 65 6e |cular en|vironmen|
|000021b0| 74 2e 0a 09 58 20 20 20 | 20 20 0a 09 58 41 66 74 |t...X | ..XAft|
|000021c0| 65 72 20 63 72 65 61 74 | 69 6f 6e 20 6f 66 20 74 |er creat|ion of t|
|000021d0| 68 65 20 6b 69 6e 67 64 | 6f 6d 2c 20 61 20 6d 61 |he kingd|om, a ma|
|000021e0| 6a 6f 72 20 64 75 74 79 | 20 6f 66 20 74 68 65 20 |jor duty| of the |
|000021f0| 77 69 7a 61 72 64 73 20 | 69 73 20 74 6f 20 73 65 |wizards |is to se|
|00002200| 61 72 63 68 20 66 6f 72 | 0a 09 58 61 6e 64 20 6b |arch for|..Xand k|
|00002210| 69 6c 6c 20 64 72 61 67 | 6f 6e 73 2e 20 20 49 66 |ill drag|ons. If|
|00002220| 20 74 72 61 76 65 6c 65 | 72 73 20 64 6f 20 6e 6f | travele|rs do no|
|00002230| 74 20 72 65 74 75 72 6e | 20 6f 6e 20 74 69 6d 65 |t return| on time|
|00002240| 20 6f 72 20 69 66 20 74 | 68 65 79 20 72 65 74 75 | or if t|hey retu|
|00002250| 72 6e 0a 09 58 69 6e 6a | 75 72 65 64 2c 20 74 68 |rn..Xinj|ured, th|
|00002260| 65 20 72 75 6c 65 72 20 | 6f 66 20 74 68 65 20 63 |e ruler |of the c|
|00002270| 6f 75 6e 74 72 79 20 63 | 6f 6e 74 61 63 74 73 20 |ountry c|ontacts |
|00002280| 74 68 65 20 77 69 7a 61 | 72 64 73 2e 20 20 49 66 |the wiza|rds. If|
|00002290| 20 74 68 65 20 77 69 7a | 61 72 64 73 0a 09 58 64 | the wiz|ards..Xd|
|000022a0| 65 74 65 72 6d 69 6e 65 | 20 74 68 61 74 20 74 68 |etermine| that th|
|000022b0| 65 20 69 6e 6a 75 72 79 | 20 6f 72 20 64 65 61 74 |e injury| or deat|
|000022c0| 68 20 6f 63 63 75 72 72 | 65 64 20 64 75 65 20 74 |h occurr|ed due t|
|000022d0| 6f 20 74 68 65 20 74 72 | 61 76 65 6c 65 72 27 73 |o the tr|aveler's|
|000022e0| 0a 09 58 6e 65 67 6c 69 | 67 65 6e 63 65 2c 20 74 |..Xnegli|gence, t|
|000022f0| 68 65 79 20 70 72 6f 76 | 69 64 65 20 74 68 65 20 |hey prov|ide the |
|00002300| 74 72 61 76 65 6c 65 72 | 27 73 20 63 6f 75 6e 74 |traveler|'s count|
|00002310| 72 79 20 77 69 74 68 20 | 61 64 64 69 74 69 6f 6e |ry with |addition|
|00002320| 61 6c 20 77 61 72 6e 69 | 6e 67 73 2e 0a 09 58 49 |al warni|ngs...XI|
|00002330| 66 20 6e 6f 74 2c 20 74 | 68 65 79 20 6d 75 73 74 |f not, t|hey must|
|00002340| 20 64 65 74 65 72 6d 69 | 6e 65 20 69 66 20 74 68 | determi|ne if th|
|00002350| 65 20 63 61 75 73 65 20 | 77 61 73 20 61 20 72 6f |e cause |was a ro|
|00002360| 61 64 20 68 61 7a 61 72 | 64 20 6f 72 20 61 20 64 |ad hazar|d or a d|
|00002370| 72 61 67 6f 6e 2e 20 20 | 49 66 0a 09 58 74 68 65 |ragon. |If..Xthe|
|00002380| 20 73 75 73 70 65 63 74 | 20 61 20 72 6f 61 64 20 | suspect| a road |
|00002390| 68 61 7a 61 72 64 2c 20 | 74 68 65 79 20 63 61 6c |hazard, |they cal|
|000023a0| 6c 20 69 6e 20 61 20 43 | 54 4b 20 6d 61 69 6e 74 |l in a C|TK maint|
|000023b0| 65 6e 61 6e 63 65 20 6d | 61 6e 20 74 6f 20 6c 6f |enance m|an to lo|
|000023c0| 63 61 74 65 20 74 68 65 | 0a 09 58 68 61 7a 61 72 |cate the|..Xhazar|
|000023d0| 64 20 61 6e 64 20 74 6f | 20 65 6c 69 6d 69 6e 61 |d and to| elimina|
|000023e0| 74 65 20 69 74 2c 20 61 | 73 20 69 6e 20 72 65 70 |te it, a|s in rep|
|000023f0| 61 69 72 69 6e 67 20 74 | 68 65 20 70 6f 74 68 6f |airing t|he potho|
|00002400| 6c 65 20 69 6e 20 74 68 | 65 20 72 6f 61 64 2e 20 |le in th|e road. |
|00002410| 20 49 66 0a 09 58 74 68 | 65 79 20 74 68 69 6e 6b | If..Xth|ey think|
|00002420| 20 74 68 61 74 20 63 61 | 75 73 65 20 77 61 73 20 | that ca|use was |
|00002430| 61 20 64 72 61 67 6f 6e | 2c 20 74 68 65 6e 20 74 |a dragon|, then t|
|00002440| 68 65 79 20 6d 75 73 74 | 20 66 69 6e 64 20 61 6e |hey must| find an|
|00002450| 64 20 73 6c 61 79 20 69 | 74 2e 0a 09 58 20 20 20 |d slay i|t...X |
|00002460| 20 20 0a 09 58 54 68 65 | 20 6d 6f 73 74 20 64 69 | ..XThe| most di|
|00002470| 66 66 69 63 75 6c 74 20 | 70 61 72 74 20 6f 66 20 |fficult |part of |
|00002480| 65 6c 69 6d 69 6e 61 74 | 69 6e 67 20 61 20 64 72 |eliminat|ing a dr|
|00002490| 61 67 6f 6e 20 69 73 20 | 66 69 6e 64 69 6e 67 20 |agon is |finding |
|000024a0| 69 74 2e 20 20 53 6f 6d | 65 74 69 6d 65 73 0a 09 |it. Som|etimes..|
|000024b0| 58 74 68 65 20 77 69 7a | 61 72 64 20 6d 61 67 69 |Xthe wiz|ard magi|
|000024c0| 63 61 6c 6c 79 20 6b 6e | 6f 77 73 20 77 68 65 72 |cally kn|ows wher|
|000024d0| 65 20 74 68 65 20 64 72 | 61 67 6f 6e 27 73 20 6c |e the dr|agon's l|
|000024e0| 61 69 72 20 69 74 2c 20 | 62 75 74 20 6f 66 74 65 |air it, |but ofte|
|000024f0| 6e 20 74 68 65 20 77 69 | 7a 61 72 64 0a 09 58 6d |n the wi|zard..Xm|
|00002500| 75 73 74 20 73 65 6e 64 | 20 61 6e 6f 74 68 65 72 |ust send| another|
|00002510| 20 74 72 61 76 65 6c 65 | 72 20 61 6c 6f 6e 67 20 | travele|r along |
|00002520| 74 68 65 20 73 61 6d 65 | 20 72 6f 75 74 65 20 61 |the same| route a|
|00002530| 6e 64 20 77 61 74 63 68 | 20 74 6f 20 73 65 65 20 |nd watch| to see |
|00002540| 77 68 65 72 65 20 68 65 | 0a 09 58 64 69 73 61 70 |where he|..Xdisap|
|00002550| 70 65 61 72 73 2e 20 20 | 54 68 69 73 20 73 6f 75 |pears. |This sou|
|00002560| 6e 64 73 20 6c 69 6b 65 | 20 61 20 66 61 69 6c 73 |nds like| a fails|
|00002570| 61 66 65 20 6d 65 74 68 | 6f 64 20 66 6f 72 20 66 |afe meth|od for f|
|00002580| 69 6e 64 69 6e 67 20 64 | 72 61 67 6f 6e 73 20 28 |inding d|ragons (|
|00002590| 61 6e 64 20 61 0a 09 58 | 73 75 69 63 69 64 65 20 |and a..X|suicide |
|000025a0| 6d 69 73 73 69 6f 6e 20 | 66 6f 72 20 74 68 72 20 |mission |for thr |
|000025b0| 74 72 61 76 65 6c 65 72 | 29 20 62 75 74 20 74 68 |traveler|) but th|
|000025c0| 65 20 73 65 63 6f 6e 64 | 20 74 72 61 76 65 6c 65 |e second| travele|
|000025d0| 72 20 64 6f 65 73 20 6e | 6f 74 20 61 6c 77 61 79 |r does n|ot alway|
|000025e0| 73 0a 09 58 64 69 73 61 | 70 70 65 61 72 2e 20 20 |s..Xdisa|ppear. |
|000025f0| 53 6f 6d 65 20 64 72 61 | 67 6f 6e 73 20 65 61 74 |Some dra|gons eat|
|00002600| 20 61 6e 79 20 74 72 61 | 76 65 6c 65 72 20 77 68 | any tra|veler wh|
|00002610| 6f 20 63 6f 6d 65 73 20 | 74 6f 6f 20 63 6c 6f 73 |o comes |too clos|
|00002620| 65 3b 20 6f 74 68 65 72 | 73 20 61 72 65 0a 09 58 |e; other|s are..X|
|00002630| 76 65 72 79 20 70 69 63 | 6b 79 2e 0a 09 58 20 20 |very pic|ky...X |
|00002640| 20 20 20 0a 09 58 54 68 | 65 20 77 69 7a 61 72 64 | ..XTh|e wizard|
|00002650| 73 20 6d 61 79 20 63 61 | 6c 6c 20 69 6e 20 43 54 |s may ca|ll in CT|
|00002660| 4b 20 77 68 6f 20 64 65 | 73 69 67 6e 65 64 20 74 |K who de|signed t|
|00002670| 68 65 20 68 69 67 68 77 | 61 79 20 73 79 73 74 65 |he highw|ay syste|
|00002680| 6d 20 61 6e 64 0a 09 58 | 74 72 61 6e 73 66 6f 72 |m and..X|transfor|
|00002690| 6d 61 74 69 6f 6e 20 6c | 61 77 73 20 74 6f 20 68 |mation l|aws to h|
|000026a0| 65 6c 70 20 64 65 76 69 | 73 65 20 61 20 77 61 79 |elp devi|se a way|
|000026b0| 20 74 6f 20 6c 6f 63 61 | 74 65 20 74 68 65 20 64 | to loca|te the d|
|000026c0| 72 61 67 6f 6e 2e 20 20 | 43 54 4b 20 61 6c 73 6f |ragon. |CTK also|
|000026d0| 0a 09 58 68 65 6c 70 73 | 20 70 72 6f 76 69 64 65 |..Xhelps| provide|
|000026e0| 20 74 68 65 20 72 69 67 | 68 74 20 73 70 65 6c 6c | the rig|ht spell|
|000026f0| 20 6f 72 20 69 6e 63 61 | 6e 74 61 74 69 6f 6e 20 | or inca|ntation |
|00002700| 74 6f 20 73 6c 61 79 20 | 74 68 65 20 64 72 61 67 |to slay |the drag|
|00002710| 6f 6e 2e 20 28 54 68 65 | 72 65 20 69 73 0a 09 58 |on. (The|re is..X|
|00002720| 6e 6f 20 67 65 6e 65 72 | 61 6c 20 73 70 65 6c 6c |no gener|al spell|
|00002730| 20 74 6f 20 73 6c 61 79 | 20 64 72 61 67 6f 6e 73 | to slay| dragons|
|00002740| 3b 20 65 61 63 68 20 64 | 72 61 67 6f 6e 20 6d 75 |; each d|ragon mu|
|00002750| 73 74 20 62 65 20 65 6c | 69 6d 69 6e 61 74 65 64 |st be el|iminated|
|00002760| 20 77 69 74 68 20 61 0a | 09 58 64 69 66 66 65 72 | with a.|.Xdiffer|
|00002770| 65 6e 74 20 73 70 65 6c | 6c 2e 29 0a 09 58 20 20 |ent spel|l.)..X |
|00002780| 20 20 20 0a 09 58 42 65 | 63 61 75 73 65 20 6e 65 | ..XBe|cause ne|
|00002790| 69 74 68 65 72 20 43 54 | 4b 20 6e 6f 72 20 77 69 |ither CT|K nor wi|
|000027a0| 7a 61 72 64 73 20 61 72 | 65 20 70 65 72 66 65 63 |zards ar|e perfec|
|000027b0| 74 2c 20 73 70 65 6c 6c | 73 20 74 6f 20 6e 6f 74 |t, spell|s to not|
|000027c0| 20 61 6c 77 61 79 73 20 | 77 6f 72 6b 0a 09 58 63 | always |work..Xc|
|000027d0| 6f 72 72 65 63 74 6c 79 | 2e 20 20 41 74 20 62 65 |orrectly|. At be|
|000027e0| 73 74 2c 20 6e 6f 74 68 | 69 6e 67 20 68 61 70 70 |st, noth|ing happ|
|000027f0| 65 6e 73 20 77 68 65 6e | 20 74 68 65 20 77 72 6f |ens when| the wro|
|00002800| 6e 67 20 73 70 65 6c 6c | 20 69 73 20 75 74 74 65 |ng spell| is utte|
|00002810| 72 65 64 2e 20 20 41 74 | 0a 09 58 77 6f 72 73 74 |red. At|..Xworst|
|00002820| 2c 20 74 68 65 20 64 72 | 61 67 6f 6e 20 62 65 63 |, the dr|agon bec|
|00002830| 6f 6d 65 73 20 61 20 6d | 75 63 68 20 6c 61 72 67 |omes a m|uch larg|
|00002840| 65 72 20 64 72 61 67 6f | 6e 20 6f 72 20 6d 75 6c |er drago|n or mul|
|00002850| 74 69 70 6c 69 65 73 20 | 69 6e 74 6f 20 73 65 76 |tiplies |into sev|
|00002860| 65 72 61 6c 0a 09 58 73 | 6d 61 6c 6c 65 72 20 6f |eral..Xs|maller o|
|00002870| 6e 65 73 2e 20 20 49 6e | 20 65 69 74 68 65 72 20 |nes. In| either |
|00002880| 63 61 73 65 2c 20 6e 65 | 77 20 73 70 65 6c 6c 73 |case, ne|w spells|
|00002890| 20 6d 75 73 74 20 62 65 | 20 66 6f 75 6e 64 2e 0a | must be| found..|
|000028a0| 09 58 20 20 20 20 20 0a | 09 58 49 66 20 61 6c 6c |.X .|.XIf all|
|000028b0| 20 65 78 69 73 74 69 6e | 67 20 64 72 61 67 6f 6e | existin|g dragon|
|000028c0| 73 20 61 72 65 20 71 75 | 69 65 74 20 28 69 2e 65 |s are qu|iet (i.e|
|000028d0| 2e 20 68 61 76 65 20 65 | 61 74 65 6e 20 73 75 66 |. have e|aten suf|
|000028e0| 66 69 63 69 65 6e 74 6c | 79 29 2c 20 77 69 7a 61 |ficientl|y), wiza|
|000028f0| 72 64 73 0a 09 58 68 61 | 76 65 20 74 69 6d 65 20 |rds..Xha|ve time |
|00002900| 74 6f 20 64 6f 20 6f 74 | 68 65 72 20 74 68 69 6e |to do ot|her thin|
|00002910| 67 73 2e 20 20 54 68 65 | 79 20 68 69 64 65 20 69 |gs. The|y hide i|
|00002920| 6e 20 63 61 73 74 6c 65 | 73 20 61 6e 64 20 70 72 |n castle|s and pr|
|00002930| 61 63 74 69 63 65 20 73 | 70 65 6c 6c 73 20 61 6e |actice s|pells an|
|00002940| 64 0a 09 58 69 6e 63 61 | 74 61 74 69 6f 6e 73 2e |d..Xinca|tations.|
|00002950| 20 20 54 68 65 79 20 61 | 6c 73 6f 20 64 65 76 69 | They a|lso devi|
|00002960| 73 65 20 73 68 6f 72 74 | 63 75 74 73 20 66 6f 72 |se short|cuts for|
|00002970| 20 74 72 61 76 65 6c 65 | 72 73 20 61 6e 64 20 6e | travele|rs and n|
|00002980| 65 77 20 6c 61 77 73 20 | 6f 66 0a 09 58 74 72 61 |ew laws |of..Xtra|
|00002990| 6e 73 66 6f 72 6d 61 74 | 69 6f 6e 2e 0a 09 58 20 |nsformat|ion...X |
|000029a0| 20 20 20 20 0a 09 58 43 | 68 61 6e 67 65 73 20 69 | ..XC|hanges i|
|000029b0| 6e 20 74 68 65 20 4b 69 | 6e 67 64 6f 6d 0a 09 58 |n the Ki|ngdom..X|
|000029c0| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|000029d0| 3d 3d 3d 3d 3d 3d 0a 09 | 58 20 20 20 20 20 0a 09 |======..|X ..|
|000029e0| 58 41 73 20 6e 65 77 20 | 74 72 61 6e 73 66 6f 72 |XAs new |transfor|
|000029f0| 6d 61 74 69 6f 6e 20 6b | 69 6e 67 64 6f 6d 73 20 |mation k|ingdoms |
|00002a00| 61 72 65 20 63 72 65 61 | 74 65 64 20 61 6e 64 20 |are crea|ted and |
|00002a10| 6f 6c 64 20 6f 6e 65 73 | 20 61 72 65 20 6d 61 69 |old ones| are mai|
|00002a20| 6e 74 61 69 6e 65 64 2c | 0a 09 58 43 54 4b 2c 20 |ntained,|..XCTK, |
|00002a30| 49 6e 63 2e 20 69 73 20 | 63 6f 6e 73 74 61 6e 74 |Inc. is |constant|
|00002a40| 6c 79 20 6c 65 61 72 6e | 69 6e 67 20 6e 65 77 20 |ly learn|ing new |
|00002a50| 74 68 69 6e 67 73 2e 20 | 20 49 74 20 6c 65 61 72 |things. | It lear|
|00002a60| 6e 73 20 77 61 79 73 20 | 74 6f 20 61 76 6f 69 64 |ns ways |to avoid|
|00002a70| 0a 09 58 63 72 65 61 74 | 69 6e 67 20 73 6f 6d 65 |..Xcreat|ing some|
|00002a80| 20 6f 66 20 74 68 65 20 | 64 72 61 67 6f 6e 73 20 | of the |dragons |
|00002a90| 74 68 61 74 20 74 68 65 | 79 20 68 61 76 65 20 70 |that the|y have p|
|00002aa0| 72 65 76 69 6f 75 73 6c | 79 20 63 72 65 61 74 65 |reviousl|y create|
|00002ab0| 64 2e 20 20 49 74 20 61 | 6c 73 6f 0a 09 58 64 69 |d. It a|lso..Xdi|
|00002ac0| 73 63 6f 76 65 72 73 20 | 6e 65 77 20 61 6e 64 20 |scovers |new and |
|00002ad0| 62 65 74 74 65 72 20 6c | 61 77 73 20 6f 66 20 74 |better l|aws of t|
|00002ae0| 72 61 6e 73 66 6f 72 6d | 61 74 69 6f 6e 2e 20 20 |ransform|ation. |
|00002af0| 41 73 20 61 20 72 65 73 | 75 6c 74 2c 20 43 54 4b |As a res|ult, CTK|
|00002b00| 20 77 69 6c 6c 0a 09 58 | 70 65 72 69 6f 64 69 63 | will..X|periodic|
|00002b10| 61 6c 6c 79 20 63 72 65 | 61 74 65 20 61 20 6e 65 |ally cre|ate a ne|
|00002b20| 77 20 67 72 61 6e 64 20 | 64 65 73 69 67 6e 20 77 |w grand |design w|
|00002b30| 68 69 63 68 20 69 73 20 | 66 61 72 20 62 65 74 74 |hich is |far bett|
|00002b40| 65 72 20 74 68 61 6e 20 | 74 68 65 20 6f 6c 64 2e |er than |the old.|
|00002b50| 0a 09 58 54 68 65 20 77 | 69 7a 61 72 64 73 20 64 |..XThe w|izards d|
|00002b60| 65 74 65 72 6d 69 6e 65 | 20 77 68 65 6e 20 69 73 |etermine| when is|
|00002b70| 20 61 20 67 6f 6f 64 20 | 74 69 6d 65 20 74 6f 20 | a good |time to |
|00002b80| 69 6d 70 6c 65 6d 65 6e | 74 20 74 68 69 73 20 6e |implemen|t this n|
|00002b90| 65 77 20 64 65 73 69 67 | 6e 2e 0a 09 58 54 68 69 |ew desig|n...XThi|
|00002ba0| 73 20 69 73 20 77 68 65 | 6e 20 74 68 65 20 74 6f |s is whe|n the to|
|00002bb0| 75 72 69 73 74 20 73 65 | 61 73 6f 6e 20 69 73 20 |urist se|ason is |
|00002bc0| 73 6c 6f 77 20 6f 72 20 | 77 68 65 6e 20 6e 6f 20 |slow or |when no |
|00002bd0| 69 6d 70 6f 72 74 61 6e | 74 20 74 72 61 76 65 6c |importan|t travel|
|00002be0| 65 72 73 0a 09 58 28 56 | 49 50 73 29 20 61 72 65 |ers..X(V|IPs) are|
|00002bf0| 20 74 6f 20 61 72 72 69 | 76 65 2e 20 20 54 68 65 | to arri|ve. The|
|00002c00| 20 6b 69 6e 67 64 6f 6d | 20 6d 75 73 74 20 62 65 | kingdom| must be|
|00002c10| 20 63 6c 6f 73 65 64 20 | 66 6f 72 20 74 68 65 20 | closed |for the |
|00002c20| 61 63 74 75 61 6c 0a 09 | 58 69 6d 70 6c 65 6d 65 |actual..|Ximpleme|
|00002c30| 6e 74 61 74 69 6f 6e 20 | 61 6e 64 20 69 73 20 6c |ntation |and is l|
|00002c40| 65 74 65 72 20 72 65 6f | 70 65 6e 65 64 20 61 73 |eter reo|pened as|
|00002c50| 20 61 20 6e 65 77 20 61 | 6e 64 20 62 65 74 74 65 | a new a|nd bette|
|00002c60| 72 20 70 6c 61 63 65 20 | 74 6f 20 67 6f 2e 0a 09 |r place |to go...|
|00002c70| 58 20 20 20 20 20 0a 09 | 58 41 20 66 69 6e 61 6c |X ..|XA final|
|00002c80| 20 71 75 65 73 74 69 6f | 6e 20 79 6f 75 20 6d 69 | questio|n you mi|
|00002c90| 67 68 74 20 61 73 6b 20 | 69 73 20 77 68 61 74 20 |ght ask |is what |
|00002ca0| 68 61 70 70 65 6e 73 20 | 77 68 65 6e 20 74 68 65 |happens |when the|
|00002cb0| 20 6e 75 6d 62 65 72 20 | 6f 66 20 74 6f 75 72 69 | number |of touri|
|00002cc0| 73 74 73 0a 09 58 62 65 | 63 6f 6d 65 73 20 74 6f |sts..Xbe|comes to|
|00002cd0| 6f 20 67 72 65 61 74 20 | 66 6f 72 20 74 68 65 20 |o great |for the |
|00002ce0| 6b 69 6e 67 64 6f 6d 20 | 74 6f 20 68 61 6e 64 6c |kingdom |to handl|
|00002cf0| 65 20 69 6e 20 61 20 72 | 65 61 73 6f 6e 61 62 6c |e in a r|easonabl|
|00002d00| 65 20 70 65 72 69 6f 64 | 20 6f 66 20 74 69 6d 65 |e period| of time|
|00002d10| 0a 09 58 28 69 2e 65 2e | 2c 20 74 68 65 20 74 6f |..X(i.e.|, the to|
|00002d20| 75 72 69 73 74 20 6c 69 | 6e 65 73 20 61 74 20 74 |urist li|nes at t|
|00002d30| 68 65 20 70 6f 72 74 73 | 20 61 72 65 20 74 6f 6f |he ports| are too|
|00002d40| 20 6c 6f 6e 67 29 2e 20 | 20 54 68 65 20 4b 69 6e | long). | The Kin|
|00002d50| 67 64 6f 6d 20 6f 66 0a | 09 58 54 72 61 6e 73 66 |gdom of.|.XTransf|
|00002d60| 6f 72 6d 61 74 69 6f 6e | 20 68 61 73 20 74 68 72 |ormation| has thr|
|00002d70| 65 65 20 6f 70 74 69 6f | 6e 73 3a 20 28 31 29 20 |ee optio|ns: (1) |
|00002d80| 73 68 6f 72 74 65 6e 20 | 74 68 65 20 70 61 74 68 |shorten |the path|
|00002d90| 73 20 74 68 61 74 20 61 | 20 74 6f 75 72 69 73 74 |s that a| tourist|
|00002da0| 20 6d 75 73 74 0a 09 58 | 74 72 61 76 65 6c 2c 20 | must..X|travel, |
|00002db0| 6f 72 20 28 32 29 20 63 | 6f 6e 76 69 6e 63 65 20 |or (2) c|onvince |
|00002dc0| 43 54 4b 20 74 6f 20 64 | 65 76 65 6c 6f 70 20 61 |CTK to d|evelop a|
|00002dd0| 20 66 61 73 74 65 72 20 | 62 72 65 65 64 20 6f 66 | faster |breed of|
|00002de0| 20 68 6f 72 73 65 73 20 | 73 6f 20 74 68 61 74 20 | horses |so that |
|00002df0| 74 68 65 0a 09 58 74 72 | 61 76 65 6c 65 72 73 20 |the..Xtr|avelers |
|00002e00| 63 61 6e 20 66 69 6e 69 | 73 68 20 73 6f 6f 6e 65 |can fini|sh soone|
|00002e10| 72 2c 20 6f 72 20 28 33 | 29 20 61 6e 6e 65 78 20 |r, or (3|) annex |
|00002e20| 6d 6f 72 65 20 74 65 72 | 72 69 74 6f 72 69 65 73 |more ter|ritories|
|00002e30| 20 73 6f 20 74 68 61 74 | 20 74 68 65 0a 09 58 6b | so that| the..Xk|
|00002e40| 69 6e 67 64 6f 6d 20 63 | 61 6e 20 68 61 6e 64 6c |ingdom c|an handl|
|00002e50| 65 20 6d 6f 72 65 20 74 | 72 61 76 65 6c 65 72 73 |e more t|ravelers|
|00002e60| 2e 0a 09 58 20 20 20 20 | 20 0a 09 58 54 68 75 73 |...X | ..XThus|
|00002e70| 20 65 6e 64 73 20 74 68 | 65 20 73 74 6f 72 79 20 | ends th|e story |
|00002e80| 6f 66 20 74 68 65 20 4b | 69 6e 67 64 6f 6d 20 6f |of the K|ingdom o|
|00002e90| 66 20 54 72 61 6e 73 66 | 6f 72 6d 61 74 69 6f 6e |f Transf|ormation|
|00002ea0| 2e 20 20 49 20 68 6f 70 | 65 20 74 68 69 73 20 68 |. I hop|e this h|
|00002eb0| 61 73 0a 09 58 65 78 70 | 6c 61 69 6e 65 64 20 6d |as..Xexp|lained m|
|00002ec0| 79 20 6a 6f 62 20 74 6f | 20 79 6f 75 3a 20 20 49 |y job to| you: I|
|00002ed0| 20 73 6c 61 79 20 64 72 | 61 67 6f 6e 73 20 66 6f | slay dr|agons fo|
|00002ee0| 72 20 61 20 6c 69 76 69 | 6e 67 2e 0a 09 58 0a 09 |r a livi|ng...X..|
|00002ef0| 58 23 0a 09 58 23 73 68 | 6f 75 6c 64 20 64 6f 20 |X#..X#sh|ould do |
|00002f00| 61 6e 20 61 75 74 6f 6d | 61 74 69 63 20 75 6e 64 |an autom|atic und|
|00002f10| 69 76 65 72 74 2e 2e 0a | 09 58 23 0a 53 48 41 52 |ivert...|.X#.SHAR|
|00002f20| 5f 45 4f 46 0a 69 66 20 | 74 65 73 74 20 37 38 37 |_EOF.if |test 787|
|00002f30| 33 20 2d 6e 65 20 22 60 | 77 63 20 2d 63 20 3c 20 |3 -ne "`|wc -c < |
|00002f40| 27 74 65 73 74 2e 6d 34 | 27 60 22 0a 74 68 65 6e |'test.m4|'`".then|
|00002f50| 0a 09 65 63 68 6f 20 73 | 68 61 72 3a 20 65 72 72 |..echo s|har: err|
|00002f60| 6f 72 20 74 72 61 6e 73 | 6d 69 74 74 69 6e 67 20 |or trans|mitting |
|00002f70| 22 27 74 65 73 74 2e 6d | 34 27 22 20 27 28 73 68 |"'test.m|4'" '(sh|
|00002f80| 6f 75 6c 64 20 68 61 76 | 65 20 62 65 65 6e 20 37 |ould hav|e been 7|
|00002f90| 38 37 33 20 63 68 61 72 | 61 63 74 65 72 73 29 27 |873 char|acters)'|
|00002fa0| 0a 66 69 0a 66 69 20 23 | 20 65 6e 64 20 6f 66 20 |.fi.fi #| end of |
|00002fb0| 6f 76 65 72 77 72 69 74 | 69 6e 67 20 63 68 65 63 |overwrit|ing chec|
|00002fc0| 6b 0a 65 63 68 6f 20 73 | 68 61 72 3a 20 65 78 74 |k.echo s|har: ext|
|00002fd0| 72 61 63 74 69 6e 67 20 | 22 27 52 45 41 44 4d 45 |racting |"'README|
|00002fe0| 27 22 0a 69 66 20 74 65 | 73 74 20 2d 66 20 27 52 |'".if te|st -f 'R|
|00002ff0| 45 41 44 4d 45 27 0a 74 | 68 65 6e 0a 09 65 63 68 |EADME'.t|hen..ech|
|00003000| 6f 20 73 68 61 72 3a 20 | 77 69 6c 6c 20 6e 6f 74 |o shar: |will not|
|00003010| 20 6f 76 65 72 2d 77 72 | 69 74 65 20 65 78 69 73 | over-wr|ite exis|
|00003020| 74 69 6e 67 20 66 69 6c | 65 20 22 27 52 45 41 44 |ting fil|e "'READ|
|00003030| 4d 45 27 22 0a 65 6c 73 | 65 0a 63 61 74 20 3c 3c |ME'".els|e.cat <<|
|00003040| 20 5c 53 48 41 52 5f 45 | 4f 46 20 3e 20 27 52 45 | \SHAR_E|OF > 'RE|
|00003050| 41 44 4d 45 27 0a 09 57 | 68 61 74 20 79 6f 75 20 |ADME'..W|hat you |
|00003060| 68 61 76 65 20 68 65 72 | 65 20 69 73 20 61 20 63 |have her|e is a c|
|00003070| 6f 6d 70 6c 65 74 65 6c | 79 20 50 44 20 69 6d 70 |ompletel|y PD imp|
|00003080| 6c 65 6d 65 6e 74 61 74 | 69 6f 6e 20 6f 66 0a 09 |lementat|ion of..|
|00003090| 4d 34 2e 20 49 74 20 77 | 61 73 20 6f 72 69 67 69 |M4. It w|as origi|
|000030a0| 6e 61 6c 6c 79 20 77 72 | 69 74 74 65 6e 20 66 6f |nally wr|itten fo|
|000030b0| 72 20 74 68 65 20 47 4e | 55 20 70 72 6f 6a 65 63 |r the GN|U projec|
|000030c0| 74 2e 20 0a 09 54 68 69 | 73 20 76 65 72 73 69 6f |t. ..Thi|s versio|
|000030d0| 6e 20 77 61 73 20 74 68 | 65 20 6c 61 73 74 20 76 |n was th|e last v|
|000030e0| 65 72 73 69 6f 6e 20 62 | 65 66 6f 72 65 20 61 20 |ersion b|efore a |
|000030f0| 6d 61 6a 6f 72 20 72 65 | 2d 77 72 69 74 65 20 0a |major re|-write .|
|00003100| 09 74 6f 6f 6b 20 70 6c | 61 63 65 2e 0a 0a 09 50 |.took pl|ace....P|
|00003110| 64 20 4d 34 20 69 73 20 | 62 61 73 65 64 20 6f 6e |d M4 is |based on|
|00003120| 20 73 6f 66 74 77 61 72 | 65 20 74 6f 6f 6c 73 20 | softwar|e tools |
|00003130| 6d 61 63 72 6f 2c 20 61 | 73 20 64 65 73 63 72 69 |macro, a|s descri|
|00003140| 62 65 64 20 69 6e 20 74 | 68 65 0a 09 74 77 6f 20 |bed in t|he..two |
|00003150| 74 6f 6f 6c 73 20 62 6f | 6f 6b 73 20 62 79 20 4b |tools bo|oks by K|
|00003160| 65 72 6e 69 67 68 61 6e | 20 61 6e 64 20 50 6c 61 |ernighan| and Pla|
|00003170| 75 67 65 72 2e 20 41 6c | 74 68 6f 75 67 68 20 73 |uger. Al|though s|
|00003180| 6f 6d 65 0a 09 73 65 72 | 69 6f 75 73 20 63 68 61 |ome..ser|ious cha|
|00003190| 6e 67 65 73 20 68 61 76 | 65 20 62 65 65 6e 20 6d |nges hav|e been m|
|000031a0| 61 64 65 2c 20 74 68 69 | 73 20 76 65 72 73 69 6f |ade, thi|s versio|
|000031b0| 6e 20 69 6e 68 65 72 69 | 74 73 20 74 68 65 20 62 |n inheri|ts the b|
|000031c0| 61 73 69 63 0a 09 64 65 | 73 69 67 6e 20 70 72 6f |asic..de|sign pro|
|000031d0| 62 6c 65 6d 73 20 6f 66 | 20 74 68 65 20 6f 72 69 |blems of| the ori|
|000031e0| 67 69 6e 61 6c 2c 20 68 | 65 6e 63 65 20 74 68 65 |ginal, h|ence the|
|000031f0| 20 75 67 6c 69 6e 65 73 | 73 20 6f 66 20 74 68 65 | uglines|s of the|
|00003200| 0a 09 75 6e 64 65 72 6c | 79 69 6e 67 20 63 6f 64 |..underl|ying cod|
|00003210| 65 2e 20 5b 47 4e 55 20 | 76 65 72 73 69 6f 6e 20 |e. [GNU |version |
|00003220| 6f 66 20 74 68 69 73 20 | 70 72 6f 63 65 73 73 6f |of this |processo|
|00003230| 72 20 69 73 20 72 65 2d | 64 65 73 69 67 6e 65 64 |r is re-|designed|
|00003240| 0a 09 69 6e 20 61 20 6d | 75 63 68 20 63 6c 65 61 |..in a m|uch clea|
|00003250| 6e 65 72 20 66 61 73 68 | 69 6f 6e 2c 20 61 6e 64 |ner fash|ion, and|
|00003260| 20 69 73 20 65 78 70 65 | 63 74 65 64 20 74 6f 20 | is expe|cted to |
|00003270| 62 65 20 6f 75 74 20 62 | 65 66 6f 72 65 20 0a 09 |be out b|efore ..|
|00003280| 31 39 38 38 2e 20 47 4e | 55 20 76 65 72 73 69 6f |1988. GN|U versio|
|00003290| 6e 20 61 6c 73 6f 20 69 | 6e 63 6c 75 64 65 73 20 |n also i|ncludes |
|000032a0| 61 6e 20 65 78 74 65 6e | 73 69 76 65 20 74 65 78 |an exten|sive tex|
|000032b0| 69 6e 66 6f 20 64 6f 63 | 75 6d 65 6e 74 2e 5d 0a |info doc|ument.].|
|000032c0| 0a 09 50 44 6e 65 73 73 | 3a 0a 0a 09 54 68 69 73 |..PDness|:...This|
|000032d0| 20 63 6f 64 65 20 2a 69 | 73 2a 20 50 44 2e 20 59 | code *i|s* PD. Y|
|000032e0| 6f 75 20 28 70 75 62 6c | 69 63 29 20 68 61 76 65 |ou (publ|ic) have|
|000032f0| 20 61 6c 6c 20 74 68 65 | 20 72 69 67 68 74 73 20 | all the| rights |
|00003300| 74 6f 20 74 68 65 20 63 | 6f 64 65 2e 20 0a 09 5b |to the c|ode. ..[|
|00003310| 42 75 74 20 74 68 69 73 | 20 61 6c 73 6f 20 6d 65 |But this| also me|
|00003320| 61 6e 73 20 79 6f 75 20 | 28 73 69 6e 67 75 6c 61 |ans you |(singula|
|00003330| 72 29 20 64 6f 20 6e 6f | 74 20 68 61 76 65 20 61 |r) do no|t have a|
|00003340| 6e 79 20 2a 65 78 74 72 | 61 2a 0a 09 72 69 67 68 |ny *extr|a*..righ|
|00003350| 74 73 20 74 6f 20 74 68 | 65 20 63 6f 64 65 2c 20 |ts to th|e code, |
|00003360| 68 65 6e 63 65 20 69 74 | 20 69 73 20 69 6d 70 6f |hence it| is impo|
|00003370| 73 73 69 62 6c 65 20 66 | 6f 72 20 79 6f 75 20 74 |ssible f|or you t|
|00003380| 6f 20 72 65 73 74 72 69 | 63 74 0a 09 74 68 65 20 |o restri|ct..the |
|00003390| 75 73 65 20 61 6e 64 20 | 64 69 73 74 72 69 62 75 |use and |distribu|
|000033a0| 74 69 6f 6e 20 6f 66 20 | 74 68 69 73 20 63 6f 64 |tion of |this cod|
|000033b0| 65 20 69 6e 20 61 6e 79 | 20 77 61 79 2e 5d 0a 0a |e in any| way.]..|
|000033c0| 09 44 65 64 69 63 61 74 | 69 6f 6e 3a 0a 0a 09 54 |.Dedicat|ion:...T|
|000033d0| 68 69 73 20 70 6f 73 74 | 69 6e 67 20 69 73 20 61 |his post|ing is a|
|000033e0| 20 64 65 64 69 63 61 74 | 69 6f 6e 20 74 6f 20 61 | dedicat|ion to a|
|000033f0| 6e 20 6f 6c 64 20 37 35 | 30 20 74 68 61 74 20 73 |n old 75|0 that s|
|00003400| 74 61 72 74 65 64 20 6f | 75 74 0a 09 72 75 6e 6e |tarted o|ut..runn|
|00003410| 69 6e 67 20 34 2e 31 42 | 53 44 20 61 6e 64 20 68 |ing 4.1B|SD and h|
|00003420| 61 64 20 31 2e 35 20 6d | 65 67 2c 20 31 20 64 7a |ad 1.5 m|eg, 1 dz|
|00003430| 31 31 2c 20 61 6e 64 20 | 32 20 52 6b 30 37 20 64 |11, and |2 Rk07 d|
|00003440| 72 69 76 65 73 2e 0a 09 | 49 74 20 77 61 73 20 6e |rives...|It was n|
|00003450| 61 6d 65 64 20 79 65 74 | 74 69 20 5b 73 69 63 5d |amed yet|ti [sic]|
|00003460| 20 62 79 20 61 63 63 69 | 64 65 6e 74 2c 20 61 6e | by acci|dent, an|
|00003470| 64 20 77 61 73 20 6d 61 | 6e 61 67 65 64 20 62 79 |d was ma|naged by|
|00003480| 20 74 68 65 0a 09 61 75 | 74 68 6f 72 20 75 6e 74 | the..au|thor unt|
|00003490| 69 6c 20 69 74 73 20 72 | 65 74 69 72 65 6d 65 6e |il its r|etiremen|
|000034a0| 74 20 66 65 77 20 6d 6f | 6e 74 68 73 20 61 67 6f |t few mo|nths ago|
|000034b0| 2e 20 5b 74 68 65 20 6e | 61 6d 65 20 79 65 74 74 |. [the n|ame yett|
|000034c0| 69 20 0a 09 6e 6f 77 20 | 69 64 65 6e 74 69 66 69 |i ..now |identifi|
|000034d0| 65 73 20 61 20 64 69 66 | 66 65 72 65 6e 74 20 6d |es a dif|ferent m|
|000034e0| 61 63 68 69 6e 65 5d 0a | 0a 09 44 69 73 74 72 69 |achine].|..Distri|
|000034f0| 62 75 74 69 6f 6e 20 2b | 20 6d 69 73 63 3a 0a 0a |bution +| misc:..|
|00003500| 09 54 68 65 20 64 69 73 | 74 72 69 62 75 74 69 6f |.The dis|tributio|
|00003510| 6e 20 69 6e 63 6c 75 64 | 65 73 20 61 20 73 6d 61 |n includ|es a sma|
|00003520| 6c 6c 20 74 65 73 74 20 | 73 75 69 74 65 2c 20 74 |ll test |suite, t|
|00003530| 68 65 20 73 6f 75 72 63 | 65 73 20 61 6e 64 0a 09 |he sourc|es and..|
|00003540| 61 20 6d 61 6e 20 70 61 | 67 65 2e 20 74 65 78 69 |a man pa|ge. texi|
|00003550| 6e 66 6f 20 64 6f 63 75 | 6d 65 6e 74 20 69 73 20 |nfo docu|ment is |
|00003560| 6e 6f 74 20 69 6e 63 6c | 75 64 65 64 2e 20 54 68 |not incl|uded. Th|
|00003570| 65 20 6d 61 6b 65 66 69 | 6c 65 20 69 73 0a 09 70 |e makefi|le is..p|
|00003580| 72 65 74 74 79 20 73 69 | 6d 70 6c 65 2e 20 53 65 |retty si|mple. Se|
|00003590| 65 20 74 68 65 20 6d 61 | 6b 65 66 69 6c 65 20 66 |e the ma|kefile f|
|000035a0| 6f 72 20 63 6f 6e 66 69 | 67 75 72 61 74 69 6f 6e |or confi|guration|
|000035b0| 20 6f 70 74 69 6f 6e 73 | 2e 0a 09 54 72 79 20 22 | options|...Try "|
|000035c0| 6d 61 6b 65 20 74 69 6d | 65 22 20 66 6f 72 20 73 |make tim|e" for s|
|000035d0| 6f 6d 65 20 74 69 6d 69 | 6e 67 20 63 6f 6d 70 61 |ome timi|ng compa|
|000035e0| 72 69 73 6f 6e 73 20 62 | 65 74 77 65 65 6e 20 79 |risons b|etween y|
|000035f0| 6f 75 72 20 75 6e 2a 78 | 0a 09 6d 34 20 61 6e 64 |our un*x|..m4 and|
|00003600| 20 74 68 65 20 70 64 20 | 6d 34 2e 20 5b 49 74 20 | the pd |m4. [It |
|00003610| 73 68 6f 75 6c 64 20 62 | 65 20 73 6c 69 67 68 6c |should b|e slighl|
|00003620| 79 20 73 6c 6f 77 65 72 | 20 74 68 61 6e 20 56 37 |y slower| than V7|
|00003630| 20 6d 34 2c 20 61 6e 64 | 0a 09 73 6c 69 67 68 74 | m4, and|..slight|
|00003640| 6c 79 20 66 61 73 74 65 | 72 20 74 68 61 6e 20 53 |ly faste|r than S|
|00003650| 56 20 6d 34 5d 2e 20 4d | 61 6b 65 20 73 75 72 65 |V m4]. M|ake sure|
|00003660| 20 74 6f 20 73 65 74 20 | 4d 42 49 4e 20 74 6f 20 | to set |MBIN to |
|00003670| 69 6e 64 69 63 61 74 65 | 0a 09 74 68 65 20 6c 6f |indicate|..the lo|
|00003680| 63 61 74 69 6f 6e 20 6f | 66 20 75 6e 2a 78 20 6d |cation o|f un*x m|
|00003690| 34 2e 20 53 65 65 20 74 | 68 65 20 74 65 73 74 20 |4. See t|he test |
|000036a0| 73 75 69 74 65 20 28 74 | 65 73 74 2e 6d 34 29 20 |suite (t|est.m4) |
|000036b0| 66 6f 72 20 73 6f 6d 65 | 0a 09 61 64 64 69 74 69 |for some|..additi|
|000036c0| 6f 6e 61 6c 20 63 6f 6d | 6d 65 6e 74 73 20 61 62 |onal com|ments ab|
|000036d0| 6f 75 74 20 70 64 20 6d | 34 20 76 73 20 75 6e 2a |out pd m|4 vs un*|
|000036e0| 78 20 6d 34 2e 0a 0a 09 | 53 6f 6d 65 20 74 68 6f |x m4....|Some tho|
|000036f0| 75 67 68 74 73 3a 0a 0a | 09 4d 34 20 69 73 20 61 |ughts:..|.M4 is a|
|00003700| 20 6e 65 61 74 20 6d 61 | 63 72 6f 20 70 72 6f 63 | neat ma|cro proc|
|00003710| 65 73 73 6f 72 20 62 75 | 74 20 70 72 6f 62 61 62 |essor bu|t probab|
|00003720| 6c 79 20 61 20 62 69 74 | 20 6f 75 74 64 61 74 65 |ly a bit| outdate|
|00003730| 64 20 62 79 0a 09 6e 6f | 77 2e 20 49 74 20 64 6f |d by..no|w. It do|
|00003740| 65 73 20 6e 6f 74 20 6e | 65 65 64 20 67 72 61 74 |es not n|eed grat|
|00003750| 75 69 74 6f 75 73 20 61 | 64 64 69 74 69 6f 6e 73 |uitous a|dditions|
|00003760| 2c 20 6f 72 20 22 66 65 | 61 74 75 72 65 73 22 2c |, or "fe|atures",|
|00003770| 20 62 75 74 0a 09 61 20 | 63 6f 6d 70 6c 65 74 65 | but..a |complete|
|00003780| 20 72 65 2d 77 72 69 74 | 65 2e 20 41 73 20 69 74 | re-writ|e. As it|
|00003790| 20 73 74 61 6e 64 73 2c | 20 69 74 20 69 73 20 70 | stands,| it is p|
|000037a0| 6f 77 65 72 66 75 6c 20 | 65 6e 6f 75 67 68 20 66 |owerful |enough f|
|000037b0| 6f 72 0a 09 6d 6f 73 74 | 20 6d 61 63 72 6f 20 70 |or..most| macro p|
|000037c0| 72 6f 63 65 73 73 69 6e | 67 20 6e 65 65 64 73 2e |rocessin|g needs.|
|000037d0| 20 57 65 20 68 61 76 65 | 2c 20 66 6f 72 20 65 78 | We have|, for ex|
|000037e0| 61 6d 70 6c 65 2c 20 75 | 73 65 64 20 69 74 20 74 |ample, u|sed it t|
|000037f0| 6f 0a 09 62 75 69 6c 64 | 20 61 20 63 6f 6e 66 69 |o..build| a confi|
|00003800| 67 75 72 61 74 69 6f 6e | 20 6c 61 6e 67 75 61 67 |guration| languag|
|00003810| 65 20 66 6f 72 20 44 45 | 43 4e 45 54 20 75 6e 64 |e for DE|CNET und|
|00003820| 65 72 20 56 4d 53 2e 20 | 49 74 20 63 61 6e 0a 09 |er VMS. |It can..|
|00003830| 62 65 20 61 20 68 61 6e | 64 79 20 73 6f 66 74 77 |be a han|dy softw|
|00003840| 61 72 65 20 65 6e 67 69 | 6e 65 65 72 69 6e 67 20 |are engi|neering |
|00003850| 74 6f 6f 6c 20 75 6e 64 | 65 72 20 6d 6f 73 74 20 |tool und|er most |
|00003860| 63 69 72 63 75 6d 73 74 | 61 6e 63 65 73 2c 0a 09 |circumst|ances,..|
|00003870| 61 6e 64 20 63 61 6e 20 | 64 69 73 70 6c 61 63 65 |and can |displace|
|00003880| 20 61 20 6c 6f 74 20 6f | 66 20 6d 65 61 6e 69 6e | a lot o|f meanin|
|00003890| 67 6c 65 73 73 20 6c 69 | 74 74 6c 65 20 68 61 63 |gless li|ttle hac|
|000038a0| 6b 73 20 77 72 69 74 74 | 65 6e 20 69 6e 0a 09 43 |ks writt|en in..C|
|000038b0| 2c 20 70 61 73 63 61 6c | 20 6f 72 20 77 68 61 74 |, pascal| or what|
|000038c0| 65 76 65 72 2e 20 5b 53 | 65 65 20 73 6f 6d 65 20 |ever. [S|ee some |
|000038d0| 6e 65 74 20 70 6f 73 74 | 69 6e 67 73 20 66 6f 72 |net post|ings for|
|000038e0| 20 72 65 66 65 72 65 6e | 63 65 73 2e 5d 0a 0a 09 | referen|ces.]...|
|000038f0| 53 75 67 67 65 73 74 69 | 6f 6e 73 20 66 6f 72 20 |Suggesti|ons for |
|00003900| 68 61 63 6b 69 6e 67 3a | 0a 0a 09 49 66 20 79 6f |hacking:|...If yo|
|00003910| 75 20 77 61 6e 74 20 74 | 6f 20 68 61 63 6b 20 4d |u want t|o hack M|
|00003920| 34 20 66 75 72 74 68 65 | 72 2c 20 79 6f 75 20 6d |4 furthe|r, you m|
|00003930| 61 79 20 77 69 73 68 20 | 74 6f 20 69 6d 70 6c 65 |ay wish |to imple|
|00003940| 6d 65 6e 74 20 74 68 65 | 0a 09 53 56 20 6d 34 20 |ment the|..SV m4 |
|00003950| 22 74 72 61 63 65 22 20 | 66 61 63 69 6c 69 74 79 |"trace" |facility|
|00003960| 2c 20 61 6e 64 20 65 78 | 74 65 6e 64 65 64 20 28 |, and ex|tended (|
|00003970| 35 2d 63 68 61 72 29 20 | 43 6f 6d 6d 65 6e 74 2f |5-char) |Comment/|
|00003980| 51 75 6f 74 65 0a 09 64 | 65 66 69 6e 69 74 69 6f |Quote..d|efinitio|
|00003990| 6e 73 2e 20 54 68 69 73 | 20 76 65 72 73 69 6f 6e |ns. This| version|
|000039a0| 20 61 6c 73 6f 20 6e 65 | 65 64 73 20 73 6f 6d 65 | also ne|eds some|
|000039b0| 20 64 79 6e 61 6d 69 63 | 69 74 79 20 66 6f 72 20 | dynamic|ity for |
|000039c0| 69 74 73 0a 09 64 61 74 | 61 20 73 74 72 75 63 74 |its..dat|a struct|
|000039d0| 75 72 65 73 2c 20 61 6e | 64 20 74 68 65 20 61 62 |ures, an|d the ab|
|000039e0| 69 6c 69 74 79 20 74 6f | 20 68 61 6e 64 6c 65 20 |ility to| handle |
|000039f0| 6d 75 6c 74 69 70 6c 65 | 20 66 69 6c 65 20 6e 61 |multiple| file na|
|00003a00| 6d 65 73 0a 09 69 6e 20 | 74 68 65 20 63 6f 6d 6d |mes..in |the comm|
|00003a10| 61 6e 64 20 6c 69 6e 65 | 2e 20 49 66 20 79 6f 75 |and line|. If you|
|00003a20| 20 77 61 6e 74 20 74 6f | 20 61 64 64 20 22 66 65 | want to| add "fe|
|00003a30| 61 74 75 72 65 73 22 2c | 20 79 6f 75 20 6d 61 79 |atures",| you may|
|00003a40| 20 77 69 73 68 0a 09 74 | 6f 20 66 69 72 73 74 20 | wish..t|o first |
|00003a50| 74 68 69 6e 6b 20 61 62 | 6f 75 74 20 69 6d 70 6c |think ab|out impl|
|00003a60| 65 6d 65 6e 74 69 6e 67 | 20 74 68 65 20 22 66 65 |ementing| the "fe|
|00003a70| 61 74 75 72 65 22 20 61 | 73 20 61 6e 20 4d 34 20 |ature" a|s an M4 |
|00003a80| 6d 61 63 72 6f 2e 0a 09 | 49 66 20 79 6f 75 20 72 |macro...|If you r|
|00003a90| 65 61 6c 6c 79 20 77 61 | 6e 74 20 74 6f 20 65 6c |eally wa|nt to el|
|00003aa0| 65 76 61 74 65 20 74 68 | 69 73 20 70 72 6f 63 65 |evate th|is proce|
|00003ab0| 73 73 6f 72 20 69 6e 74 | 6f 20 61 20 6d 6f 72 65 |ssor int|o a more|
|00003ac0| 20 73 74 61 74 65 2d 6f | 66 0a 09 74 68 65 2d 61 | state-o|f..the-a|
|00003ad0| 72 74 20 74 6f 6f 6c 2c | 20 74 68 61 6e 20 79 6f |rt tool,| than yo|
|00003ae0| 75 20 73 68 6f 75 6c 64 | 20 70 72 6f 62 61 62 6c |u should| probabl|
|00003af0| 79 20 72 65 2d 77 72 69 | 74 65 20 69 74 2e 20 5b |y re-wri|te it. [|
|00003b00| 42 75 74 20 49 20 68 61 | 76 65 0a 09 61 6c 72 65 |But I ha|ve..alre|
|00003b10| 61 64 79 20 64 6f 6e 65 | 20 74 68 61 74 2c 20 73 |ady done| that, s|
|00003b20| 6f 20 79 6f 75 20 6d 61 | 79 20 77 69 73 68 20 74 |o you ma|y wish t|
|00003b30| 6f 20 77 61 69 74 20 66 | 6f 72 20 74 68 65 20 47 |o wait f|or the G|
|00003b40| 4e 55 20 76 65 72 73 69 | 6f 6e 20 74 6f 0a 09 67 |NU versi|on to..g|
|00003b50| 65 74 20 61 20 68 65 61 | 64 20 73 74 61 72 74 2e |et a hea|d start.|
|00003b60| 5d 0a 0a 09 46 65 65 64 | 62 61 63 6b 3a 0a 0a 09 |]...Feed|back:...|
|00003b70| 49 66 20 79 6f 75 20 68 | 61 76 65 20 61 6e 79 20 |If you h|ave any |
|00003b80| 69 6d 70 6f 72 74 61 6e | 74 20 66 69 78 65 73 20 |importan|t fixes |
|00003b90| 61 6e 64 2f 6f 72 20 73 | 70 65 65 64 20 69 6d 70 |and/or s|peed imp|
|00003ba0| 72 6f 76 65 6d 65 6e 74 | 73 2c 20 20 49 20 61 6d |rovement|s, I am|
|00003bb0| 0a 09 6d 75 63 68 20 69 | 6e 74 65 72 65 73 74 65 |..much i|ntereste|
|00003bc0| 64 2c 20 73 69 6e 63 65 | 20 6d 79 20 6e 65 77 20 |d, since| my new |
|00003bd0| 76 65 72 73 69 6f 6e 20 | 69 6e 68 65 72 69 74 73 |version |inherits|
|00003be0| 20 73 6f 6d 65 20 63 6f | 64 65 20 66 72 6f 6d 20 | some co|de from |
|00003bf0| 74 68 69 73 0a 09 76 65 | 72 73 69 6f 6e 2e 20 49 |this..ve|rsion. I|
|00003c00| 20 61 6d 20 61 6c 73 6f | 20 69 6e 74 65 72 65 73 | am also| interes|
|00003c10| 74 65 64 20 69 6e 20 68 | 65 61 72 69 6e 67 20 61 |ted in h|earing a|
|00003c20| 62 6f 75 74 20 61 6e 79 | 20 75 6e 69 71 75 65 20 |bout any| unique |
|00003c30| 61 70 70 6c 69 63 61 2d | 0a 09 74 69 6f 6e 73 20 |applica-|..tions |
|00003c40| 6f 66 20 4d 34 2e 20 49 | 20 61 6d 20 6e 6f 74 20 |of M4. I| am not |
|00003c50| 69 6e 74 65 72 65 73 74 | 65 64 20 69 6e 20 67 72 |interest|ed in gr|
|00003c60| 61 74 75 69 74 6f 75 73 | 20 68 61 63 6b 73 20 6f |atuitous| hacks o|
|00003c70| 72 20 22 6e 65 61 74 22 | 0a 09 6b 69 74 63 68 65 |r "neat"|..kitche|
|00003c80| 6e 2d 73 69 6e 6b 20 66 | 65 61 74 75 72 65 73 2e |n-sink f|eatures.|
|00003c90| 20 0a 0a 09 43 6f 6e 74 | 61 63 74 3a 0a 0a 09 09 | ...Cont|act:....|
|00003ca0| 55 73 65 6e 65 74 3a 20 | 5b 64 65 63 76 61 78 7c |Usenet: |[decvax||
|00003cb0| 69 68 6e 70 34 5d 21 75 | 74 7a 6f 6f 21 79 75 6e |ihnp4]!u|tzoo!yun|
|00003cc0| 65 78 75 73 21 6f 7a 20 | 7c 7c 20 0a 09 09 09 20 |exus!oz ||| .... |
|00003cd0| 20 20 20 2e 2e 2e 73 65 | 69 73 6d 6f 21 6d 6e 65 | ...se|ismo!mne|
|00003ce0| 74 6f 72 21 79 75 6e 65 | 78 75 73 21 6f 7a 0a 09 |tor!yune|xus!oz..|
|00003cf0| 09 42 69 74 6e 65 74 3a | 20 6f 7a 40 5b 79 75 6c |.Bitnet:| oz@[yul|
|00003d00| 69 62 72 61 7c 79 75 79 | 65 74 74 69 5d 2e 42 49 |ibra|yuy|etti].BI|
|00003d10| 54 4e 45 54 0a 09 09 50 | 68 6f 6e 65 74 3a 20 5b |TNET...P|honet: [|
|00003d20| 34 31 36 5d 20 37 33 36 | 2d 35 32 35 37 20 78 20 |416] 736|-5257 x |
|00003d30| 33 39 37 36 0a 0a 0a 09 | 65 6e 6a 6f 79 2e 09 6f |3976....|enjoy..o|
|00003d40| 7a 0a 53 48 41 52 5f 45 | 4f 46 0a 66 69 20 23 20 |z.SHAR_E|OF.fi # |
|00003d50| 65 6e 64 20 6f 66 20 6f | 76 65 72 77 72 69 74 69 |end of o|verwriti|
|00003d60| 6e 67 20 63 68 65 63 6b | 0a 65 63 68 6f 20 73 68 |ng check|.echo sh|
|00003d70| 61 72 3a 20 65 78 74 72 | 61 63 74 69 6e 67 20 22 |ar: extr|acting "|
|00003d80| 27 4d 41 4e 49 46 45 53 | 54 27 22 20 27 28 32 33 |'MANIFES|T'" '(23|
|00003d90| 30 20 63 68 61 72 61 63 | 74 65 72 73 29 27 0a 69 |0 charac|ters)'.i|
|00003da0| 66 20 74 65 73 74 20 2d | 66 20 27 4d 41 4e 49 46 |f test -|f 'MANIF|
|00003db0| 45 53 54 27 0a 74 68 65 | 6e 0a 09 65 63 68 6f 20 |EST'.the|n..echo |
|00003dc0| 73 68 61 72 3a 20 77 69 | 6c 6c 20 6e 6f 74 20 6f |shar: wi|ll not o|
|00003dd0| 76 65 72 2d 77 72 69 74 | 65 20 65 78 69 73 74 69 |ver-writ|e existi|
|00003de0| 6e 67 20 66 69 6c 65 20 | 22 27 4d 41 4e 49 46 45 |ng file |"'MANIFE|
|00003df0| 53 54 27 22 0a 65 6c 73 | 65 0a 73 65 64 20 27 73 |ST'".els|e.sed 's|
|00003e00| 2f 5e 09 58 2f 2f 27 20 | 3c 3c 20 5c 53 48 41 52 |/^.X//' |<< \SHAR|
|00003e10| 5f 45 4f 46 20 3e 20 27 | 4d 41 4e 49 46 45 53 54 |_EOF > '|MANIFEST|
|00003e20| 27 0a 09 58 6d 64 65 66 | 2e 68 09 2d 20 64 65 66 |'..Xmdef|.h.- def|
|00003e30| 69 6e 69 74 69 6f 6e 73 | 20 61 6e 64 20 73 74 72 |initions| and str|
|00003e40| 75 63 74 75 72 65 73 0a | 09 58 6d 61 69 6e 2e 63 |uctures.|.Xmain.c|
|00003e50| 09 2d 20 74 68 69 73 20 | 66 69 6c 65 3a 20 64 72 |.- this |file: dr|
|00003e60| 69 76 65 72 20 72 6f 75 | 74 69 6e 65 73 0a 09 58 |iver rou|tines..X|
|00003e70| 65 76 61 6c 2e 63 09 2d | 20 67 65 6e 65 72 61 6c |eval.c.-| general|
|00003e80| 20 6d 61 63 72 6f 20 65 | 76 61 6c 75 61 74 6f 72 | macro e|valuator|
|00003e90| 0a 09 58 73 65 72 76 2e | 63 09 2d 20 73 65 72 76 |..Xserv.|c.- serv|
|00003ea0| 69 63 65 20 72 6f 75 74 | 69 6e 65 73 20 28 64 6f |ice rout|ines (do|
|00003eb0| 78 78 78 78 29 0a 09 58 | 6d 69 73 63 2e 63 09 2d |xxxx)..X|misc.c.-|
|00003ec0| 20 6d 69 73 63 65 6c 6c | 61 6e 65 6f 75 73 20 72 | miscell|aneous r|
|00003ed0| 6f 75 74 69 6e 65 73 0a | 09 58 65 78 70 72 2e 63 |outines.|.Xexpr.c|
|00003ee0| 09 2d 20 65 78 70 72 65 | 73 73 69 6f 6e 20 70 61 |.- expre|ssion pa|
|00003ef0| 72 73 65 72 0a 09 58 6c | 6f 6f 6b 2e 63 09 2d 20 |rser..Xl|ook.c.- |
|00003f00| 68 61 73 68 20 74 61 62 | 6c 65 20 6d 61 6e 61 67 |hash tab|le manag|
|00003f10| 65 6d 65 6e 74 0a 53 48 | 41 52 5f 45 4f 46 0a 69 |ement.SH|AR_EOF.i|
|00003f20| 66 20 74 65 73 74 20 32 | 33 30 20 2d 6e 65 20 22 |f test 2|30 -ne "|
|00003f30| 60 77 63 20 2d 63 20 3c | 20 27 4d 41 4e 49 46 45 |`wc -c <| 'MANIFE|
|00003f40| 53 54 27 60 22 0a 74 68 | 65 6e 0a 09 65 63 68 6f |ST'`".th|en..echo|
|00003f50| 20 73 68 61 72 3a 20 65 | 72 72 6f 72 20 74 72 61 | shar: e|rror tra|
|00003f60| 6e 73 6d 69 74 74 69 6e | 67 20 22 27 4d 41 4e 49 |nsmittin|g "'MANI|
|00003f70| 46 45 53 54 27 22 20 27 | 28 73 68 6f 75 6c 64 20 |FEST'" '|(should |
|00003f80| 68 61 76 65 20 62 65 65 | 6e 20 32 33 30 20 63 68 |have bee|n 230 ch|
|00003f90| 61 72 61 63 74 65 72 73 | 29 27 0a 66 69 0a 66 69 |aracters|)'.fi.fi|
|00003fa0| 20 23 20 65 6e 64 20 6f | 66 20 6f 76 65 72 77 72 | # end o|f overwr|
|00003fb0| 69 74 69 6e 67 20 63 68 | 65 63 6b 0a 65 63 68 6f |iting ch|eck.echo|
|00003fc0| 20 73 68 61 72 3a 20 65 | 78 74 72 61 63 74 69 6e | shar: e|xtractin|
|00003fd0| 67 20 22 27 6d 34 2e 31 | 27 22 20 27 28 39 36 34 |g "'m4.1|'" '(964|
|00003fe0| 34 20 63 68 61 72 61 63 | 74 65 72 73 29 27 0a 69 |4 charac|ters)'.i|
|00003ff0| 66 20 74 65 73 74 20 2d | 66 20 27 6d 34 2e 31 27 |f test -|f 'm4.1'|
|00004000| 0a 74 68 65 6e 0a 09 65 | 63 68 6f 20 73 68 61 72 |.then..e|cho shar|
|00004010| 3a 20 77 69 6c 6c 20 6e | 6f 74 20 6f 76 65 72 2d |: will n|ot over-|
|00004020| 77 72 69 74 65 20 65 78 | 69 73 74 69 6e 67 20 66 |write ex|isting f|
|00004030| 69 6c 65 20 22 27 6d 34 | 2e 31 27 22 0a 65 6c 73 |ile "'m4|.1'".els|
|00004040| 65 0a 73 65 64 20 27 73 | 2f 5e 09 58 2f 2f 27 20 |e.sed 's|/^.X//' |
|00004050| 3c 3c 20 5c 53 48 41 52 | 5f 45 4f 46 20 3e 20 27 |<< \SHAR|_EOF > '|
|00004060| 6d 34 2e 31 27 0a 09 58 | 2e 54 48 20 4d 34 20 6c |m4.1'..X|.TH M4 l|
|00004070| 6f 63 61 6c 20 22 33 30 | 20 41 75 67 20 31 39 38 |ocal "30| Aug 198|
|00004080| 37 22 0a 09 58 2e 44 41 | 20 30 38 20 4a 61 6e 20 |7"..X.DA| 08 Jan |
|00004090| 31 39 38 36 0a 09 58 2e | 53 48 20 4e 41 4d 45 0a |1986..X.|SH NAME.|
|000040a0| 09 58 70 64 20 6d 34 20 | 5c 2d 20 6d 61 63 72 6f |.Xpd m4 |\- macro|
|000040b0| 20 70 72 6f 63 65 73 73 | 6f 72 0a 09 58 2e 53 48 | process|or..X.SH|
|000040c0| 20 4f 52 49 47 49 4e 0a | 09 58 4d 65 74 61 53 79 | ORIGIN.|.XMetaSy|
|000040d0| 73 74 65 6d 73 0a 09 58 | 2e 53 48 20 53 59 4e 4f |stems..X|.SH SYNO|
|000040e0| 50 53 49 53 0a 09 58 2e | 42 49 20 6d 34 20 22 5b |PSIS..X.|BI m4 "[|
|000040f0| 20 6f 70 74 69 6f 6e 73 | 20 5d 22 0a 09 58 2e 53 | options| ]"..X.S|
|00004100| 48 20 44 45 53 43 52 49 | 50 54 49 4f 4e 0a 09 58 |H DESCRI|PTION..X|
|00004110| 2e 49 20 50 64 20 4d 34 | 0a 09 58 69 73 20 61 20 |.I Pd M4|..Xis a |
|00004120| 75 6e 2a 78 20 4d 34 20 | 6c 6f 6f 6b 2d 61 6c 69 |un*x M4 |look-ali|
|00004130| 6b 65 20 6d 61 63 72 6f | 20 70 72 6f 63 65 73 73 |ke macro| process|
|00004140| 6f 72 0a 09 58 69 6e 74 | 65 6e 64 65 64 20 61 73 |or..Xint|ended as|
|00004150| 20 61 20 66 72 6f 6e 74 | 20 65 6e 64 20 66 6f 72 | a front| end for|
|00004160| 20 52 61 74 66 6f 72 2c | 20 50 61 73 63 61 6c 2c | Ratfor,| Pascal,|
|00004170| 20 61 6e 64 20 6f 74 68 | 65 72 20 6c 61 6e 67 75 | and oth|er langu|
|00004180| 61 67 65 73 20 74 68 61 | 74 20 64 6f 20 6e 6f 74 |ages tha|t do not|
|00004190| 0a 09 58 68 61 76 65 20 | 61 20 62 75 69 6c 74 2d |..Xhave |a built-|
|000041a0| 69 6e 20 6d 61 63 72 6f | 20 70 72 6f 63 65 73 73 |in macro| process|
|000041b0| 69 6e 67 20 63 61 70 61 | 62 69 6c 69 74 79 2e 0a |ing capa|bility..|
|000041c0| 09 58 50 64 20 4d 34 20 | 72 65 61 64 73 20 73 74 |.XPd M4 |reads st|
|000041d0| 61 6e 64 61 72 64 20 69 | 6e 70 75 74 2c 20 74 68 |andard i|nput, th|
|000041e0| 65 20 70 72 6f 63 65 73 | 73 65 64 20 74 65 78 74 |e proces|sed text|
|000041f0| 20 69 73 20 77 72 69 74 | 74 65 6e 20 6f 6e 20 74 | is writ|ten on t|
|00004200| 68 65 20 73 74 61 6e 64 | 61 72 64 20 6f 75 74 70 |he stand|ard outp|
|00004210| 75 74 2e 0a 09 58 2e 50 | 50 0a 09 58 54 68 65 20 |ut...X.P|P..XThe |
|00004220| 6f 70 74 69 6f 6e 73 20 | 61 6e 64 20 74 68 65 69 |options |and thei|
|00004230| 72 20 65 66 66 65 63 74 | 73 20 61 72 65 20 61 73 |r effect|s are as|
|00004240| 20 66 6f 6c 6c 6f 77 73 | 3a 0a 09 58 2e 54 50 0a | follows|:..X.TP.|
|00004250| 09 58 5c 66 33 5c 2d 44 | 5c 66 50 5c 66 32 6e 61 |.X\f3\-D|\fP\f2na|
|00004260| 6d 65 5c 5e 5c 66 50 5b | 5c 66 33 3d 5c 66 50 5c |me\^\fP[|\f3=\fP\|
|00004270| 66 32 76 61 6c 5c 5e 5c | 66 50 5d 0a 09 58 44 65 |f2val\^\|fP]..XDe|
|00004280| 66 69 6e 65 73 0a 09 58 | 2e 49 20 6e 61 6d 65 0a |fines..X|.I name.|
|00004290| 09 58 74 6f 0a 09 58 2e | 49 20 76 61 6c 0a 09 58 |.Xto..X.|I val..X|
|000042a0| 6f 72 20 74 6f 20 6e 75 | 6c 6c 20 69 6e 0a 09 58 |or to nu|ll in..X|
|000042b0| 2e 49 52 20 76 61 6c 20 | 27 73 0a 09 58 61 62 73 |.IR val |'s..Xabs|
|000042c0| 65 6e 63 65 2e 0a 09 58 | 2e 54 50 0a 09 58 2e 42 |ence...X|.TP..X.B|
|000042d0| 49 20 5c 2d 55 20 6e 61 | 6d 65 0a 09 58 75 6e 64 |I \-U na|me..Xund|
|000042e0| 65 66 69 6e 65 73 0a 09 | 58 2e 49 52 20 6e 61 6d |efines..|X.IR nam|
|000042f0| 65 20 2e 0a 09 58 2e 50 | 50 0a 09 58 4d 61 63 72 |e ...X.P|P..XMacr|
|00004300| 6f 20 63 61 6c 6c 73 0a | 09 58 68 61 76 65 20 74 |o calls.|.Xhave t|
|00004310| 68 65 20 66 6f 72 6d 3a | 0a 09 58 2e 50 50 0a 09 |he form:|..X.PP..|
|00004320| 58 2e 52 53 0a 09 58 5c | 66 42 6e 61 6d 65 5c 66 |X.RS..X\|fBname\f|
|00004330| 49 28 61 72 67 31 2c 61 | 72 67 32 2c 20 2e 5c 7c |I(arg1,a|rg2, .\||
|00004340| 2e 5c 7c 2e 2c 20 61 72 | 67 6e 29 5c 66 52 0a 09 |.\|., ar|gn)\fR..|
|00004350| 58 2e 52 45 0a 09 58 2e | 50 50 0a 09 58 54 68 65 |X.RE..X.|PP..XThe|
|00004360| 0a 09 58 2e 42 20 28 0a | 09 58 6d 75 73 74 20 69 |..X.B (.|.Xmust i|
|00004370| 6d 6d 65 64 69 61 74 65 | 6c 79 20 66 6f 6c 6c 6f |mmediate|ly follo|
|00004380| 77 20 74 68 65 20 6e 61 | 6d 65 20 6f 66 20 74 68 |w the na|me of th|
|00004390| 65 20 6d 61 63 72 6f 2e | 0a 09 58 49 66 20 74 68 |e macro.|..XIf th|
|000043a0| 65 20 6e 61 6d 65 20 6f | 66 20 61 20 64 65 66 69 |e name o|f a defi|
|000043b0| 6e 65 64 20 6d 61 63 72 | 6f 20 69 73 20 6e 6f 74 |ned macr|o is not|
|000043c0| 20 66 6f 6c 6c 6f 77 65 | 64 20 62 79 20 61 0a 09 | followe|d by a..|
|000043d0| 58 2e 42 52 20 28 20 2c | 0a 09 58 69 74 20 69 73 |X.BR ( ,|..Xit is|
|000043e0| 20 74 61 6b 65 6e 20 74 | 6f 20 62 65 20 61 20 63 | taken t|o be a c|
|000043f0| 61 6c 6c 20 6f 66 20 74 | 68 61 74 20 6d 61 63 72 |all of t|hat macr|
|00004400| 6f 20 77 69 74 68 20 6e | 6f 20 61 72 67 75 6d 65 |o with n|o argume|
|00004410| 6e 74 73 2c 20 69 2e 65 | 2e 20 6e 61 6d 65 28 29 |nts, i.e|. name()|
|00004420| 2e 0a 09 58 50 6f 74 65 | 6e 74 69 61 6c 20 6d 61 |...XPote|ntial ma|
|00004430| 63 72 6f 20 6e 61 6d 65 | 73 20 63 6f 6e 73 69 73 |cro name|s consis|
|00004440| 74 20 6f 66 20 61 6c 70 | 68 61 62 65 74 69 63 20 |t of alp|habetic |
|00004450| 6c 65 74 74 65 72 73 20 | 61 6e 64 20 64 69 67 69 |letters |and digi|
|00004460| 74 73 2e 0a 09 58 2e 50 | 50 0a 09 58 4c 65 61 64 |ts...X.P|P..XLead|
|00004470| 69 6e 67 20 75 6e 71 75 | 6f 74 65 64 20 62 6c 61 |ing unqu|oted bla|
|00004480| 6e 6b 73 2c 20 74 61 62 | 73 20 61 6e 64 20 6e 65 |nks, tab|s and ne|
|00004490| 77 6c 69 6e 65 73 20 61 | 72 65 20 69 67 6e 6f 72 |wlines a|re ignor|
|000044a0| 65 64 20 77 68 69 6c 65 | 20 63 6f 6c 6c 65 63 74 |ed while| collect|
|000044b0| 69 6e 67 20 0a 09 58 61 | 72 67 75 6d 65 6e 74 73 |ing ..Xa|rguments|
|000044c0| 2e 0a 09 58 4c 65 66 74 | 20 61 6e 64 20 72 69 67 |...XLeft| and rig|
|000044d0| 68 74 20 73 69 6e 67 6c | 65 20 71 75 6f 74 65 73 |ht singl|e quotes|
|000044e0| 20 61 72 65 20 75 73 65 | 64 20 74 6f 20 71 75 6f | are use|d to quo|
|000044f0| 74 65 20 73 74 72 69 6e | 67 73 2e 0a 09 58 54 68 |te strin|gs...XTh|
|00004500| 65 20 76 61 6c 75 65 20 | 6f 66 20 61 20 71 75 6f |e value |of a quo|
|00004510| 74 65 64 20 73 74 72 69 | 6e 67 20 69 73 20 74 68 |ted stri|ng is th|
|00004520| 65 20 73 74 72 69 6e 67 | 20 73 74 72 69 70 70 65 |e string| strippe|
|00004530| 64 20 6f 66 20 74 68 65 | 20 71 75 6f 74 65 73 2e |d of the| quotes.|
|00004540| 0a 09 58 2e 50 50 0a 09 | 58 57 68 65 6e 20 61 20 |..X.PP..|XWhen a |
|00004550| 6d 61 63 72 6f 20 6e 61 | 6d 65 20 69 73 20 72 65 |macro na|me is re|
|00004560| 63 6f 67 6e 69 7a 65 64 | 2c 0a 09 58 69 74 73 20 |cognized|,..Xits |
|00004570| 61 72 67 75 6d 65 6e 74 | 73 20 61 72 65 20 63 6f |argument|s are co|
|00004580| 6c 6c 65 63 74 65 64 20 | 62 79 20 73 65 61 72 63 |llected |by searc|
|00004590| 68 69 6e 67 20 66 6f 72 | 20 61 20 6d 61 74 63 68 |hing for| a match|
|000045a0| 69 6e 67 0a 09 58 2e 42 | 52 20 29 20 2e 0a 09 58 |ing..X.B|R ) ...X|
|000045b0| 49 66 20 66 65 77 65 72 | 20 61 72 67 75 6d 65 6e |If fewer| argumen|
|000045c0| 74 73 20 61 72 65 20 73 | 75 70 70 6c 69 65 64 20 |ts are s|upplied |
|000045d0| 74 68 61 6e 20 61 72 65 | 20 69 6e 20 74 68 65 20 |than are| in the |
|000045e0| 6d 61 63 72 6f 20 64 65 | 66 69 6e 69 74 69 6f 6e |macro de|finition|
|000045f0| 2c 0a 09 58 74 68 65 20 | 74 72 61 69 6c 69 6e 67 |,..Xthe |trailing|
|00004600| 20 61 72 67 75 6d 65 6e | 74 73 20 61 72 65 20 74 | argumen|ts are t|
|00004610| 61 6b 65 6e 20 74 6f 20 | 62 65 20 6e 75 6c 6c 2e |aken to |be null.|
|00004620| 0a 09 58 4d 61 63 72 6f | 20 65 76 61 6c 75 61 74 |..XMacro| evaluat|
|00004630| 69 6f 6e 20 70 72 6f 63 | 65 65 64 73 20 6e 6f 72 |ion proc|eeds nor|
|00004640| 6d 61 6c 6c 79 20 64 75 | 72 69 6e 67 20 74 68 65 |mally du|ring the|
|00004650| 20 63 6f 6c 6c 65 63 74 | 69 6f 6e 20 6f 66 20 74 | collect|ion of t|
|00004660| 68 65 20 61 72 67 75 6d | 65 6e 74 73 2c 0a 09 58 |he argum|ents,..X|
|00004670| 61 6e 64 20 61 6e 79 20 | 63 6f 6d 6d 61 73 20 6f |and any |commas o|
|00004680| 72 20 72 69 67 68 74 20 | 70 61 72 65 6e 74 68 65 |r right |parenthe|
|00004690| 73 65 73 0a 09 58 77 68 | 69 63 68 20 68 61 70 70 |ses..Xwh|ich happ|
|000046a0| 65 6e 20 74 6f 20 74 75 | 72 6e 20 75 70 20 77 69 |en to tu|rn up wi|
|000046b0| 74 68 69 6e 20 74 68 65 | 20 76 61 6c 75 65 20 6f |thin the| value o|
|000046c0| 66 20 61 20 6e 65 73 74 | 65 64 0a 09 58 63 61 6c |f a nest|ed..Xcal|
|000046d0| 6c 20 61 72 65 20 61 73 | 20 65 66 66 65 63 74 69 |l are as| effecti|
|000046e0| 76 65 20 61 73 20 74 68 | 6f 73 65 20 69 6e 20 74 |ve as th|ose in t|
|000046f0| 68 65 20 6f 72 69 67 69 | 6e 61 6c 20 69 6e 70 75 |he origi|nal inpu|
|00004700| 74 20 74 65 78 74 2e 20 | 28 54 68 69 73 20 69 73 |t text. |(This is|
|00004710| 20 74 79 70 69 63 61 6c | 6c 79 0a 09 58 72 65 66 | typical|ly..Xref|
|00004720| 65 72 72 65 64 20 61 73 | 0a 09 58 2e 49 20 69 6e |erred as|..X.I in|
|00004730| 73 69 64 65 2d 6f 75 74 | 0a 09 58 6d 61 63 72 6f |side-out|..Xmacro|
|00004740| 20 65 78 70 61 6e 73 69 | 6f 6e 2e 29 0a 09 58 41 | expansi|on.)..XA|
|00004750| 66 74 65 72 20 61 72 67 | 75 6d 65 6e 74 20 63 6f |fter arg|ument co|
|00004760| 6c 6c 65 63 74 69 6f 6e | 2c 0a 09 58 74 68 65 20 |llection|,..Xthe |
|00004770| 76 61 6c 75 65 20 6f 66 | 20 74 68 65 20 6d 61 63 |value of| the mac|
|00004780| 72 6f 20 69 73 20 70 75 | 73 68 65 64 20 62 61 63 |ro is pu|shed bac|
|00004790| 6b 20 6f 6e 74 6f 20 74 | 68 65 20 69 6e 70 75 74 |k onto t|he input|
|000047a0| 20 73 74 72 65 61 6d 0a | 09 58 61 6e 64 20 72 65 | stream.|.Xand re|
|000047b0| 73 63 61 6e 6e 65 64 2e | 0a 09 58 2e 50 50 0a 09 |scanned.|..X.PP..|
|000047c0| 58 2e 49 20 50 64 20 4d | 34 0a 09 58 6d 61 6b 65 |X.I Pd M|4..Xmake|
|000047d0| 73 20 61 76 61 69 6c 61 | 62 6c 65 20 74 68 65 20 |s availa|ble the |
|000047e0| 66 6f 6c 6c 6f 77 69 6e | 67 20 62 75 69 6c 74 2d |followin|g built-|
|000047f0| 69 6e 20 6d 61 63 72 6f | 73 2e 0a 09 58 54 68 65 |in macro|s...XThe|
|00004800| 79 20 6d 61 79 20 62 65 | 20 72 65 64 65 66 69 6e |y may be| redefin|
|00004810| 65 64 2c 20 62 75 74 20 | 6f 6e 63 65 20 74 68 69 |ed, but |once thi|
|00004820| 73 20 69 73 20 64 6f 6e | 65 20 74 68 65 20 6f 72 |s is don|e the or|
|00004830| 69 67 69 6e 61 6c 20 6d | 65 61 6e 69 6e 67 20 69 |iginal m|eaning i|
|00004840| 73 20 6c 6f 73 74 2e 0a | 09 58 54 68 65 69 72 20 |s lost..|.XTheir |
|00004850| 76 61 6c 75 65 73 20 61 | 72 65 20 6e 75 6c 6c 20 |values a|re null |
|00004860| 75 6e 6c 65 73 73 20 6f | 74 68 65 72 77 69 73 65 |unless o|therwise|
|00004870| 20 73 74 61 74 65 64 2e | 0a 09 58 2e 64 65 20 4d | stated.|..X.de M|
|00004880| 43 0a 09 58 2e 54 50 20 | 31 34 0a 09 58 2e 42 20 |C..X.TP |14..X.B |
|00004890| 5c 5c 24 31 0a 09 58 75 | 73 61 67 65 3a 20 5c 5c |\\$1..Xu|sage: \\|
|000048a0| 66 49 5c 5c 24 31 5c 5c | 24 32 5c 5c 66 52 0a 09 |fI\\$1\\|$2\\fR..|
|000048b0| 58 2e 62 72 0a 09 58 2e | 2e 0a 09 58 2e 4d 43 20 |X.br..X.|...X.MC |
|000048c0| 64 65 66 69 6e 65 20 22 | 28 6e 61 6d 65 20 5b 2c |define "|(name [,|
|000048d0| 20 76 61 6c 5d 29 22 0a | 09 58 74 68 65 20 73 65 | val])".|.Xthe se|
|000048e0| 63 6f 6e 64 20 61 72 67 | 75 6d 65 6e 74 20 69 73 |cond arg|ument is|
|000048f0| 20 69 6e 73 74 61 6c 6c | 65 64 20 61 73 20 74 68 | install|ed as th|
|00004900| 65 20 76 61 6c 75 65 20 | 6f 66 20 74 68 65 20 6d |e value |of the m|
|00004910| 61 63 72 6f 0a 09 58 77 | 68 6f 73 65 20 6e 61 6d |acro..Xw|hose nam|
|00004920| 65 20 69 73 20 74 68 65 | 20 66 69 72 73 74 20 61 |e is the| first a|
|00004930| 72 67 75 6d 65 6e 74 2e | 20 49 66 20 74 68 65 72 |rgument.| If ther|
|00004940| 65 20 69 73 20 6e 6f 20 | 73 65 63 6f 6e 64 20 61 |e is no |second a|
|00004950| 72 67 75 6d 65 6e 74 2c | 0a 09 58 74 68 65 20 76 |rgument,|..Xthe v|
|00004960| 61 6c 75 65 20 69 73 20 | 6e 75 6c 6c 2e 0a 09 58 |alue is |null...X|
|00004970| 45 61 63 68 20 6f 63 63 | 75 72 72 65 6e 63 65 20 |Each occ|urrence |
|00004980| 6f 66 0a 09 58 2e 42 49 | 20 24 20 6e 0a 09 58 69 |of..X.BI| $ n..Xi|
|00004990| 6e 20 74 68 65 20 72 65 | 70 6c 61 63 65 6d 65 6e |n the re|placemen|
|000049a0| 74 20 74 65 78 74 2c 0a | 09 58 77 68 65 72 65 0a |t text,.|.Xwhere.|
|000049b0| 09 58 2e 49 20 6e 0a 09 | 58 69 73 20 61 20 64 69 |.X.I n..|Xis a di|
|000049c0| 67 69 74 2c 0a 09 58 69 | 73 20 72 65 70 6c 61 63 |git,..Xi|s replac|
|000049d0| 65 64 20 62 79 20 74 68 | 65 0a 09 58 2e 49 52 20 |ed by th|e..X.IR |
|000049e0| 6e 20 2d 74 68 0a 09 58 | 61 72 67 75 6d 65 6e 74 |n -th..X|argument|
|000049f0| 2e 0a 09 58 41 72 67 75 | 6d 65 6e 74 20 30 20 69 |...XArgu|ment 0 i|
|00004a00| 73 20 74 68 65 20 6e 61 | 6d 65 20 6f 66 20 74 68 |s the na|me of th|
|00004a10| 65 20 6d 61 63 72 6f 3b | 0a 09 58 6d 69 73 73 69 |e macro;|..Xmissi|
|00004a20| 6e 67 20 61 72 67 75 6d | 65 6e 74 73 20 61 72 65 |ng argum|ents are|
|00004a30| 20 72 65 70 6c 61 63 65 | 64 20 62 79 20 74 68 65 | replace|d by the|
|00004a40| 20 6e 75 6c 6c 20 73 74 | 72 69 6e 67 2e 0a 09 58 | null st|ring...X|
|00004a50| 2e 4d 43 20 64 65 66 6e | 20 22 28 6e 61 6d 65 20 |.MC defn| "(name |
|00004a60| 5b 2c 20 6e 61 6d 65 20 | 2e 2e 2e 5d 29 0a 09 58 |[, name |...])..X|
|00004a70| 72 65 74 75 72 6e 73 20 | 74 68 65 20 71 75 6f 74 |returns |the quot|
|00004a80| 65 64 20 64 65 66 69 6e | 69 74 69 6f 6e 20 6f 66 |ed defin|ition of|
|00004a90| 20 69 74 73 20 61 72 67 | 75 6d 65 6e 74 28 73 29 | its arg|ument(s)|
|00004aa0| 2e 20 55 73 65 66 75 6c | 20 69 6e 20 72 65 6e 61 |. Useful| in rena|
|00004ab0| 6d 69 6e 67 0a 09 58 6d | 61 63 72 6f 73 2e 0a 09 |ming..Xm|acros...|
|00004ac0| 58 2e 4d 43 20 75 6e 64 | 65 66 69 6e 65 20 22 28 |X.MC und|efine "(|
|00004ad0| 6e 61 6d 65 20 5b 2c 20 | 6e 61 6d 65 20 2e 2e 2e |name [, |name ...|
|00004ae0| 5d 29 22 0a 09 58 72 65 | 6d 6f 76 65 73 20 74 68 |])"..Xre|moves th|
|00004af0| 65 20 64 65 66 69 6e 69 | 74 69 6f 6e 20 6f 66 20 |e defini|tion of |
|00004b00| 74 68 65 20 6d 61 63 72 | 6f 28 73 29 20 6e 61 6d |the macr|o(s) nam|
|00004b10| 65 64 2e 20 49 66 20 74 | 68 65 72 65 20 69 73 0a |ed. If t|here is.|
|00004b20| 09 58 6d 6f 72 65 20 74 | 68 61 6e 20 6f 6e 65 20 |.Xmore t|han one |
|00004b30| 64 65 66 69 6e 69 74 69 | 6f 6e 20 66 6f 72 20 74 |definiti|on for t|
|00004b40| 68 65 20 6e 61 6d 65 64 | 20 6d 61 63 72 6f 2c 20 |he named| macro, |
|00004b50| 28 64 75 65 20 74 6f 20 | 70 72 65 76 69 6f 75 73 |(due to |previous|
|00004b60| 20 75 73 65 20 6f 66 0a | 09 58 2e 49 52 20 70 75 | use of.|.X.IR pu|
|00004b70| 73 68 64 65 66 20 29 20 | 0a 09 58 61 6c 6c 20 64 |shdef ) |..Xall d|
|00004b80| 65 66 69 6e 69 74 69 6f | 6e 73 20 61 72 65 20 72 |efinitio|ns are r|
|00004b90| 65 6d 6f 76 65 64 2e 0a | 09 58 2e 4d 43 20 70 75 |emoved..|.X.MC pu|
|00004ba0| 73 68 64 65 66 20 22 28 | 6e 61 6d 65 20 5b 2c 20 |shdef "(|name [, |
|00004bb0| 76 61 6c 5d 29 22 0a 09 | 58 6c 69 6b 65 0a 09 58 |val])"..|Xlike..X|
|00004bc0| 2e 49 52 20 64 65 66 69 | 6e 65 20 2c 0a 09 58 62 |.IR defi|ne ,..Xb|
|00004bd0| 75 74 20 73 61 76 65 73 | 20 61 6e 79 20 70 72 65 |ut saves| any pre|
|00004be0| 76 69 6f 75 73 20 64 65 | 66 69 6e 69 74 69 6f 6e |vious de|finition|
|00004bf0| 20 62 79 20 73 74 61 63 | 6b 69 6e 67 20 74 68 65 | by stac|king the|
|00004c00| 20 63 75 72 72 65 6e 74 | 20 64 65 66 69 6e 69 74 | current| definit|
|00004c10| 69 6f 6e 2e 0a 09 58 2e | 4d 43 20 70 6f 70 64 65 |ion...X.|MC popde|
|00004c20| 66 20 22 28 6e 61 6d 65 | 20 5b 2c 20 6e 61 6d 65 |f "(name| [, name|
|00004c30| 20 2e 2e 2e 5d 29 22 0a | 09 58 72 65 6d 6f 76 65 | ...])".|.Xremove|
|00004c40| 73 20 63 75 72 72 65 6e | 74 20 64 65 66 69 6e 69 |s curren|t defini|
|00004c50| 74 69 6f 6e 20 6f 66 20 | 69 74 73 20 61 72 67 75 |tion of |its argu|
|00004c60| 6d 65 6e 74 28 73 29 2c | 0a 09 58 65 78 70 6f 73 |ment(s),|..Xexpos|
|00004c70| 69 6e 67 20 74 68 65 20 | 70 72 65 76 69 6f 75 73 |ing the |previous|
|00004c80| 20 6f 6e 65 20 69 66 20 | 61 6e 79 2e 0a 09 58 2e | one if |any...X.|
|00004c90| 4d 43 20 69 66 64 65 66 | 20 22 28 6e 61 6d 65 2c |MC ifdef| "(name,|
|00004ca0| 20 69 66 2d 64 65 66 20 | 5b 2c 20 69 66 6e 6f 74 | if-def |[, ifnot|
|00004cb0| 2d 64 65 66 5d 29 22 0a | 09 58 69 66 20 74 68 65 |-def])".|.Xif the|
|00004cc0| 20 66 69 72 73 74 20 61 | 72 67 75 6d 65 6e 74 20 | first a|rgument |
|00004cd0| 69 73 20 64 65 66 69 6e | 65 64 2c 20 74 68 65 20 |is defin|ed, the |
|00004ce0| 76 61 6c 75 65 20 69 73 | 20 74 68 65 20 73 65 63 |value is| the sec|
|00004cf0| 6f 6e 64 20 61 72 67 75 | 6d 65 6e 74 2c 20 0a 09 |ond argu|ment, ..|
|00004d00| 58 6f 74 68 65 72 77 69 | 73 65 20 74 68 65 20 74 |Xotherwi|se the t|
|00004d10| 68 69 72 64 2e 0a 09 58 | 49 66 20 74 68 65 72 65 |hird...X|If there|
|00004d20| 20 69 73 20 6e 6f 20 74 | 68 69 72 64 20 61 72 67 | is no t|hird arg|
|00004d30| 75 6d 65 6e 74 2c 20 74 | 68 65 20 76 61 6c 75 65 |ument, t|he value|
|00004d40| 20 69 73 20 6e 75 6c 6c | 2e 0a 09 58 41 20 77 6f | is null|...XA wo|
|00004d50| 72 64 20 69 6e 64 69 63 | 61 74 69 6e 67 20 74 68 |rd indic|ating th|
|00004d60| 65 20 63 75 72 72 65 6e | 74 20 6f 70 65 72 61 74 |e curren|t operat|
|00004d70| 69 6e 67 20 73 79 73 74 | 65 6d 20 69 73 20 70 72 |ing syst|em is pr|
|00004d80| 65 64 65 66 69 6e 65 64 | 2e 0a 09 58 28 65 2e 67 |edefined|...X(e.g|
|00004d90| 2e 0a 09 58 2e 49 20 75 | 6e 69 78 0a 09 58 6f 72 |...X.I u|nix..Xor|
|00004da0| 0a 09 58 2e 49 52 20 76 | 6d 73 20 29 0a 09 58 2e |..X.IR v|ms )..X.|
|00004db0| 4d 43 20 73 68 69 66 74 | 20 22 28 61 72 67 2c 20 |MC shift| "(arg, |
|00004dc0| 61 72 67 2c 20 61 72 67 | 2c 20 2e 2e 2e 29 22 0a |arg, arg|, ...)".|
|00004dd0| 09 58 72 65 74 75 72 6e | 73 20 61 6c 6c 20 62 75 |.Xreturn|s all bu|
|00004de0| 74 20 69 74 73 20 66 69 | 72 73 74 20 61 72 67 75 |t its fi|rst argu|
|00004df0| 6d 65 6e 74 2e 0a 09 58 | 54 68 65 20 6f 74 68 65 |ment...X|The othe|
|00004e00| 72 20 61 72 67 75 6d 65 | 6e 74 73 20 61 72 65 20 |r argume|nts are |
|00004e10| 71 75 6f 74 65 64 20 61 | 6e 64 20 70 75 73 68 65 |quoted a|nd pushe|
|00004e20| 64 20 62 61 63 6b 20 77 | 69 74 68 0a 09 58 63 6f |d back w|ith..Xco|
|00004e30| 6d 6d 61 73 20 69 6e 20 | 62 65 74 77 65 65 6e 2e |mmas in |between.|
|00004e40| 0a 09 58 54 68 65 20 71 | 75 6f 74 69 6e 67 20 6e |..XThe q|uoting n|
|00004e50| 75 6c 6c 69 66 69 65 73 | 20 74 68 65 20 65 66 66 |ullifies| the eff|
|00004e60| 65 63 74 20 6f 66 20 74 | 68 65 20 65 78 74 72 61 |ect of t|he extra|
|00004e70| 20 73 63 61 6e 20 74 68 | 61 74 0a 09 58 77 69 6c | scan th|at..Xwil|
|00004e80| 6c 20 73 75 62 73 65 71 | 75 65 6e 74 6c 79 20 62 |l subseq|uently b|
|00004e90| 65 20 70 65 72 66 6f 72 | 6d 65 64 2e 0a 09 58 2e |e perfor|med...X.|
|00004ea0| 4d 43 20 63 68 61 6e 67 | 65 71 75 6f 74 65 20 22 |MC chang|equote "|
|00004eb0| 28 6c 71 63 68 61 72 2c | 20 72 71 63 68 61 72 29 |(lqchar,| rqchar)|
|00004ec0| 22 0a 09 58 63 68 61 6e | 67 65 20 71 75 6f 74 65 |"..Xchan|ge quote|
|00004ed0| 20 73 79 6d 62 6f 6c 73 | 20 74 6f 20 74 68 65 20 | symbols| to the |
|00004ee0| 66 69 72 73 74 20 61 6e | 64 20 73 65 63 6f 6e 64 |first an|d second|
|00004ef0| 20 61 72 67 75 6d 65 6e | 74 73 2e 0a 09 58 57 69 | argumen|ts...XWi|
|00004f00| 74 68 20 6e 6f 20 61 72 | 67 75 6d 65 6e 74 73 2c |th no ar|guments,|
|00004f10| 20 74 68 65 20 71 75 6f | 74 65 73 20 61 72 65 20 | the quo|tes are |
|00004f20| 72 65 73 65 74 20 62 61 | 63 6b 20 74 6f 20 74 68 |reset ba|ck to th|
|00004f30| 65 20 64 65 66 61 75 6c | 74 0a 09 58 63 68 61 72 |e defaul|t..Xchar|
|00004f40| 61 63 74 65 72 73 2e 20 | 28 69 2e 65 2e 2c 20 5c |acters. |(i.e., \|
|00004f50| 2a 60 5c 7c 5c 2a 27 29 | 2e 0a 09 58 2e 4d 43 20 |*`\|\*')|...X.MC |
|00004f60| 63 68 61 6e 67 65 63 6f | 6d 20 22 28 6c 63 63 68 |changeco|m "(lcch|
|00004f70| 61 72 2c 20 72 63 63 68 | 61 72 29 22 0a 09 58 63 |ar, rcch|ar)"..Xc|
|00004f80| 68 61 6e 67 65 20 6c 65 | 66 74 20 61 6e 64 20 72 |hange le|ft and r|
|00004f90| 69 67 68 74 20 63 6f 6d | 6d 65 6e 74 20 6d 61 72 |ight com|ment mar|
|00004fa0| 6b 65 72 73 20 66 72 6f | 6d 20 74 68 65 20 64 65 |kers fro|m the de|
|00004fb0| 66 61 75 6c 74 0a 09 58 | 2e 42 20 23 0a 09 58 61 |fault..X|.B #..Xa|
|00004fc0| 6e 64 20 0a 09 58 2e 42 | 52 20 6e 65 77 6c 69 6e |nd ..X.B|R newlin|
|00004fd0| 65 20 2e 0a 09 58 57 69 | 74 68 20 6e 6f 20 61 72 |e ...XWi|th no ar|
|00004fe0| 67 75 6d 65 6e 74 73 2c | 20 74 68 65 20 63 6f 6d |guments,| the com|
|00004ff0| 6d 65 6e 74 20 6d 65 63 | 68 61 6e 69 73 6d 20 69 |ment mec|hanism i|
|00005000| 73 20 72 65 73 65 74 20 | 62 61 63 6b 20 74 6f 20 |s reset |back to |
|00005010| 0a 09 58 74 68 65 20 64 | 65 66 61 75 6c 74 20 63 |..Xthe d|efault c|
|00005020| 68 61 72 61 63 74 65 72 | 73 2e 0a 09 58 57 69 74 |haracter|s...XWit|
|00005030| 68 20 6f 6e 65 20 61 72 | 67 75 6d 65 6e 74 2c 20 |h one ar|gument, |
|00005040| 74 68 65 20 6c 65 66 74 | 20 6d 61 72 6b 65 72 20 |the left| marker |
|00005050| 62 65 63 6f 6d 65 73 20 | 74 68 65 20 61 72 67 75 |becomes |the argu|
|00005060| 6d 65 6e 74 20 61 6e 64 | 0a 09 58 74 68 65 20 72 |ment and|..Xthe r|
|00005070| 69 67 68 74 20 6d 61 72 | 6b 65 72 20 62 65 63 6f |ight mar|ker beco|
|00005080| 6d 65 73 20 6e 65 77 6c | 69 6e 65 2e 0a 09 58 57 |mes newl|ine...XW|
|00005090| 69 74 68 20 74 77 6f 20 | 61 72 67 75 6d 65 6e 74 |ith two |argument|
|000050a0| 73 2c 20 62 6f 74 68 20 | 6d 61 72 6b 65 72 73 20 |s, both |markers |
|000050b0| 61 72 65 20 61 66 66 65 | 63 74 65 64 2e 0a 09 58 |are affe|cted...X|
|000050c0| 2e 4d 43 20 64 69 76 65 | 72 74 20 22 28 64 69 76 |.MC dive|rt "(div|
|000050d0| 6e 75 6d 29 22 0a 09 58 | 2e 49 20 6d 34 0a 09 58 |num)"..X|.I m4..X|
|000050e0| 6d 61 69 6e 74 61 69 6e | 73 20 31 30 20 6f 75 74 |maintain|s 10 out|
|000050f0| 70 75 74 20 73 74 72 65 | 61 6d 73 2c 0a 09 58 6e |put stre|ams,..Xn|
|00005100| 75 6d 62 65 72 65 64 20 | 30 2d 39 2e 20 20 69 6e |umbered |0-9. in|
|00005110| 69 74 69 61 6c 6c 79 20 | 73 74 72 65 61 6d 20 30 |itially |stream 0|
|00005120| 20 69 73 20 74 68 65 20 | 63 75 72 72 65 6e 74 20 | is the |current |
|00005130| 73 74 72 65 61 6d 2e 20 | 0a 09 58 54 68 65 0a 09 |stream. |..XThe..|
|00005140| 58 2e 49 20 64 69 76 65 | 72 74 0a 09 58 6d 61 63 |X.I dive|rt..Xmac|
|00005150| 72 6f 20 63 68 61 6e 67 | 65 73 20 74 68 65 20 63 |ro chang|es the c|
|00005160| 75 72 72 65 6e 74 20 6f | 75 74 70 75 74 20 73 74 |urrent o|utput st|
|00005170| 72 65 61 6d 20 74 6f 20 | 69 74 73 20 28 64 69 67 |ream to |its (dig|
|00005180| 69 74 2d 73 74 72 69 6e | 67 29 0a 09 58 61 72 67 |it-strin|g)..Xarg|
|00005190| 75 6d 65 6e 74 2e 0a 09 | 58 4f 75 74 70 75 74 20 |ument...|XOutput |
|000051a0| 64 69 76 65 72 74 65 64 | 20 74 6f 20 61 20 73 74 |diverted| to a st|
|000051b0| 72 65 61 6d 20 6f 74 68 | 65 72 20 74 68 61 6e 20 |ream oth|er than |
|000051c0| 30 20 74 68 72 6f 75 67 | 68 20 39 0a 09 58 64 69 |0 throug|h 9..Xdi|
|000051d0| 73 61 70 70 65 61 72 73 | 20 69 6e 74 6f 20 62 69 |sappears| into bi|
|000051e0| 74 62 75 63 6b 65 74 2e | 0a 09 58 2e 4d 43 20 75 |tbucket.|..X.MC u|
|000051f0| 6e 64 69 76 65 72 74 20 | 22 28 5b 64 69 76 6e 75 |ndivert |"([divnu|
|00005200| 6d 20 5b 2c 20 64 69 76 | 6e 75 6d 20 2e 2e 2e 5d |m [, div|num ...]|
|00005210| 5d 29 22 0a 09 58 63 61 | 75 73 65 73 20 69 6d 6d |])"..Xca|uses imm|
|00005220| 65 64 69 61 74 65 20 6f | 75 74 70 75 74 20 6f 66 |ediate o|utput of|
|00005230| 20 74 65 78 74 20 66 72 | 6f 6d 20 64 69 76 65 72 | text fr|om diver|
|00005240| 73 69 6f 6e 73 20 6e 61 | 6d 65 64 20 61 73 0a 09 |sions na|med as..|
|00005250| 58 61 72 67 75 6d 65 6e | 74 28 73 29 2c 20 6f 72 |Xargumen|t(s), or|
|00005260| 20 61 6c 6c 20 64 69 76 | 65 72 73 69 6f 6e 73 20 | all div|ersions |
|00005270| 69 66 20 6e 6f 20 61 72 | 67 75 6d 65 6e 74 2e 0a |if no ar|gument..|
|00005280| 09 58 54 65 78 74 20 6d | 61 79 20 62 65 20 75 6e |.XText m|ay be un|
|00005290| 64 69 76 65 72 74 65 64 | 20 69 6e 74 6f 20 61 6e |diverted| into an|
|000052a0| 6f 74 68 65 72 20 64 69 | 76 65 72 73 69 6f 6e 2e |other di|version.|
|000052b0| 0a 09 58 55 6e 64 69 76 | 65 72 74 69 6e 67 20 64 |..XUndiv|erting d|
|000052c0| 69 73 63 61 72 64 73 20 | 74 68 65 20 64 69 76 65 |iscards |the dive|
|000052d0| 72 74 65 64 20 74 65 78 | 74 2e 20 41 74 20 74 68 |rted tex|t. At th|
|000052e0| 65 20 65 6e 64 20 6f 66 | 20 69 6e 70 75 74 20 70 |e end of| input p|
|000052f0| 72 6f 63 65 73 73 69 6e | 67 2c 0a 09 58 2e 49 20 |rocessin|g,..X.I |
|00005300| 4d 34 0a 09 58 66 6f 72 | 63 65 73 20 61 6e 20 61 |M4..Xfor|ces an a|
|00005310| 75 74 6f 6d 61 74 69 63 | 0a 09 58 2e 49 52 20 75 |utomatic|..X.IR u|
|00005320| 6e 64 69 76 65 72 74 20 | 2c 0a 09 58 75 6e 6c 65 |ndivert |,..Xunle|
|00005330| 73 73 0a 09 58 2e 49 20 | 6d 34 77 72 61 70 0a 09 |ss..X.I |m4wrap..|
|00005340| 58 69 73 20 64 65 66 69 | 6e 65 64 2e 0a 09 58 2e |Xis defi|ned...X.|
|00005350| 4d 43 20 64 69 76 6e 75 | 6d 20 22 28 29 22 0a 09 |MC divnu|m "()"..|
|00005360| 58 72 65 74 75 72 6e 73 | 20 74 68 65 20 76 61 6c |Xreturns| the val|
|00005370| 75 65 20 6f 66 20 74 68 | 65 20 63 75 72 72 65 6e |ue of th|e curren|
|00005380| 74 20 6f 75 74 70 75 74 | 20 73 74 72 65 61 6d 2e |t output| stream.|
|00005390| 0a 09 58 2e 4d 43 20 64 | 6e 6c 20 22 28 29 22 0a |..X.MC d|nl "()".|
|000053a0| 09 58 72 65 61 64 73 20 | 61 6e 64 20 64 69 73 63 |.Xreads |and disc|
|000053b0| 61 72 64 73 20 63 68 61 | 72 61 63 74 65 72 73 20 |ards cha|racters |
|000053c0| 75 70 20 74 6f 20 61 6e | 64 20 69 6e 63 6c 75 64 |up to an|d includ|
|000053d0| 69 6e 67 20 74 68 65 20 | 6e 65 78 74 20 6e 65 77 |ing the |next new|
|000053e0| 6c 69 6e 65 2e 0a 09 58 | 2e 4d 43 20 69 66 65 6c |line...X|.MC ifel|
|000053f0| 73 65 20 22 28 61 72 67 | 2c 20 61 72 67 2c 20 69 |se "(arg|, arg, i|
|00005400| 66 2d 73 61 6d 65 20 5b | 2c 20 69 66 6e 6f 74 2d |f-same [|, ifnot-|
|00005410| 73 61 6d 65 20 7c 20 61 | 72 67 2c 20 61 72 67 20 |same | a|rg, arg |
|00005420| 2e 2e 2e 5d 29 22 0a 09 | 58 68 61 73 20 74 68 72 |...])"..|Xhas thr|
|00005430| 65 65 20 6f 72 20 6d 6f | 72 65 20 61 72 67 75 6d |ee or mo|re argum|
|00005440| 65 6e 74 73 2e 0a 09 58 | 49 66 20 74 68 65 20 66 |ents...X|If the f|
|00005450| 69 72 73 74 20 61 72 67 | 75 6d 65 6e 74 20 69 73 |irst arg|ument is|
|00005460| 20 74 68 65 20 73 61 6d | 65 20 73 74 72 69 6e 67 | the sam|e string|
|00005470| 20 61 73 20 74 68 65 20 | 73 65 63 6f 6e 64 2c 0a | as the |second,.|
|00005480| 09 58 74 68 65 6e 20 74 | 68 65 20 76 61 6c 75 65 |.Xthen t|he value|
|00005490| 20 69 73 20 74 68 65 20 | 74 68 69 72 64 20 61 72 | is the |third ar|
|000054a0| 67 75 6d 65 6e 74 2e 0a | 09 58 49 66 20 6e 6f 74 |gument..|.XIf not|
|000054b0| 2c 20 61 6e 64 20 69 66 | 20 74 68 65 72 65 20 61 |, and if| there a|
|000054c0| 72 65 20 6d 6f 72 65 20 | 74 68 61 6e 20 66 6f 75 |re more |than fou|
|000054d0| 72 20 61 72 67 75 6d 65 | 6e 74 73 2c 20 74 68 65 |r argume|nts, the|
|000054e0| 20 70 72 6f 63 65 73 73 | 20 69 73 20 0a 09 58 72 | process| is ..Xr|
|000054f0| 65 70 65 61 74 65 64 20 | 77 69 74 68 20 61 72 67 |epeated |with arg|
|00005500| 75 6d 65 6e 74 73 20 34 | 2c 20 35 2c 20 36 20 61 |uments 4|, 5, 6 a|
|00005510| 6e 64 20 37 2e 0a 09 58 | 4f 74 68 65 72 77 69 73 |nd 7...X|Otherwis|
|00005520| 65 2c 20 74 68 65 20 76 | 61 6c 75 65 20 69 73 20 |e, the v|alue is |
|00005530| 65 69 74 68 65 72 20 74 | 68 65 20 66 6f 75 72 74 |either t|he fourt|
|00005540| 68 20 73 74 72 69 6e 67 | 2c 20 6f 72 2c 20 69 66 |h string|, or, if|
|00005550| 20 69 74 20 69 73 20 6e | 6f 74 20 70 72 65 73 65 | it is n|ot prese|
|00005560| 6e 74 2c 0a 09 58 6e 75 | 6c 6c 2e 0a 09 58 2e 4d |nt,..Xnu|ll...X.M|
|00005570| 43 20 69 6e 63 72 20 22 | 28 6e 75 6d 29 22 0a 09 |C incr "|(num)"..|
|00005580| 58 72 65 74 75 72 6e 73 | 20 74 68 65 20 76 61 6c |Xreturns| the val|
|00005590| 75 65 20 6f 66 20 69 74 | 73 20 61 72 67 75 6d 65 |ue of it|s argume|
|000055a0| 6e 74 20 69 6e 63 72 65 | 6d 65 6e 74 65 64 20 62 |nt incre|mented b|
|000055b0| 79 20 31 2e 0a 09 58 54 | 68 65 20 76 61 6c 75 65 |y 1...XT|he value|
|000055c0| 20 6f 66 20 74 68 65 20 | 61 72 67 75 6d 65 6e 74 | of the |argument|
|000055d0| 20 69 73 20 63 61 6c 63 | 75 6c 61 74 65 64 0a 09 | is calc|ulated..|
|000055e0| 58 62 79 20 69 6e 74 65 | 72 70 72 65 74 69 6e 67 |Xby inte|rpreting|
|000055f0| 20 61 6e 20 69 6e 69 74 | 69 61 6c 20 64 69 67 69 | an init|ial digi|
|00005600| 74 2d 73 74 72 69 6e 67 | 20 61 73 20 61 20 64 65 |t-string| as a de|
|00005610| 63 69 6d 61 6c 20 6e 75 | 6d 62 65 72 2e 0a 09 58 |cimal nu|mber...X|
|00005620| 2e 4d 43 20 64 65 63 72 | 20 22 28 6e 75 6d 29 22 |.MC decr| "(num)"|
|00005630| 0a 09 58 72 65 74 75 72 | 6e 73 20 74 68 65 20 76 |..Xretur|ns the v|
|00005640| 61 6c 75 65 20 6f 66 20 | 69 74 73 20 61 72 67 75 |alue of |its argu|
|00005650| 6d 65 6e 74 20 64 65 63 | 72 65 6d 65 6e 74 65 64 |ment dec|remented|
|00005660| 20 62 79 20 31 2e 0a 09 | 58 2e 4d 43 20 65 76 61 | by 1...|X.MC eva|
|00005670| 6c 20 22 28 65 78 70 72 | 65 73 73 69 6f 6e 29 22 |l "(expr|ession)"|
|00005680| 0a 09 58 65 76 61 6c 75 | 61 74 65 73 20 69 74 73 |..Xevalu|ates its|
|00005690| 20 61 72 67 75 6d 65 6e | 74 20 61 73 20 61 20 63 | argumen|t as a c|
|000056a0| 6f 6e 73 74 61 6e 74 20 | 65 78 70 72 65 73 73 69 |onstant |expressi|
|000056b0| 6f 6e 2c 20 75 73 69 6e | 67 20 69 6e 74 65 67 65 |on, usin|g intege|
|000056c0| 72 20 61 72 69 74 68 6d | 65 74 69 63 2e 0a 09 58 |r arithm|etic...X|
|000056d0| 54 68 65 20 65 76 61 6c | 75 61 74 69 6f 6e 20 6d |The eval|uation m|
|000056e0| 65 63 68 61 6e 69 73 6d | 20 69 73 20 76 65 72 79 |echanism| is very|
|000056f0| 20 73 69 6d 69 6c 61 72 | 20 74 6f 20 74 68 61 74 | similar| to that|
|00005700| 20 6f 66 0a 09 58 2e 49 | 20 63 70 70 0a 09 58 28 | of..X.I| cpp..X(|
|00005710| 23 69 66 20 65 78 70 72 | 65 73 73 69 6f 6e 29 2e |#if expr|ession).|
|00005720| 20 0a 09 58 54 68 65 20 | 65 78 70 72 65 73 73 69 | ..XThe |expressi|
|00005730| 6f 6e 20 63 61 6e 20 69 | 6e 76 6f 6c 76 65 20 6f |on can i|nvolve o|
|00005740| 6e 6c 79 20 69 6e 74 65 | 67 65 72 20 63 6f 6e 73 |nly inte|ger cons|
|00005750| 74 61 6e 74 73 20 61 6e | 64 20 63 68 61 72 61 63 |tants an|d charac|
|00005760| 74 65 72 20 63 6f 6e 73 | 74 61 6e 74 73 2c 0a 09 |ter cons|tants,..|
|00005770| 58 70 6f 73 73 69 62 6c | 79 20 63 6f 6e 6e 65 63 |Xpossibl|y connec|
|00005780| 74 65 64 20 62 79 20 74 | 68 65 20 62 69 6e 61 72 |ted by t|he binar|
|00005790| 79 20 6f 70 65 72 61 74 | 6f 72 73 0a 09 58 2e 6e |y operat|ors..X.n|
|000057a0| 66 0a 09 58 2e 66 74 20 | 42 0a 09 58 0a 09 58 2a |f..X.ft |B..X..X*|
|000057b0| 09 2f 09 25 09 2b 09 2d | 09 3e 3e 09 3c 3c 09 3c |./.%.+.-|.>>.<<.<|
|000057c0| 09 3e 09 0a 09 58 3c 3d | 09 3e 3d 09 3d 3d 09 21 |.>...X<=|.>=.==.!|
|000057d0| 3d 09 26 09 5e 09 7c 09 | 26 26 09 7c 7c 0a 09 58 |=.&.^.|.|&&.||..X|
|000057e0| 0a 09 58 2e 66 74 20 52 | 0a 09 58 2e 66 69 0a 09 |..X.ft R|..X.fi..|
|000057f0| 58 6f 72 20 74 68 65 20 | 75 6e 61 72 79 20 6f 70 |Xor the |unary op|
|00005800| 65 72 61 74 6f 72 73 20 | 5c 66 42 5c 2d 20 7e 20 |erators |\fB\- ~ |
|00005810| 21 5c 66 52 0a 09 58 6f | 72 20 62 79 20 74 68 65 |!\fR..Xo|r by the|
|00005820| 20 74 65 72 6e 61 72 79 | 20 6f 70 65 72 61 74 6f | ternary| operato|
|00005830| 72 20 5c 66 42 20 3f 20 | 3a 20 5c 66 52 2e 0a 09 |r \fB ? |: \fR...|
|00005840| 58 50 61 72 65 6e 74 68 | 65 73 65 73 20 6d 61 79 |XParenth|eses may|
|00005850| 20 62 65 20 75 73 65 64 | 20 66 6f 72 20 67 72 6f | be used| for gro|
|00005860| 75 70 69 6e 67 2e 20 4f | 63 74 61 6c 20 6e 75 6d |uping. O|ctal num|
|00005870| 62 65 72 73 20 6d 61 79 | 20 62 65 20 73 70 65 63 |bers may| be spec|
|00005880| 69 66 69 65 64 20 61 73 | 0a 09 58 69 6e 20 43 2e |ified as|..Xin C.|
|00005890| 0a 09 58 2e 4d 43 20 6c | 65 6e 20 22 28 73 74 72 |..X.MC l|en "(str|
|000058a0| 69 6e 67 29 22 0a 09 58 | 72 65 74 75 72 6e 73 20 |ing)"..X|returns |
|000058b0| 74 68 65 20 6e 75 6d 62 | 65 72 20 6f 66 20 63 68 |the numb|er of ch|
|000058c0| 61 72 61 63 74 65 72 73 | 20 69 6e 20 69 74 73 20 |aracters| in its |
|000058d0| 61 72 67 75 6d 65 6e 74 | 2e 0a 09 58 2e 4d 43 20 |argument|...X.MC |
|000058e0| 69 6e 64 65 78 20 22 28 | 73 65 61 72 63 68 2d 73 |index "(|search-s|
|000058f0| 74 72 69 6e 67 2c 20 73 | 74 72 69 6e 67 29 22 0a |tring, s|tring)".|
|00005900| 09 58 72 65 74 75 72 6e | 73 20 74 68 65 20 70 6f |.Xreturn|s the po|
|00005910| 73 69 74 69 6f 6e 20 69 | 6e 20 69 74 73 20 66 69 |sition i|n its fi|
|00005920| 72 73 74 20 61 72 67 75 | 6d 65 6e 74 20 77 68 65 |rst argu|ment whe|
|00005930| 72 65 20 74 68 65 20 73 | 65 63 6f 6e 64 20 61 72 |re the s|econd ar|
|00005940| 67 75 6d 65 6e 74 20 0a | 09 58 62 65 67 69 6e 73 |gument .|.Xbegins|
|00005950| 20 28 7a 65 72 6f 20 6f | 72 69 67 69 6e 29 2c 0a | (zero o|rigin),.|
|00005960| 09 58 6f 72 20 5c 2d 31 | 20 69 66 20 74 68 65 20 |.Xor \-1| if the |
|00005970| 73 65 63 6f 6e 64 20 61 | 72 67 75 6d 65 6e 74 20 |second a|rgument |
|00005980| 64 6f 65 73 20 6e 6f 74 | 20 6f 63 63 75 72 2e 0a |does not| occur..|
|00005990| 09 58 2e 4d 43 20 73 75 | 62 73 74 72 20 22 28 73 |.X.MC su|bstr "(s|
|000059a0| 74 72 69 6e 67 2c 20 69 | 6e 64 65 78 20 5b 2c 20 |tring, i|ndex [, |
|000059b0| 6c 65 6e 67 74 68 5d 29 | 22 0a 09 58 72 65 74 75 |length])|"..Xretu|
|000059c0| 72 6e 73 20 61 20 73 75 | 62 73 74 72 69 6e 67 20 |rns a su|bstring |
|000059d0| 6f 66 20 69 74 73 20 66 | 69 72 73 74 20 61 72 67 |of its f|irst arg|
|000059e0| 75 6d 65 6e 74 2e 0a 09 | 58 54 68 65 20 73 65 63 |ument...|XThe sec|
|000059f0| 6f 6e 64 20 61 72 67 75 | 6d 65 6e 74 20 69 73 20 |ond argu|ment is |
|00005a00| 61 20 7a 65 72 6f 20 6f | 72 69 67 69 6e 0a 09 58 |a zero o|rigin..X|
|00005a10| 6e 75 6d 62 65 72 20 73 | 65 6c 65 63 74 69 6e 67 |number s|electing|
|00005a20| 20 74 68 65 20 66 69 72 | 73 74 20 63 68 61 72 61 | the fir|st chara|
|00005a30| 63 74 65 72 20 28 69 6e | 74 65 72 6e 61 6c 6c 79 |cter (in|ternally|
|00005a40| 20 74 72 65 61 74 65 64 | 20 61 73 20 61 6e 20 65 | treated| as an e|
|00005a50| 78 70 72 65 73 73 69 6f | 6e 29 3b 0a 09 58 74 68 |xpressio|n);..Xth|
|00005a60| 65 20 74 68 69 72 64 20 | 61 72 67 75 6d 65 6e 74 |e third |argument|
|00005a70| 20 69 6e 64 69 63 61 74 | 65 73 20 74 68 65 20 6c | indicat|es the l|
|00005a80| 65 6e 67 74 68 20 6f 66 | 20 74 68 65 20 73 75 62 |ength of| the sub|
|00005a90| 73 74 72 69 6e 67 2e 0a | 09 58 41 20 6d 69 73 73 |string..|.XA miss|
|00005aa0| 69 6e 67 20 74 68 69 72 | 64 20 61 72 67 75 6d 65 |ing thir|d argume|
|00005ab0| 6e 74 20 69 73 20 74 61 | 6b 65 6e 20 74 6f 20 62 |nt is ta|ken to b|
|00005ac0| 65 20 6c 61 72 67 65 20 | 65 6e 6f 75 67 68 20 74 |e large |enough t|
|00005ad0| 6f 20 65 78 74 65 6e 64 | 20 74 6f 0a 09 58 74 68 |o extend| to..Xth|
|00005ae0| 65 20 65 6e 64 20 6f 66 | 20 74 68 65 20 66 69 72 |e end of| the fir|
|00005af0| 73 74 20 73 74 72 69 6e | 67 2e 20 0a 09 58 2e 4d |st strin|g. ..X.M|
|00005b00| 43 20 74 72 61 6e 73 6c | 69 74 20 22 28 73 6f 75 |C transl|it "(sou|
|00005b10| 72 63 65 2c 20 66 72 6f | 6d 20 5b 2c 20 74 6f 5d |rce, fro|m [, to]|
|00005b20| 29 22 0a 09 58 74 72 61 | 6e 73 6c 69 74 65 72 61 |)"..Xtra|nslitera|
|00005b30| 74 65 73 20 74 68 65 20 | 63 68 61 72 61 63 74 65 |tes the |characte|
|00005b40| 72 73 20 69 6e 20 69 74 | 73 20 66 69 72 73 74 20 |rs in it|s first |
|00005b50| 61 72 67 75 6d 65 6e 74 | 0a 09 58 66 72 6f 6d 20 |argument|..Xfrom |
|00005b60| 74 68 65 20 73 65 74 20 | 67 69 76 65 6e 20 62 79 |the set |given by|
|00005b70| 20 74 68 65 20 73 65 63 | 6f 6e 64 20 61 72 67 75 | the sec|ond argu|
|00005b80| 6d 65 6e 74 20 74 6f 20 | 74 68 65 20 73 65 74 20 |ment to |the set |
|00005b90| 67 69 76 65 6e 20 62 79 | 20 74 68 65 20 74 68 69 |given by| the thi|
|00005ba0| 72 64 2e 0a 09 58 49 66 | 20 74 68 65 20 74 68 69 |rd...XIf| the thi|
|00005bb0| 72 64 20 61 72 67 75 6d | 65 6e 74 20 69 73 20 73 |rd argum|ent is s|
|00005bc0| 68 6f 72 74 65 72 20 74 | 68 61 6e 20 74 68 65 20 |horter t|han the |
|00005bd0| 73 65 63 6f 6e 64 2c 20 | 61 6c 6c 20 65 78 74 72 |second, |all extr|
|00005be0| 61 20 63 68 61 72 61 63 | 74 65 72 73 0a 09 58 69 |a charac|ters..Xi|
|00005bf0| 6e 20 74 68 65 20 73 65 | 63 6f 6e 64 20 61 72 67 |n the se|cond arg|
|00005c00| 75 6d 65 6e 74 20 61 72 | 65 20 64 65 6c 65 74 65 |ument ar|e delete|
|00005c10| 64 20 66 72 6f 6d 20 74 | 68 65 20 66 69 72 73 74 |d from t|he first|
|00005c20| 20 61 72 67 75 6d 65 6e | 74 2e 20 49 66 20 74 68 | argumen|t. If th|
|00005c30| 65 20 74 68 69 72 64 0a | 09 58 61 72 67 75 6d 65 |e third.|.Xargume|
|00005c40| 6e 74 20 69 73 20 6d 69 | 73 73 69 6e 67 20 61 6c |nt is mi|ssing al|
|00005c50| 74 6f 67 65 74 68 65 72 | 2c 20 61 6c 6c 20 63 68 |together|, all ch|
|00005c60| 61 72 61 63 74 65 72 73 | 20 69 6e 20 74 68 65 20 |aracters| in the |
|00005c70| 73 65 63 6f 6e 64 20 61 | 72 67 75 6d 65 6e 74 20 |second a|rgument |
|00005c80| 61 72 65 0a 09 58 64 65 | 6c 65 74 65 64 20 66 72 |are..Xde|leted fr|
|00005c90| 6f 6d 20 74 68 65 20 66 | 69 72 73 74 20 61 72 67 |om the f|irst arg|
|00005ca0| 75 6d 65 6e 74 2e 0a 09 | 58 2e 4d 43 20 69 6e 63 |ument...|X.MC inc|
|00005cb0| 6c 75 64 65 20 22 28 66 | 69 6c 65 6e 61 6d 65 29 |lude "(f|ilename)|
|00005cc0| 22 0a 09 58 72 65 74 75 | 72 6e 73 20 74 68 65 20 |"..Xretu|rns the |
|00005cd0| 63 6f 6e 74 65 6e 74 73 | 20 6f 66 20 74 68 65 20 |contents| of the |
|00005ce0| 66 69 6c 65 20 6e 61 6d | 65 64 20 69 6e 20 74 68 |file nam|ed in th|
|00005cf0| 65 20 61 72 67 75 6d 65 | 6e 74 2e 0a 09 58 2e 4d |e argume|nt...X.M|
|00005d00| 43 20 73 69 6e 63 6c 75 | 64 65 20 22 28 66 69 6c |C sinclu|de "(fil|
|00005d10| 65 6e 61 6d 65 29 22 0a | 09 58 69 73 20 69 64 65 |ename)".|.Xis ide|
|00005d20| 6e 74 69 63 61 6c 20 74 | 6f 0a 09 58 2e 49 52 20 |ntical t|o..X.IR |
|00005d30| 69 6e 63 6c 75 64 65 20 | 2c 0a 09 58 65 78 63 65 |include |,..Xexce|
|00005d40| 70 74 20 74 68 61 74 20 | 69 74 0a 09 58 73 61 79 |pt that |it..Xsay|
|00005d50| 73 20 6e 6f 74 68 69 6e | 67 20 69 66 20 74 68 65 |s nothin|g if the|
|00005d60| 20 66 69 6c 65 20 69 73 | 20 69 6e 61 63 63 65 73 | file is| inacces|
|00005d70| 73 69 62 6c 65 2e 0a 09 | 58 2e 4d 43 20 70 61 73 |sible...|X.MC pas|
|00005d80| 74 65 20 22 28 66 69 6c | 65 6e 61 6d 65 29 22 0a |te "(fil|ename)".|
|00005d90| 09 58 72 65 74 75 72 6e | 73 20 74 68 65 20 63 6f |.Xreturn|s the co|
|00005da0| 6e 74 65 6e 74 73 20 6f | 66 20 74 68 65 20 66 69 |ntents o|f the fi|
|00005db0| 6c 65 20 6e 61 6d 65 64 | 20 69 6e 20 74 68 65 20 |le named| in the |
|00005dc0| 61 72 67 75 6d 65 6e 74 | 20 77 69 74 68 6f 75 74 |argument| without|
|00005dd0| 20 61 6e 79 0a 09 58 70 | 72 6f 63 65 73 73 69 6e | any..Xp|rocessin|
|00005de0| 67 2c 20 75 6e 6c 69 6b | 65 20 0a 09 58 2e 49 52 |g, unlik|e ..X.IR|
|00005df0| 20 69 6e 63 6c 75 64 65 | 2e 0a 09 58 2e 4d 43 20 | include|...X.MC |
|00005e00| 73 70 61 73 74 65 20 22 | 28 66 69 6c 65 6e 61 6d |spaste "|(filenam|
|00005e10| 65 29 22 0a 09 58 69 73 | 20 69 64 65 6e 74 69 63 |e)"..Xis| identic|
|00005e20| 61 6c 20 74 6f 0a 09 58 | 2e 49 52 20 70 61 73 74 |al to..X|.IR past|
|00005e30| 65 20 2c 0a 09 58 65 78 | 63 65 70 74 20 74 68 61 |e ,..Xex|cept tha|
|00005e40| 74 20 69 74 20 73 61 79 | 73 20 6e 6f 74 68 69 6e |t it say|s nothin|
|00005e50| 67 20 69 66 20 74 68 65 | 20 66 69 6c 65 20 69 73 |g if the| file is|
|00005e60| 20 69 6e 61 63 63 65 73 | 73 69 62 6c 65 2e 0a 09 | inacces|sible...|
|00005e70| 58 2e 4d 43 20 73 79 73 | 63 6d 64 20 22 28 63 6f |X.MC sys|cmd "(co|
|00005e80| 6d 6d 61 6e 64 29 22 0a | 09 58 65 78 65 63 75 74 |mmand)".|.Xexecut|
|00005e90| 65 73 20 74 68 65 0a 09 | 58 2e 53 4d 20 55 4e 49 |es the..|X.SM UNI|
|00005ea0| 58 0a 09 58 63 6f 6d 6d | 61 6e 64 20 67 69 76 65 |X..Xcomm|and give|
|00005eb0| 6e 20 69 6e 20 74 68 65 | 20 66 69 72 73 74 20 61 |n in the| first a|
|00005ec0| 72 67 75 6d 65 6e 74 2e | 0a 09 58 4e 6f 20 76 61 |rgument.|..XNo va|
|00005ed0| 6c 75 65 20 69 73 20 72 | 65 74 75 72 6e 65 64 2e |lue is r|eturned.|
|00005ee0| 0a 09 58 2e 4d 43 20 73 | 79 73 76 61 6c 20 22 28 |..X.MC s|ysval "(|
|00005ef0| 29 22 0a 09 58 69 73 20 | 74 68 65 20 72 65 74 75 |)"..Xis |the retu|
|00005f00| 72 6e 20 63 6f 64 65 20 | 66 72 6f 6d 20 74 68 65 |rn code |from the|
|00005f10| 20 6c 61 73 74 20 63 61 | 6c 6c 20 74 6f 0a 09 58 | last ca|ll to..X|
|00005f20| 2e 49 52 20 73 79 73 63 | 6d 64 20 2e 0a 09 58 2e |.IR sysc|md ...X.|
|00005f30| 4d 43 20 6d 61 6b 65 74 | 65 6d 70 20 22 28 73 74 |MC maket|emp "(st|
|00005f40| 72 69 6e 67 29 22 0a 09 | 58 66 69 6c 6c 73 20 69 |ring)"..|Xfills i|
|00005f50| 6e 20 61 20 73 74 72 69 | 6e 67 20 6f 66 0a 09 58 |n a stri|ng of..X|
|00005f60| 2e 53 4d 20 58 58 58 58 | 58 58 0a 09 58 69 6e 20 |.SM XXXX|XX..Xin |
|00005f70| 69 74 73 20 61 72 67 75 | 6d 65 6e 74 20 77 69 74 |its argu|ment wit|
|00005f80| 68 20 74 68 65 20 63 75 | 72 72 65 6e 74 20 70 72 |h the cu|rrent pr|
|00005f90| 6f 63 65 73 73 0a 09 58 | 2e 53 4d 20 49 44 5c 2a |ocess..X|.SM ID\*|
|00005fa0| 53 2e 0a 09 58 2e 4d 43 | 20 6d 34 65 78 69 74 20 |S...X.MC| m4exit |
|00005fb0| 22 28 5b 65 78 69 74 63 | 6f 64 65 5d 29 22 0a 09 |"([exitc|ode])"..|
|00005fc0| 58 63 61 75 73 65 73 20 | 69 6d 6d 65 64 69 61 74 |Xcauses |immediat|
|00005fd0| 65 20 65 78 69 74 20 66 | 72 6f 6d 0a 09 58 2e 49 |e exit f|rom..X.I|
|00005fe0| 52 20 6d 34 20 2e 0a 09 | 58 41 72 67 75 6d 65 6e |R m4 ...|XArgumen|
|00005ff0| 74 20 31 2c 20 69 66 20 | 67 69 76 65 6e 2c 20 69 |t 1, if |given, i|
|00006000| 73 20 74 68 65 20 65 78 | 69 74 20 63 6f 64 65 3b |s the ex|it code;|
|00006010| 0a 09 58 74 68 65 20 64 | 65 66 61 75 6c 74 20 69 |..Xthe d|efault i|
|00006020| 73 20 30 2e 0a 09 58 2e | 4d 43 20 6d 34 77 72 61 |s 0...X.|MC m4wra|
|00006030| 70 20 22 28 6d 34 2d 6d | 61 63 72 6f 2d 6f 72 2d |p "(m4-m|acro-or-|
|00006040| 62 75 69 6c 74 2d 69 6e | 29 22 0a 09 58 61 72 67 |built-in|)"..Xarg|
|00006050| 75 6d 65 6e 74 20 31 20 | 77 69 6c 6c 20 62 65 20 |ument 1 |will be |
|00006060| 70 75 73 68 65 64 20 62 | 61 63 6b 20 61 74 20 66 |pushed b|ack at f|
|00006070| 69 6e 61 6c 0a 09 58 2e | 42 52 20 45 4f 46 20 3b |inal..X.|BR EOF ;|
|00006080| 0a 09 58 65 78 61 6d 70 | 6c 65 3a 20 6d 34 77 72 |..Xexamp|le: m4wr|
|00006090| 61 70 28 60 64 75 6d 70 | 74 61 62 6c 65 28 29 27 |ap(`dump|table()'|
|000060a0| 29 2e 0a 09 58 2e 4d 43 | 20 65 72 72 70 72 69 6e |)...X.MC| errprin|
|000060b0| 74 20 22 28 73 74 72 20 | 5b 2c 20 73 74 72 2c 20 |t "(str |[, str, |
|000060c0| 73 74 72 2c 20 2e 2e 2e | 5d 29 22 0a 09 58 70 72 |str, ...|])"..Xpr|
|000060d0| 69 6e 74 73 20 69 74 73 | 20 61 72 67 75 6d 65 6e |ints its| argumen|
|000060e0| 74 28 73 29 20 6f 6e 20 | 73 74 64 65 72 72 2e 20 |t(s) on |stderr. |
|000060f0| 49 66 20 74 68 65 72 65 | 20 69 73 20 6d 6f 72 65 |If there| is more|
|00006100| 20 74 68 61 6e 20 6f 6e | 65 20 61 72 67 75 6d 65 | than on|e argume|
|00006110| 6e 74 2c 0a 09 58 65 61 | 63 68 20 61 72 67 75 6d |nt,..Xea|ch argum|
|00006120| 65 6e 74 20 69 73 20 73 | 65 70 61 72 61 74 65 64 |ent is s|eparated|
|00006130| 20 62 79 20 61 20 73 70 | 61 63 65 20 64 75 72 69 | by a sp|ace duri|
|00006140| 6e 67 20 74 68 65 20 6f | 75 74 70 75 74 2e 0a 09 |ng the o|utput...|
|00006150| 58 2e 4d 43 20 64 75 6d | 70 64 65 66 20 22 28 5b |X.MC dum|pdef "([|
|00006160| 6e 61 6d 65 2c 20 6e 61 | 6d 65 2c 20 2e 2e 2e 5d |name, na|me, ...]|
|00006170| 29 22 0a 09 58 70 72 69 | 6e 74 73 20 63 75 72 72 |)"..Xpri|nts curr|
|00006180| 65 6e 74 20 6e 61 6d 65 | 73 20 61 6e 64 20 64 65 |ent name|s and de|
|00006190| 66 69 6e 69 74 69 6f 6e | 73 2c 0a 09 58 66 6f 72 |finition|s,..Xfor|
|000061a0| 20 74 68 65 20 6e 61 6d | 65 64 20 69 74 65 6d 73 | the nam|ed items|
|000061b0| 2c 20 6f 72 20 66 6f 72 | 20 61 6c 6c 20 69 66 20 |, or for| all if |
|000061c0| 6e 6f 20 61 72 67 75 6d | 65 6e 74 73 20 61 72 65 |no argum|ents are|
|000061d0| 20 67 69 76 65 6e 2e 0a | 09 58 2e 64 74 0a 09 58 | given..|.X.dt..X|
|000061e0| 2e 53 48 20 41 55 54 48 | 4f 52 0a 09 58 4f 7a 61 |.SH AUTH|OR..XOza|
|000061f0| 6e 20 53 2e 20 59 69 67 | 69 74 20 28 6f 7a 29 0a |n S. Yig|it (oz).|
|00006200| 09 58 2e 53 48 20 42 55 | 47 53 0a 09 58 50 64 20 |.X.SH BU|GS..XPd |
|00006210| 4d 34 20 69 73 20 64 69 | 73 74 72 69 62 75 74 65 |M4 is di|stribute|
|00006220| 64 20 61 74 20 74 68 65 | 20 73 6f 75 72 63 65 20 |d at the| source |
|00006230| 6c 65 76 65 6c 2c 20 61 | 6e 64 20 64 6f 65 73 20 |level, a|nd does |
|00006240| 6e 6f 74 20 72 65 71 75 | 69 72 65 20 61 6e 20 65 |not requ|ire an e|
|00006250| 78 70 65 6e 73 69 76 65 | 0a 09 58 6c 69 63 65 6e |xpensive|..Xlicen|
|00006260| 73 65 20 61 67 72 65 65 | 6d 65 6e 74 2e 0a 09 58 |se agree|ment...X|
|00006270| 2e 50 50 0a 09 58 41 20 | 73 75 66 66 69 63 69 65 |.PP..XA |sufficie|
|00006280| 6e 74 6c 79 20 63 6f 6d | 70 6c 65 78 20 4d 34 20 |ntly com|plex M4 |
|00006290| 6d 61 63 72 6f 20 73 65 | 74 20 69 73 20 61 62 6f |macro se|t is abo|
|000062a0| 75 74 20 61 73 20 72 65 | 61 64 61 62 6c 65 0a 09 |ut as re|adable..|
|000062b0| 58 61 73 0a 09 58 2e 42 | 52 20 41 50 4c 20 2e 0a |Xas..X.B|R APL ..|
|000062c0| 09 58 2e 50 50 0a 09 58 | 41 6c 6c 20 63 6f 6d 70 |.X.PP..X|All comp|
|000062d0| 6c 65 78 20 75 73 65 73 | 20 6f 66 20 4d 34 20 72 |lex uses| of M4 r|
|000062e0| 65 71 75 69 72 65 20 74 | 68 65 20 61 62 69 6c 69 |equire t|he abili|
|000062f0| 74 79 20 74 6f 20 70 72 | 6f 67 72 61 6d 20 69 6e |ty to pr|ogram in|
|00006300| 20 64 65 65 70 20 72 65 | 63 75 72 73 69 6f 6e 2e | deep re|cursion.|
|00006310| 0a 09 58 50 72 65 76 69 | 6f 75 73 20 6c 69 73 70 |..XPrevi|ous lisp|
|00006320| 20 65 78 70 65 72 69 65 | 6e 63 65 20 69 73 20 72 | experie|nce is r|
|00006330| 65 63 6f 6d 6d 65 6e 64 | 65 64 2e 0a 09 58 2e 50 |ecommend|ed...X.P|
|00006340| 50 0a 09 58 50 64 20 4d | 34 20 69 73 20 73 6c 6f |P..XPd M|4 is slo|
|00006350| 77 65 72 20 74 68 61 6e | 20 56 37 20 4d 34 2e 0a |wer than| V7 M4..|
|00006360| 09 58 2e 53 48 20 45 58 | 41 4d 50 4c 45 53 0a 09 |.X.SH EX|AMPLES..|
|00006370| 58 2e 50 50 0a 09 58 54 | 68 65 20 66 6f 6c 6c 6f |X.PP..XT|he follo|
|00006380| 77 69 6e 67 20 6d 61 63 | 72 6f 20 70 72 6f 67 72 |wing mac|ro progr|
|00006390| 61 6d 20 69 6c 6c 75 73 | 74 72 61 74 65 73 20 74 |am illus|trates t|
|000063a0| 68 65 20 74 79 70 65 20 | 6f 66 20 74 68 69 6e 67 |he type |of thing|
|000063b0| 73 20 74 68 61 74 0a 09 | 58 63 61 6e 20 62 65 20 |s that..|Xcan be |
|000063c0| 64 6f 6e 65 20 77 69 74 | 68 20 4d 34 2e 20 0a 09 |done wit|h M4. ..|
|000063d0| 58 2e 50 50 0a 09 58 2e | 52 53 0a 09 58 2e 6e 66 |X.PP..X.|RS..X.nf|
|000063e0| 0a 09 58 5c 66 42 63 68 | 61 6e 67 65 71 75 6f 74 |..X\fBch|angequot|
|000063f0| 65 5c 66 52 28 3c 2c 3e | 29 20 5c 66 42 64 65 66 |e\fR(<,>|) \fBdef|
+--------+-------------------------+-------------------------+--------+--------+
Only 25.0 KB of data is shown above.