home *** CD-ROM | disk | FTP | other *** search
| Unknown | 1995-07-02 | 103.3 KB |
open in: 
MacOS 8.1
|
Win98
|
DOS
view JSON data
|
view as text
This file was not able to be converted.
This format is not currently supported by dexvert.
| Confidence | Program | Detection | Match Type | Support
|
|---|
| 100%
| file
| data
| default
| |
| 100%
| gt2
| Kopftext: 'HELP('
| default (weak)
|
|
hex view+--------+-------------------------+-------------------------+--------+--------+
|00000000| 48 45 4c 50 28 00 00 00 | c9 00 00 00 6c ba 00 00 |HELP(...|....l...|
|00000010| d0 8b 01 00 00 fd ff ff | 00 00 00 00 a0 04 00 00 |........|........|
|00000020| 00 01 00 00 00 00 00 00 | 24 00 00 00 46 52 45 45 |........|$...FREE|
|00000030| 54 00 00 00 ff ff ff ff | 80 00 00 00 46 ff ff ff |T.......|....F...|
|00000040| 21 a6 ec 2a 33 05 00 00 | 13 00 00 00 00 00 00 00 |!..*3...|........|
|00000050| 21 52 6f 6f 74 00 00 00 | b4 05 00 00 46 ff ff ff |!Root...|....F...|
|00000060| cd a8 ec 2a 9c 0e 00 00 | 13 00 00 00 00 00 00 00 |...*....|........|
|00000070| 43 68 61 6e 67 65 4c 6f | 67 73 00 00 02 ec 8e e3 |ChangeLo|gs......|
|00000080| 44 41 54 41 33 05 00 00 | 54 6f 70 0a 50 72 65 76 |DATA3...|Top.Prev|
|00000090| 69 6f 75 73 3a 20 3c 28 | 64 69 72 29 3d 3e 64 69 |ious: <(|dir)=>di|
|000000a0| 72 3e 20 2a 20 4e 65 78 | 74 3a 20 3c 52 65 61 64 |r> * Nex|t: <Read|
|000000b0| 69 6e 67 20 4e 6f 6e 2d | 46 72 65 65 20 43 6f 64 |ing Non-|Free Cod|
|000000c0| 65 3d 3e 52 65 61 64 69 | 6e 67 4e 6f 6e 3e 20 2a |e=>Readi|ngNon> *|
|000000d0| 20 55 70 3a 20 3c 28 64 | 69 72 29 3d 3e 64 69 72 | Up: <(d|ir)=>dir|
|000000e0| 3e 0a 0a 23 57 72 61 70 | 20 6f 6e 0a 7b 66 48 31 |>..#Wrap| on.{fH1|
|000000f0| 7d 56 65 72 73 69 6f 6e | 7b 66 7d 0a 0a 4c 61 73 |}Version|{f}..Las|
|00000100| 74 20 75 70 64 61 74 65 | 64 20 32 38 20 4d 61 72 |t update|d 28 Mar|
|00000110| 63 68 20 31 39 39 34 2e | 0a 0a 23 57 72 61 70 20 |ch 1994.|..#Wrap |
|00000120| 6f 66 66 0a 3c 52 65 61 | 64 69 6e 67 20 4e 6f 6e |off.<Rea|ding Non|
|00000130| 2d 46 72 65 65 20 43 6f | 64 65 3d 3e 52 65 61 64 |-Free Co|de=>Read|
|00000140| 69 6e 67 4e 6f 6e 3e 3a | 09 52 65 66 65 72 72 69 |ingNon>:|.Referri|
|00000150| 6e 67 20 74 6f 20 50 72 | 6f 70 72 69 65 74 61 72 |ng to Pr|oprietar|
|00000160| 79 20 50 72 6f 67 72 61 | 6d 73 0a 3c 43 6f 6e 74 |y Progra|ms.<Cont|
|00000170| 72 69 62 75 74 69 6f 6e | 73 3d 3e 43 6f 6e 74 72 |ribution|s=>Contr|
|00000180| 69 62 75 74 69 3e 3a 09 | 09 41 63 63 65 70 74 69 |ibuti>:.|.Accepti|
|00000190| 6e 67 20 43 6f 6e 74 72 | 69 62 75 74 69 6f 6e 73 |ng Contr|ibutions|
|000001a0| 0a 3c 43 68 61 6e 67 65 | 20 4c 6f 67 73 3d 3e 43 |.<Change| Logs=>C|
|000001b0| 68 61 6e 67 65 4c 6f 67 | 73 3e 3a 09 09 09 52 65 |hangeLog|s>:...Re|
|000001c0| 63 6f 72 64 69 6e 67 20 | 43 68 61 6e 67 65 73 0a |cording |Changes.|
|000001d0| 3c 43 6f 6d 70 61 74 69 | 62 69 6c 69 74 79 3d 3e |<Compati|bility=>|
|000001e0| 43 6f 6d 70 61 74 69 62 | 69 6c 3e 3a 09 09 43 6f |Compatib|il>:..Co|
|000001f0| 6d 70 61 74 69 62 69 6c | 69 74 79 20 77 69 74 68 |mpatibil|ity with|
|00000200| 20 4f 74 68 65 72 20 49 | 6d 70 6c 65 6d 65 6e 74 | Other I|mplement|
|00000210| 61 74 69 6f 6e 73 0a 3c | 4d 61 6b 65 66 69 6c 65 |ations.<|Makefile|
|00000220| 20 43 6f 6e 76 65 6e 74 | 69 6f 6e 73 3d 3e 4d 61 | Convent|ions=>Ma|
|00000230| 6b 65 66 69 6c 65 43 6f | 3e 3a 09 4d 61 6b 65 66 |kefileCo|>:.Makef|
|00000240| 69 6c 65 20 43 6f 6e 76 | 65 6e 74 69 6f 6e 73 0a |ile Conv|entions.|
|00000250| 3c 43 6f 6e 66 69 67 75 | 72 61 74 69 6f 6e 3d 3e |<Configu|ration=>|
|00000260| 43 6f 6e 66 69 67 75 72 | 61 74 3e 3a 09 09 48 6f |Configur|at>:..Ho|
|00000270| 77 20 43 6f 6e 66 69 67 | 75 72 61 74 69 6f 6e 20 |w Config|uration |
|00000280| 53 68 6f 75 6c 64 20 57 | 6f 72 6b 0a 3c 53 6f 75 |Should W|ork.<Sou|
|00000290| 72 63 65 20 4c 61 6e 67 | 75 61 67 65 3d 3e 53 6f |rce Lang|uage=>So|
|000002a0| 75 72 63 65 4c 61 6e 67 | 3e 3a 09 09 55 73 69 6e |urceLang|>:..Usin|
|000002b0| 67 20 4c 61 6e 67 75 61 | 67 65 73 20 4f 74 68 65 |g Langua|ges Othe|
|000002c0| 72 20 54 68 61 6e 20 43 | 0a 3c 46 6f 72 6d 61 74 |r Than C|.<Format|
|000002d0| 74 69 6e 67 3d 3e 46 6f | 72 6d 61 74 74 69 6e 67 |ting=>Fo|rmatting|
|000002e0| 3e 3a 09 09 09 46 6f 72 | 6d 61 74 74 69 6e 67 20 |>:...For|matting |
|000002f0| 59 6f 75 72 20 53 6f 75 | 72 63 65 20 43 6f 64 65 |Your Sou|rce Code|
|00000300| 0a 3c 43 6f 6d 6d 65 6e | 74 73 3d 3e 43 6f 6d 6d |.<Commen|ts=>Comm|
|00000310| 65 6e 74 73 3e 3a 09 09 | 09 43 6f 6d 6d 65 6e 74 |ents>:..|.Comment|
|00000320| 69 6e 67 20 59 6f 75 72 | 20 57 6f 72 6b 0a 3c 53 |ing Your| Work.<S|
|00000330| 79 6e 74 61 63 74 69 63 | 20 43 6f 6e 76 65 6e 74 |yntactic| Convent|
|00000340| 69 6f 6e 73 3d 3e 53 79 | 6e 74 61 63 74 69 63 43 |ions=>Sy|ntacticC|
|00000350| 3e 3a 09 43 6c 65 61 6e | 20 55 73 65 20 6f 66 20 |>:.Clean| Use of |
|00000360| 43 20 43 6f 6e 73 74 72 | 75 63 74 73 0a 3c 4e 61 |C Constr|ucts.<Na|
|00000370| 6d 65 73 3d 3e 4e 61 6d | 65 73 3e 3a 09 09 09 4e |mes=>Nam|es>:...N|
|00000380| 61 6d 69 6e 67 20 56 61 | 72 69 61 62 6c 65 73 20 |aming Va|riables |
|00000390| 61 6e 64 20 46 75 6e 63 | 74 69 6f 6e 73 0a 3c 55 |and Func|tions.<U|
|000003a0| 73 69 6e 67 20 45 78 74 | 65 6e 73 69 6f 6e 73 3d |sing Ext|ensions=|
|000003b0| 3e 55 73 69 6e 67 45 78 | 74 65 6e 3e 3a 09 09 55 |>UsingEx|ten>:..U|
|000003c0| 73 69 6e 67 20 4e 6f 6e | 2d 73 74 61 6e 64 61 72 |sing Non|-standar|
|000003d0| 64 20 46 65 61 74 75 72 | 65 73 0a 3c 53 79 73 74 |d Featur|es.<Syst|
|000003e0| 65 6d 20 46 75 6e 63 74 | 69 6f 6e 73 3d 3e 53 79 |em Funct|ions=>Sy|
|000003f0| 73 74 65 6d 46 75 6e 63 | 3e 3a 20 20 20 20 20 20 |stemFunc|>: |
|00000400| 20 20 20 20 20 20 50 6f | 72 74 61 62 69 6c 69 74 | Po|rtabilit|
|00000410| 79 20 61 6e 64 20 60 60 | 73 74 61 6e 64 61 72 64 |y and ``|standard|
|00000420| 27 27 20 6c 69 62 72 61 | 72 79 20 66 75 6e 63 74 |'' libra|ry funct|
|00000430| 69 6f 6e 73 0a 3c 53 65 | 6d 61 6e 74 69 63 73 3d |ions.<Se|mantics=|
|00000440| 3e 53 65 6d 61 6e 74 69 | 63 73 3e 3a 09 09 09 50 |>Semanti|cs>:...P|
|00000450| 72 6f 67 72 61 6d 20 42 | 65 68 61 76 69 6f 72 20 |rogram B|ehavior |
|00000460| 66 6f 72 20 41 6c 6c 20 | 50 72 6f 67 72 61 6d 73 |for All |Programs|
|00000470| 0a 3c 45 72 72 6f 72 73 | 3d 3e 45 72 72 6f 72 73 |.<Errors|=>Errors|
|00000480| 3e 3a 09 09 09 46 6f 72 | 6d 61 74 74 69 6e 67 20 |>:...For|matting |
|00000490| 45 72 72 6f 72 20 4d 65 | 73 73 61 67 65 73 0a 3c |Error Me|ssages.<|
|000004a0| 4c 69 62 72 61 72 69 65 | 73 3d 3e 4c 69 62 72 61 |Librarie|s=>Libra|
|000004b0| 72 69 65 73 3e 3a 09 09 | 09 4c 69 62 72 61 72 79 |ries>:..|.Library|
|000004c0| 20 42 65 68 61 76 69 6f | 72 0a 3c 50 6f 72 74 61 | Behavio|r.<Porta|
|000004d0| 62 69 6c 69 74 79 3d 3e | 50 6f 72 74 61 62 69 6c |bility=>|Portabil|
|000004e0| 69 74 3e 3a 09 09 09 50 | 6f 72 74 61 62 69 6c 69 |it>:...P|ortabili|
|000004f0| 74 79 20 41 73 20 49 74 | 20 41 70 70 6c 69 65 73 |ty As It| Applies|
|00000500| 20 74 6f 20 47 4e 55 0a | 3c 55 73 65 72 20 49 6e | to GNU.|<User In|
|00000510| 74 65 72 66 61 63 65 73 | 3d 3e 55 73 65 72 49 6e |terfaces|=>UserIn|
|00000520| 74 65 72 66 3e 3a 09 09 | 53 74 61 6e 64 61 72 64 |terf>:..|Standard|
|00000530| 73 20 66 6f 72 20 43 6f | 6d 6d 61 6e 64 20 4c 69 |s for Co|mmand Li|
|00000540| 6e 65 20 49 6e 74 65 72 | 66 61 63 65 73 0a 3c 44 |ne Inter|faces.<D|
|00000550| 6f 63 75 6d 65 6e 74 61 | 74 69 6f 6e 3d 3e 44 6f |ocumenta|tion=>Do|
|00000560| 63 75 6d 65 6e 74 61 74 | 3e 3a 09 09 44 6f 63 75 |cumentat|>:..Docu|
|00000570| 6d 65 6e 74 69 6e 67 20 | 50 72 6f 67 72 61 6d 73 |menting |Programs|
|00000580| 0a 3c 52 65 6c 65 61 73 | 65 73 3d 3e 52 65 6c 65 |.<Releas|es=>Rele|
|00000590| 61 73 65 73 3e 3a 09 09 | 09 4d 61 6b 69 6e 67 20 |ases>:..|.Making |
|000005a0| 52 65 6c 65 61 73 65 73 | 0a 23 57 72 61 70 20 6f |Releases|.#Wrap o|
|000005b0| 6e 0a 0a 00 44 41 54 41 | 9c 0e 00 00 43 68 61 6e |n...DATA|....Chan|
|000005c0| 67 65 20 4c 6f 67 73 0a | 50 72 65 76 69 6f 75 73 |ge Logs.|Previous|
|000005d0| 3a 20 3c 43 6f 6e 74 72 | 69 62 75 74 69 6f 6e 73 |: <Contr|ibutions|
|000005e0| 3d 3e 43 6f 6e 74 72 69 | 62 75 74 69 3e 20 2a 20 |=>Contri|buti> * |
|000005f0| 4e 65 78 74 3a 20 3c 43 | 6f 6d 70 61 74 69 62 69 |Next: <C|ompatibi|
|00000600| 6c 69 74 79 3d 3e 43 6f | 6d 70 61 74 69 62 69 6c |lity=>Co|mpatibil|
|00000610| 3e 20 2a 20 55 70 3a 20 | 3c 54 6f 70 3d 3e 21 52 |> * Up: |<Top=>!R|
|00000620| 6f 6f 74 3e 0a 0a 23 57 | 72 61 70 20 6f 6e 0a 7b |oot>..#W|rap on.{|
|00000630| 66 48 32 7d 43 68 61 6e | 67 65 20 4c 6f 67 73 7b |fH2}Chan|ge Logs{|
|00000640| 66 7d 0a 0a 4b 65 65 70 | 20 61 20 63 68 61 6e 67 |f}..Keep| a chang|
|00000650| 65 20 6c 6f 67 20 66 6f | 72 20 65 61 63 68 20 64 |e log fo|r each d|
|00000660| 69 72 65 63 74 6f 72 79 | 2c 20 64 65 73 63 72 69 |irectory|, descri|
|00000670| 62 69 6e 67 20 74 68 65 | 20 63 68 61 6e 67 65 73 |bing the| changes|
|00000680| 20 6d 61 64 65 20 74 6f | 0a 73 6f 75 72 63 65 20 | made to|.source |
|00000690| 66 69 6c 65 73 20 69 6e | 20 74 68 61 74 20 64 69 |files in| that di|
|000006a0| 72 65 63 74 6f 72 79 2e | 20 20 54 68 65 20 70 75 |rectory.| The pu|
|000006b0| 72 70 6f 73 65 20 6f 66 | 20 74 68 69 73 20 69 73 |rpose of| this is|
|000006c0| 20 73 6f 20 74 68 61 74 | 20 70 65 6f 70 6c 65 0a | so that| people.|
|000006d0| 69 6e 76 65 73 74 69 67 | 61 74 69 6e 67 20 62 75 |investig|ating bu|
|000006e0| 67 73 20 69 6e 20 74 68 | 65 20 66 75 74 75 72 65 |gs in th|e future|
|000006f0| 20 77 69 6c 6c 20 6b 6e | 6f 77 20 61 62 6f 75 74 | will kn|ow about|
|00000700| 20 74 68 65 20 63 68 61 | 6e 67 65 73 20 74 68 61 | the cha|nges tha|
|00000710| 74 0a 6d 69 67 68 74 20 | 68 61 76 65 20 69 6e 74 |t.might |have int|
|00000720| 72 6f 64 75 63 65 64 20 | 74 68 65 20 62 75 67 2e |roduced |the bug.|
|00000730| 20 20 4f 66 74 65 6e 20 | 61 20 6e 65 77 20 62 75 | Often |a new bu|
|00000740| 67 20 63 61 6e 20 62 65 | 20 66 6f 75 6e 64 20 62 |g can be| found b|
|00000750| 79 0a 6c 6f 6f 6b 69 6e | 67 20 61 74 20 77 68 61 |y.lookin|g at wha|
|00000760| 74 20 77 61 73 20 72 65 | 63 65 6e 74 6c 79 20 63 |t was re|cently c|
|00000770| 68 61 6e 67 65 64 2e 20 | 20 4d 6f 72 65 20 69 6d |hanged. | More im|
|00000780| 70 6f 72 74 61 6e 74 6c | 79 2c 20 63 68 61 6e 67 |portantl|y, chang|
|00000790| 65 20 6c 6f 67 73 0a 63 | 61 6e 20 68 65 6c 70 20 |e logs.c|an help |
|000007a0| 65 6c 69 6d 69 6e 61 74 | 65 20 63 6f 6e 63 65 70 |eliminat|e concep|
|000007b0| 74 75 61 6c 20 69 6e 63 | 6f 6e 73 69 73 74 65 6e |tual inc|onsisten|
|000007c0| 63 69 65 73 20 62 65 74 | 77 65 65 6e 20 64 69 66 |cies bet|ween dif|
|000007d0| 66 65 72 65 6e 74 20 70 | 61 72 74 73 0a 6f 66 20 |ferent p|arts.of |
|000007e0| 61 20 70 72 6f 67 72 61 | 6d 3b 20 74 68 65 79 20 |a progra|m; they |
|000007f0| 63 61 6e 20 67 69 76 65 | 20 79 6f 75 20 61 20 68 |can give| you a h|
|00000800| 69 73 74 6f 72 79 20 6f | 66 20 68 6f 77 20 74 68 |istory o|f how th|
|00000810| 65 20 63 6f 6e 66 6c 69 | 63 74 69 6e 67 0a 63 6f |e confli|cting.co|
|00000820| 6e 63 65 70 74 73 20 61 | 72 6f 73 65 2e 0a 0a 55 |ncepts a|rose...U|
|00000830| 73 65 20 74 68 65 20 45 | 6d 61 63 73 20 63 6f 6d |se the E|macs com|
|00000840| 6d 61 6e 64 20 7b 66 43 | 6f 64 65 7d 4d 2d 78 20 |mand {fC|ode}M-x |
|00000850| 61 64 64 2d 63 68 61 6e | 67 65 7b 66 7d 20 74 6f |add-chan|ge{f} to|
|00000860| 20 73 74 61 72 74 20 61 | 20 6e 65 77 20 65 6e 74 | start a| new ent|
|00000870| 72 79 20 69 6e 20 74 68 | 65 0a 63 68 61 6e 67 65 |ry in th|e.change|
|00000880| 20 6c 6f 67 2e 20 20 41 | 6e 20 65 6e 74 72 79 20 | log. A|n entry |
|00000890| 73 68 6f 75 6c 64 20 68 | 61 76 65 20 61 6e 20 61 |should h|ave an a|
|000008a0| 73 74 65 72 69 73 6b 2c | 20 74 68 65 20 6e 61 6d |sterisk,| the nam|
|000008b0| 65 20 6f 66 20 74 68 65 | 20 63 68 61 6e 67 65 64 |e of the| changed|
|000008c0| 0a 66 69 6c 65 2c 20 61 | 6e 64 20 74 68 65 6e 20 |.file, a|nd then |
|000008d0| 69 6e 20 70 61 72 65 6e | 74 68 65 73 65 73 20 74 |in paren|theses t|
|000008e0| 68 65 20 6e 61 6d 65 20 | 6f 66 20 74 68 65 20 63 |he name |of the c|
|000008f0| 68 61 6e 67 65 64 20 66 | 75 6e 63 74 69 6f 6e 73 |hanged f|unctions|
|00000900| 2c 0a 76 61 72 69 61 62 | 6c 65 73 20 6f 72 20 77 |,.variab|les or w|
|00000910| 68 61 74 65 76 65 72 2c | 20 66 6f 6c 6c 6f 77 65 |hatever,| followe|
|00000920| 64 20 62 79 20 61 20 63 | 6f 6c 6f 6e 2e 20 20 54 |d by a c|olon. T|
|00000930| 68 65 6e 20 64 65 73 63 | 72 69 62 65 20 74 68 65 |hen desc|ribe the|
|00000940| 20 63 68 61 6e 67 65 73 | 0a 79 6f 75 20 6d 61 64 | changes|.you mad|
|00000950| 65 20 74 6f 20 74 68 61 | 74 20 66 75 6e 63 74 69 |e to tha|t functi|
|00000960| 6f 6e 20 6f 72 20 76 61 | 72 69 61 62 6c 65 2e 0a |on or va|riable..|
|00000970| 0a 53 65 70 61 72 61 74 | 65 20 75 6e 72 65 6c 61 |.Separat|e unrela|
|00000980| 74 65 64 20 65 6e 74 72 | 69 65 73 20 77 69 74 68 |ted entr|ies with|
|00000990| 20 62 6c 61 6e 6b 20 6c | 69 6e 65 73 2e 20 20 57 | blank l|ines. W|
|000009a0| 68 65 6e 20 74 77 6f 20 | 65 6e 74 72 69 65 73 0a |hen two |entries.|
|000009b0| 72 65 70 72 65 73 65 6e | 74 20 70 61 72 74 73 20 |represen|t parts |
|000009c0| 6f 66 20 74 68 65 20 73 | 61 6d 65 20 63 68 61 6e |of the s|ame chan|
|000009d0| 67 65 2c 20 73 6f 20 74 | 68 61 74 20 74 68 65 79 |ge, so t|hat they|
|000009e0| 20 77 6f 72 6b 20 74 6f | 67 65 74 68 65 72 2c 20 | work to|gether, |
|000009f0| 74 68 65 6e 0a 64 6f 6e | 27 74 20 70 75 74 20 62 |then.don|'t put b|
|00000a00| 6c 61 6e 6b 20 6c 69 6e | 65 73 20 62 65 74 77 65 |lank lin|es betwe|
|00000a10| 65 6e 20 74 68 65 6d 2e | 20 20 54 68 65 6e 20 79 |en them.| Then y|
|00000a20| 6f 75 20 63 61 6e 20 6f | 6d 69 74 20 74 68 65 20 |ou can o|mit the |
|00000a30| 66 69 6c 65 20 6e 61 6d | 65 0a 61 6e 64 20 74 68 |file nam|e.and th|
|00000a40| 65 20 61 73 74 65 72 69 | 73 6b 20 77 68 65 6e 20 |e asteri|sk when |
|00000a50| 73 75 63 63 65 73 73 69 | 76 65 20 65 6e 74 72 69 |successi|ve entri|
|00000a60| 65 73 20 61 72 65 20 69 | 6e 20 74 68 65 20 73 61 |es are i|n the sa|
|00000a70| 6d 65 20 66 69 6c 65 2e | 0a 0a 48 65 72 65 20 61 |me file.|..Here a|
|00000a80| 72 65 20 73 6f 6d 65 20 | 65 78 61 6d 70 6c 65 73 |re some |examples|
|00000a90| 3a 0a 0a 23 57 72 61 70 | 20 6f 66 66 0a 23 66 43 |:..#Wrap| off.#fC|
|00000aa0| 6f 64 65 0a 5c 2a 20 72 | 65 67 69 73 74 65 72 2e |ode.\* r|egister.|
|00000ab0| 65 6c 20 28 69 6e 73 65 | 72 74 2d 72 65 67 69 73 |el (inse|rt-regis|
|00000ac0| 74 65 72 29 3a 20 52 65 | 74 75 72 6e 20 6e 69 6c |ter): Re|turn nil|
|00000ad0| 2e 0a 28 6a 75 6d 70 2d | 74 6f 2d 72 65 67 69 73 |..(jump-|to-regis|
|00000ae0| 74 65 72 29 3a 20 4c 69 | 6b 65 77 69 73 65 2e 0a |ter): Li|kewise..|
|00000af0| 0a 5c 2a 20 73 6f 72 74 | 2e 65 6c 20 28 73 6f 72 |.\* sort|.el (sor|
|00000b00| 74 2d 73 75 62 72 29 3a | 20 52 65 74 75 72 6e 20 |t-subr):| Return |
|00000b10| 6e 69 6c 2e 0a 0a 5c 2a | 20 74 65 78 2d 6d 6f 64 |nil...\*| tex-mod|
|00000b20| 65 2e 65 6c 20 28 74 65 | 78 2d 62 69 62 74 65 78 |e.el (te|x-bibtex|
|00000b30| 2d 66 69 6c 65 2c 20 74 | 65 78 2d 66 69 6c 65 2c |-file, t|ex-file,|
|00000b40| 20 74 65 78 2d 72 65 67 | 69 6f 6e 29 3a 0a 52 65 | tex-reg|ion):.Re|
|00000b50| 73 74 61 72 74 20 74 68 | 65 20 74 65 78 20 73 68 |start th|e tex sh|
|00000b60| 65 6c 6c 20 69 66 20 70 | 72 6f 63 65 73 73 20 69 |ell if p|rocess i|
|00000b70| 73 20 67 6f 6e 65 20 6f | 72 20 73 74 6f 70 70 65 |s gone o|r stoppe|
|00000b80| 64 2e 0a 28 74 65 78 2d | 73 68 65 6c 6c 2d 72 75 |d..(tex-|shell-ru|
|00000b90| 6e 6e 69 6e 67 29 3a 20 | 4e 65 77 20 66 75 6e 63 |nning): |New func|
|00000ba0| 74 69 6f 6e 2e 0a 0a 5c | 2a 20 65 78 70 72 2e 63 |tion...\|* expr.c|
|00000bb0| 20 28 73 74 6f 72 65 5c | 5f 6f 6e 65 5c 5f 61 72 | (store\|_one\_ar|
|00000bc0| 67 29 3a 20 52 6f 75 6e | 64 20 73 69 7a 65 20 75 |g): Roun|d size u|
|00000bd0| 70 20 66 6f 72 20 6d 6f | 76 65 5c 5f 62 6c 6f 63 |p for mo|ve\_bloc|
|00000be0| 6b 5c 5f 74 6f 5c 5f 72 | 65 67 2e 0a 28 65 78 70 |k\_to\_r|eg..(exp|
|00000bf0| 61 6e 64 5c 5f 63 61 6c | 6c 29 3a 20 52 6f 75 6e |and\_cal|l): Roun|
|00000c00| 64 20 75 70 20 77 68 65 | 6e 20 65 6d 69 74 74 69 |d up whe|n emitti|
|00000c10| 6e 67 20 55 53 45 20 69 | 6e 73 6e 73 2e 0a 5c 2a |ng USE i|nsns..\*|
|00000c20| 20 73 74 6d 74 2e 63 20 | 28 61 73 73 69 67 6e 5c | stmt.c |(assign\|
|00000c30| 5f 70 61 72 6d 73 29 3a | 20 52 6f 75 6e 64 20 73 |_parms):| Round s|
|00000c40| 69 7a 65 20 75 70 20 66 | 6f 72 20 6d 6f 76 65 5c |ize up f|or move\|
|00000c50| 5f 62 6c 6f 63 6b 5c 5f | 66 72 6f 6d 5c 5f 72 65 |_block\_|from\_re|
|00000c60| 67 2e 0a 23 66 0a 23 57 | 72 61 70 20 6f 6e 0a 0a |g..#f.#W|rap on..|
|00000c70| 49 74 27 73 20 69 6d 70 | 6f 72 74 61 6e 74 20 74 |It's imp|ortant t|
|00000c80| 6f 20 6e 61 6d 65 20 74 | 68 65 20 63 68 61 6e 67 |o name t|he chang|
|00000c90| 65 64 20 66 75 6e 63 74 | 69 6f 6e 20 6f 72 20 76 |ed funct|ion or v|
|00000ca0| 61 72 69 61 62 6c 65 20 | 69 6e 20 66 75 6c 6c 2e |ariable |in full.|
|00000cb0| 20 20 44 6f 6e 27 74 0a | 61 62 62 72 65 76 69 61 | Don't.|abbrevia|
|00000cc0| 74 65 20 74 68 65 6d 3b | 20 64 6f 6e 27 74 20 63 |te them;| don't c|
|00000cd0| 6f 6d 62 69 6e 65 20 74 | 68 65 6d 2e 20 20 53 75 |ombine t|hem. Su|
|00000ce0| 62 73 65 71 75 65 6e 74 | 20 6d 61 69 6e 74 61 69 |bsequent| maintai|
|00000cf0| 6e 65 72 73 20 77 69 6c | 6c 20 6f 66 74 65 6e 0a |ners wil|l often.|
|00000d00| 73 65 61 72 63 68 20 66 | 6f 72 20 61 20 66 75 6e |search f|or a fun|
|00000d10| 63 74 69 6f 6e 20 6e 61 | 6d 65 20 74 6f 20 66 69 |ction na|me to fi|
|00000d20| 6e 64 20 61 6c 6c 20 74 | 68 65 20 63 68 61 6e 67 |nd all t|he chang|
|00000d30| 65 20 6c 6f 67 20 65 6e | 74 72 69 65 73 20 74 68 |e log en|tries th|
|00000d40| 61 74 0a 70 65 72 74 61 | 69 6e 20 74 6f 20 69 74 |at.perta|in to it|
|00000d50| 3b 20 69 66 20 79 6f 75 | 20 61 62 62 72 65 76 69 |; if you| abbrevi|
|00000d60| 61 74 65 20 74 68 65 20 | 6e 61 6d 65 2c 20 74 68 |ate the |name, th|
|00000d70| 65 79 20 77 6f 6e 27 74 | 20 66 69 6e 64 20 69 74 |ey won't| find it|
|00000d80| 20 77 68 65 6e 20 74 68 | 65 79 0a 73 65 61 72 63 | when th|ey.searc|
|00000d90| 68 2e 20 20 46 6f 72 20 | 65 78 61 6d 70 6c 65 2c |h. For |example,|
|00000da0| 20 73 6f 6d 65 20 70 65 | 6f 70 6c 65 20 61 72 65 | some pe|ople are|
|00000db0| 20 74 65 6d 70 74 65 64 | 20 74 6f 20 61 62 62 72 | tempted| to abbr|
|00000dc0| 65 76 69 61 74 65 20 67 | 72 6f 75 70 73 20 6f 66 |eviate g|roups of|
|00000dd0| 0a 66 75 6e 63 74 69 6f | 6e 20 6e 61 6d 65 73 20 |.functio|n names |
|00000de0| 62 79 20 77 72 69 74 69 | 6e 67 20 7b 66 45 6d 70 |by writi|ng {fEmp|
|00000df0| 68 61 73 69 73 7d 5c 2a | 20 72 65 67 69 73 74 65 |hasis}\*| registe|
|00000e00| 72 2e 65 6c 0a 28 5c 7b | 69 6e 73 65 72 74 2c 6a |r.el.(\{|insert,j|
|00000e10| 75 6d 70 2d 74 6f 5c 7d | 2d 72 65 67 69 73 74 65 |ump-to\}|-registe|
|00000e20| 72 29 7b 66 7d 3b 20 74 | 68 69 73 20 69 73 20 6e |r){f}; t|his is n|
|00000e30| 6f 74 20 61 20 67 6f 6f | 64 20 69 64 65 61 2c 20 |ot a goo|d idea, |
|00000e40| 73 69 6e 63 65 20 73 65 | 61 72 63 68 69 6e 67 0a |since se|arching.|
|00000e50| 66 6f 72 20 7b 66 43 6f | 64 65 7d 6a 75 6d 70 2d |for {fCo|de}jump-|
|00000e60| 74 6f 2d 72 65 67 69 73 | 74 65 72 7b 66 7d 20 6f |to-regis|ter{f} o|
|00000e70| 72 20 7b 66 43 6f 64 65 | 7d 69 6e 73 65 72 74 2d |r {fCode|}insert-|
|00000e80| 72 65 67 69 73 74 65 72 | 7b 66 7d 20 77 6f 75 6c |register|{f} woul|
|00000e90| 64 20 6e 6f 74 20 66 69 | 6e 64 20 74 68 65 0a 65 |d not fi|nd the.e|
|00000ea0| 6e 74 72 79 2e 0a 0a 54 | 68 65 72 65 27 73 20 6e |ntry...T|here's n|
|00000eb0| 6f 20 6e 65 65 64 20 74 | 6f 20 64 65 73 63 72 69 |o need t|o descri|
|00000ec0| 62 65 20 74 68 65 20 66 | 75 6c 6c 20 70 75 72 70 |be the f|ull purp|
|00000ed0| 6f 73 65 20 6f 66 20 74 | 68 65 20 63 68 61 6e 67 |ose of t|he chang|
|00000ee0| 65 73 20 6f 72 20 68 6f | 77 20 74 68 65 79 0a 77 |es or ho|w they.w|
|00000ef0| 6f 72 6b 20 74 6f 67 65 | 74 68 65 72 2e 20 20 49 |ork toge|ther. I|
|00000f00| 74 20 69 73 20 62 65 74 | 74 65 72 20 74 6f 20 70 |t is bet|ter to p|
|00000f10| 75 74 20 73 75 63 68 20 | 65 78 70 6c 61 6e 61 74 |ut such |explanat|
|00000f20| 69 6f 6e 73 20 69 6e 20 | 63 6f 6d 6d 65 6e 74 73 |ions in |comments|
|00000f30| 20 69 6e 20 74 68 65 0a | 63 6f 64 65 2e 20 20 54 | in the.|code. T|
|00000f40| 68 61 74 27 73 20 77 68 | 79 20 6a 75 73 74 20 60 |hat's wh|y just `|
|00000f50| 60 4e 65 77 20 66 75 6e | 63 74 69 6f 6e 27 27 20 |`New fun|ction'' |
|00000f60| 69 73 20 65 6e 6f 75 67 | 68 3b 20 74 68 65 72 65 |is enoug|h; there|
|00000f70| 20 69 73 20 61 20 63 6f | 6d 6d 65 6e 74 0a 77 69 | is a co|mment.wi|
|00000f80| 74 68 20 74 68 65 20 66 | 75 6e 63 74 69 6f 6e 20 |th the f|unction |
|00000f90| 69 6e 20 74 68 65 20 73 | 6f 75 72 63 65 20 74 6f |in the s|ource to|
|00000fa0| 20 65 78 70 6c 61 69 6e | 20 77 68 61 74 20 69 74 | explain| what it|
|00000fb0| 20 64 6f 65 73 2e 0a 0a | 48 6f 77 65 76 65 72 2c | does...|However,|
|00000fc0| 20 73 6f 6d 65 74 69 6d | 65 73 20 69 74 20 69 73 | sometim|es it is|
|00000fd0| 20 75 73 65 66 75 6c 20 | 74 6f 20 77 72 69 74 65 | useful |to write|
|00000fe0| 20 6f 6e 65 20 6c 69 6e | 65 20 74 6f 20 64 65 73 | one lin|e to des|
|00000ff0| 63 72 69 62 65 20 74 68 | 65 0a 6f 76 65 72 61 6c |cribe th|e.overal|
|00001000| 6c 20 70 75 72 70 6f 73 | 65 20 6f 66 20 61 20 6c |l purpos|e of a l|
|00001010| 61 72 67 65 20 62 61 74 | 63 68 20 6f 66 20 63 68 |arge bat|ch of ch|
|00001020| 61 6e 67 65 73 2e 0a 0a | 59 6f 75 20 63 61 6e 20 |anges...|You can |
|00001030| 74 68 69 6e 6b 20 6f 66 | 20 74 68 65 20 63 68 61 |think of| the cha|
|00001040| 6e 67 65 20 6c 6f 67 20 | 61 73 20 61 20 63 6f 6e |nge log |as a con|
|00001050| 63 65 70 74 75 61 6c 20 | 60 60 75 6e 64 6f 20 6c |ceptual |``undo l|
|00001060| 69 73 74 27 27 20 77 68 | 69 63 68 0a 65 78 70 6c |ist'' wh|ich.expl|
|00001070| 61 69 6e 73 20 68 6f 77 | 20 65 61 72 6c 69 65 72 |ains how| earlier|
|00001080| 20 76 65 72 73 69 6f 6e | 73 20 77 65 72 65 20 64 | version|s were d|
|00001090| 69 66 66 65 72 65 6e 74 | 20 66 72 6f 6d 20 74 68 |ifferent| from th|
|000010a0| 65 20 63 75 72 72 65 6e | 74 20 76 65 72 73 69 6f |e curren|t versio|
|000010b0| 6e 2e 0a 50 65 6f 70 6c | 65 20 63 61 6e 20 73 65 |n..Peopl|e can se|
|000010c0| 65 20 74 68 65 20 63 75 | 72 72 65 6e 74 20 76 65 |e the cu|rrent ve|
|000010d0| 72 73 69 6f 6e 3b 20 74 | 68 65 79 20 64 6f 6e 27 |rsion; t|hey don'|
|000010e0| 74 20 6e 65 65 64 20 74 | 68 65 20 63 68 61 6e 67 |t need t|he chang|
|000010f0| 65 20 6c 6f 67 0a 74 6f | 20 74 65 6c 6c 20 74 68 |e log.to| tell th|
|00001100| 65 6d 20 77 68 61 74 20 | 69 73 20 69 6e 20 69 74 |em what |is in it|
|00001110| 2e 20 20 57 68 61 74 20 | 74 68 65 79 20 77 61 6e |. What |they wan|
|00001120| 74 20 66 72 6f 6d 20 61 | 20 63 68 61 6e 67 65 20 |t from a| change |
|00001130| 6c 6f 67 20 69 73 20 61 | 0a 63 6c 65 61 72 20 65 |log is a|.clear e|
|00001140| 78 70 6c 61 6e 61 74 69 | 6f 6e 20 6f 66 20 68 6f |xplanati|on of ho|
|00001150| 77 20 74 68 65 20 65 61 | 72 6c 69 65 72 20 76 65 |w the ea|rlier ve|
|00001160| 72 73 69 6f 6e 20 64 69 | 66 66 65 72 65 64 2e 0a |rsion di|ffered..|
|00001170| 0a 57 68 65 6e 20 79 6f | 75 20 63 68 61 6e 67 65 |.When yo|u change|
|00001180| 20 74 68 65 20 63 61 6c | 6c 69 6e 67 20 73 65 71 | the cal|ling seq|
|00001190| 75 65 6e 63 65 20 6f 66 | 20 61 20 66 75 6e 63 74 |uence of| a funct|
|000011a0| 69 6f 6e 20 69 6e 20 61 | 20 73 69 6d 70 6c 65 0a |ion in a| simple.|
|000011b0| 66 61 73 68 69 6f 6e 2c | 20 61 6e 64 20 79 6f 75 |fashion,| and you|
|000011c0| 20 63 68 61 6e 67 65 20 | 61 6c 6c 20 74 68 65 20 | change |all the |
|000011d0| 63 61 6c 6c 65 72 73 20 | 6f 66 20 74 68 65 20 66 |callers |of the f|
|000011e0| 75 6e 63 74 69 6f 6e 2c | 20 74 68 65 72 65 20 69 |unction,| there i|
|000011f0| 73 20 6e 6f 0a 6e 65 65 | 64 20 74 6f 20 6d 61 6b |s no.nee|d to mak|
|00001200| 65 20 69 6e 64 69 76 69 | 64 75 61 6c 20 65 6e 74 |e indivi|dual ent|
|00001210| 72 69 65 73 20 66 6f 72 | 20 61 6c 6c 20 74 68 65 |ries for| all the|
|00001220| 20 63 61 6c 6c 65 72 73 | 2e 20 20 4a 75 73 74 20 | callers|. Just |
|00001230| 77 72 69 74 65 20 69 6e | 0a 74 68 65 20 65 6e 74 |write in|.the ent|
|00001240| 72 79 20 66 6f 72 20 74 | 68 65 20 66 75 6e 63 74 |ry for t|he funct|
|00001250| 69 6f 6e 20 62 65 69 6e | 67 20 63 61 6c 6c 65 64 |ion bein|g called|
|00001260| 2c 20 60 60 41 6c 6c 20 | 63 61 6c 6c 65 72 73 20 |, ``All |callers |
|00001270| 63 68 61 6e 67 65 64 2e | 27 27 0a 0a 57 68 65 6e |changed.|''..When|
|00001280| 20 79 6f 75 20 63 68 61 | 6e 67 65 20 6a 75 73 74 | you cha|nge just|
|00001290| 20 63 6f 6d 6d 65 6e 74 | 73 20 6f 72 20 64 6f 63 | comment|s or doc|
|000012a0| 20 73 74 72 69 6e 67 73 | 2c 20 69 74 20 69 73 20 | strings|, it is |
|000012b0| 65 6e 6f 75 67 68 20 74 | 6f 20 77 72 69 74 65 20 |enough t|o write |
|000012c0| 61 6e 0a 65 6e 74 72 79 | 20 66 6f 72 20 74 68 65 |an.entry| for the|
|000012d0| 20 66 69 6c 65 2c 20 77 | 69 74 68 6f 75 74 20 6d | file, w|ithout m|
|000012e0| 65 6e 74 69 6f 6e 69 6e | 67 20 74 68 65 20 66 75 |entionin|g the fu|
|000012f0| 6e 63 74 69 6f 6e 73 2e | 20 20 57 72 69 74 65 20 |nctions.| Write |
|00001300| 6a 75 73 74 2c 0a 60 60 | 44 6f 63 20 66 69 78 2e |just,.``|Doc fix.|
|00001310| 27 27 20 20 54 68 65 72 | 65 27 73 20 6e 6f 20 6e |'' Ther|e's no n|
|00001320| 65 65 64 20 74 6f 20 6b | 65 65 70 20 61 20 63 68 |eed to k|eep a ch|
|00001330| 61 6e 67 65 20 6c 6f 67 | 20 66 6f 72 20 64 6f 63 |ange log| for doc|
|00001340| 75 6d 65 6e 74 61 74 69 | 6f 6e 0a 66 69 6c 65 73 |umentati|on.files|
|00001350| 2e 20 20 54 68 69 73 20 | 69 73 20 62 65 63 61 75 |. This |is becau|
|00001360| 73 65 20 64 6f 63 75 6d | 65 6e 74 61 74 69 6f 6e |se docum|entation|
|00001370| 20 69 73 20 6e 6f 74 20 | 73 75 73 63 65 70 74 69 | is not |suscepti|
|00001380| 62 6c 65 20 74 6f 20 62 | 75 67 73 20 74 68 61 74 |ble to b|ugs that|
|00001390| 0a 61 72 65 20 68 61 72 | 64 20 74 6f 20 66 69 78 |.are har|d to fix|
|000013a0| 2e 20 20 44 6f 63 75 6d | 65 6e 74 61 74 69 6f 6e |. Docum|entation|
|000013b0| 20 64 6f 65 73 20 6e 6f | 74 20 63 6f 6e 73 69 73 | does no|t consis|
|000013c0| 74 20 6f 66 20 70 61 72 | 74 73 20 74 68 61 74 20 |t of par|ts that |
|000013d0| 6d 75 73 74 0a 69 6e 74 | 65 72 61 63 74 20 69 6e |must.int|eract in|
|000013e0| 20 61 20 70 72 65 63 69 | 73 65 6c 79 20 65 6e 67 | a preci|sely eng|
|000013f0| 69 6e 65 65 72 65 64 20 | 66 61 73 68 69 6f 6e 3b |ineered |fashion;|
|00001400| 20 74 6f 20 63 6f 72 72 | 65 63 74 20 61 6e 20 65 | to corr|ect an e|
|00001410| 72 72 6f 72 2c 20 79 6f | 75 0a 6e 65 65 64 20 6e |rror, yo|u.need n|
|00001420| 6f 74 20 6b 6e 6f 77 20 | 74 68 65 20 68 69 73 74 |ot know |the hist|
|00001430| 6f 72 79 20 6f 66 20 74 | 68 65 20 65 72 72 6f 6e |ory of t|he erron|
|00001440| 65 6f 75 73 20 70 61 73 | 73 61 67 65 2e 0a 0a 0a |eous pas|sage....|
|00001450| 46 52 45 45 60 01 00 00 | 2c 00 00 00 80 00 00 00 |FREE`...|,.......|
|00001460| 46 ff ff ff 21 a6 ec 2a | 33 05 00 00 33 00 00 00 |F...!..*|3...3...|
|00001470| 00 00 00 00 21 52 6f 6f | 74 00 00 00 b4 05 00 00 |....!Roo|t.......|
|00001480| 46 ff ff ff cd a8 ec 2a | 9c 0e 00 00 33 00 00 00 |F......*|....3...|
|00001490| 00 00 00 00 43 68 61 6e | 67 65 4c 6f 67 73 00 00 |....Chan|geLogs..|
|000014a0| b0 15 00 00 46 ff ff ff | bc b1 ec 2a 0c 0c 00 00 |....F...|...*....|
|000014b0| 13 00 00 00 00 00 00 00 | 43 6f 6d 6d 61 6e 64 56 |........|CommandV|
|000014c0| 61 72 00 00 bc 21 00 00 | 46 ff ff ff 48 b7 ec 2a |ar...!..|F...H..*|
|000014d0| 58 0b 00 00 13 00 00 00 | 00 00 00 00 43 6f 6d 6d |X.......|....Comm|
|000014e0| 65 6e 74 73 00 00 00 00 | 14 2d 00 00 46 ff ff ff |ents....|.-..F...|
|000014f0| fc aa ec 2a 6f 06 00 00 | 13 00 00 00 00 00 00 00 |...*o...|........|
|00001500| 43 6f 6d 70 61 74 69 62 | 69 6c 00 00 84 33 00 00 |Compatib|il...3..|
|00001510| 46 ff ff ff 69 b4 ec 2a | e3 1e 00 00 13 00 00 00 |F...i..*|........|
|00001520| 00 00 00 00 43 6f 6e 66 | 69 67 75 72 61 74 00 00 |....Conf|igurat..|
|00001530| 68 52 00 00 46 ff ff ff | 9e a7 ec 2a 43 06 00 00 |hR..F...|...*C...|
|00001540| 13 00 00 00 00 00 00 00 | 43 6f 6e 74 72 69 62 75 |........|Contribu|
|00001550| 74 69 00 00 ac 58 00 00 | 46 ff ff ff 3b b3 ec 2a |ti...X..|F...;..*|
|00001560| 83 1b 00 00 13 00 00 00 | 00 00 00 00 44 69 72 65 |........|....Dire|
|00001570| 63 74 6f 72 79 56 00 00 | 30 74 00 00 46 ff ff ff |ctoryV..|0t..F...|
|00001580| 62 ca ec 2a ba 0f 00 00 | 13 00 00 00 00 00 00 00 |b..*....|........|
|00001590| 44 6f 63 75 6d 65 6e 74 | 61 74 00 00 ff ff ff ff |Document|at......|
|000015a0| ff ff ff ff ff ff ff ff | ff ff ff ff ff ff ff ff |........|........|
|000015b0| 44 41 54 41 0c 0c 00 00 | 43 6f 6d 6d 61 6e 64 20 |DATA....|Command |
|000015c0| 56 61 72 69 61 62 6c 65 | 73 0a 50 72 65 76 69 6f |Variable|s.Previo|
|000015d0| 75 73 3a 20 3c 53 74 61 | 6e 64 61 72 64 20 54 61 |us: <Sta|ndard Ta|
|000015e0| 72 67 65 74 73 3d 3e 53 | 74 61 6e 64 61 72 64 54 |rgets=>S|tandardT|
|000015f0| 61 3e 20 2a 20 4e 65 78 | 74 3a 20 3c 44 69 72 65 |a> * Nex|t: <Dire|
|00001600| 63 74 6f 72 79 20 56 61 | 72 69 61 62 6c 65 73 3d |ctory Va|riables=|
|00001610| 3e 44 69 72 65 63 74 6f | 72 79 56 3e 20 2a 20 55 |>Directo|ryV> * U|
|00001620| 70 3a 20 3c 4d 61 6b 65 | 66 69 6c 65 20 43 6f 6e |p: <Make|file Con|
|00001630| 76 65 6e 74 69 6f 6e 73 | 3d 3e 4d 61 6b 65 66 69 |ventions|=>Makefi|
|00001640| 6c 65 43 6f 3e 0a 0a 23 | 57 72 61 70 20 6f 6e 0a |leCo>..#|Wrap on.|
|00001650| 7b 66 48 33 7d 56 61 72 | 69 61 62 6c 65 73 20 66 |{fH3}Var|iables f|
|00001660| 6f 72 20 53 70 65 63 69 | 66 79 69 6e 67 20 43 6f |or Speci|fying Co|
|00001670| 6d 6d 61 6e 64 73 7b 66 | 7d 0a 0a 4d 61 6b 65 66 |mmands{f|}..Makef|
|00001680| 69 6c 65 73 20 73 68 6f | 75 6c 64 20 70 72 6f 76 |iles sho|uld prov|
|00001690| 69 64 65 20 76 61 72 69 | 61 62 6c 65 73 20 66 6f |ide vari|ables fo|
|000016a0| 72 20 6f 76 65 72 72 69 | 64 69 6e 67 20 63 65 72 |r overri|ding cer|
|000016b0| 74 61 69 6e 20 63 6f 6d | 6d 61 6e 64 73 2c 20 6f |tain com|mands, o|
|000016c0| 70 74 69 6f 6e 73 2c 0a | 61 6e 64 20 73 6f 20 6f |ptions,.|and so o|
|000016d0| 6e 2e 0a 0a 49 6e 20 70 | 61 72 74 69 63 75 6c 61 |n...In p|articula|
|000016e0| 72 2c 20 79 6f 75 20 73 | 68 6f 75 6c 64 20 72 75 |r, you s|hould ru|
|000016f0| 6e 20 6d 6f 73 74 20 75 | 74 69 6c 69 74 79 20 70 |n most u|tility p|
|00001700| 72 6f 67 72 61 6d 73 20 | 76 69 61 20 76 61 72 69 |rograms |via vari|
|00001710| 61 62 6c 65 73 2e 0a 54 | 68 75 73 2c 20 69 66 20 |ables..T|hus, if |
|00001720| 79 6f 75 20 75 73 65 20 | 42 69 73 6f 6e 2c 20 68 |you use |Bison, h|
|00001730| 61 76 65 20 61 20 76 61 | 72 69 61 62 6c 65 20 6e |ave a va|riable n|
|00001740| 61 6d 65 64 20 7b 66 43 | 6f 64 65 7d 42 49 53 4f |amed {fC|ode}BISO|
|00001750| 4e 7b 66 7d 20 77 68 6f | 73 65 20 64 65 66 61 75 |N{f} who|se defau|
|00001760| 6c 74 0a 76 61 6c 75 65 | 20 69 73 20 73 65 74 20 |lt.value| is set |
|00001770| 77 69 74 68 20 7b 66 45 | 6d 70 68 61 73 69 73 7d |with {fE|mphasis}|
|00001780| 42 49 53 4f 4e 20 3d 20 | 62 69 73 6f 6e 7b 66 7d |BISON = |bison{f}|
|00001790| 2c 20 61 6e 64 20 72 65 | 66 65 72 20 74 6f 20 69 |, and re|fer to i|
|000017a0| 74 20 77 69 74 68 0a 7b | 66 43 6f 64 65 7d 24 28 |t with.{|fCode}$(|
|000017b0| 42 49 53 4f 4e 29 7b 66 | 7d 20 77 68 65 6e 65 76 |BISON){f|} whenev|
|000017c0| 65 72 20 79 6f 75 20 6e | 65 65 64 20 74 6f 20 75 |er you n|eed to u|
|000017d0| 73 65 20 42 69 73 6f 6e | 2e 0a 0a 46 69 6c 65 20 |se Bison|...File |
|000017e0| 6d 61 6e 61 67 65 6d 65 | 6e 74 20 75 74 69 6c 69 |manageme|nt utili|
|000017f0| 74 69 65 73 20 73 75 63 | 68 20 61 73 20 7b 66 43 |ties suc|h as {fC|
|00001800| 6f 64 65 7d 6c 6e 7b 66 | 7d 2c 20 7b 66 43 6f 64 |ode}ln{f|}, {fCod|
|00001810| 65 7d 72 6d 7b 66 7d 2c | 20 7b 66 43 6f 64 65 7d |e}rm{f},| {fCode}|
|00001820| 6d 76 7b 66 7d 2c 20 61 | 6e 64 0a 73 6f 20 6f 6e |mv{f}, a|nd.so on|
|00001830| 2c 20 6e 65 65 64 20 6e | 6f 74 20 62 65 20 72 65 |, need n|ot be re|
|00001840| 66 65 72 72 65 64 20 74 | 6f 20 74 68 72 6f 75 67 |ferred t|o throug|
|00001850| 68 20 76 61 72 69 61 62 | 6c 65 73 20 69 6e 20 74 |h variab|les in t|
|00001860| 68 69 73 20 77 61 79 2c | 20 73 69 6e 63 65 20 75 |his way,| since u|
|00001870| 73 65 72 73 0a 64 6f 6e | 27 74 20 6e 65 65 64 20 |sers.don|'t need |
|00001880| 74 6f 20 72 65 70 6c 61 | 63 65 20 74 68 65 6d 20 |to repla|ce them |
|00001890| 77 69 74 68 20 6f 74 68 | 65 72 20 70 72 6f 67 72 |with oth|er progr|
|000018a0| 61 6d 73 2e 0a 0a 45 61 | 63 68 20 70 72 6f 67 72 |ams...Ea|ch progr|
|000018b0| 61 6d 2d 6e 61 6d 65 20 | 76 61 72 69 61 62 6c 65 |am-name |variable|
|000018c0| 20 73 68 6f 75 6c 64 20 | 63 6f 6d 65 20 77 69 74 | should |come wit|
|000018d0| 68 20 61 6e 20 6f 70 74 | 69 6f 6e 73 20 76 61 72 |h an opt|ions var|
|000018e0| 69 61 62 6c 65 20 74 68 | 61 74 20 69 73 0a 75 73 |iable th|at is.us|
|000018f0| 65 64 20 74 6f 20 73 75 | 70 70 6c 79 20 6f 70 74 |ed to su|pply opt|
|00001900| 69 6f 6e 73 20 74 6f 20 | 74 68 65 20 70 72 6f 67 |ions to |the prog|
|00001910| 72 61 6d 2e 20 20 41 70 | 70 65 6e 64 20 7b 66 45 |ram. Ap|pend {fE|
|00001920| 6d 70 68 61 73 69 73 7d | 46 4c 41 47 53 7b 66 7d |mphasis}|FLAGS{f}|
|00001930| 20 74 6f 20 74 68 65 0a | 70 72 6f 67 72 61 6d 2d | to the.|program-|
|00001940| 6e 61 6d 65 20 76 61 72 | 69 61 62 6c 65 20 6e 61 |name var|iable na|
|00001950| 6d 65 20 74 6f 20 67 65 | 74 20 74 68 65 20 6f 70 |me to ge|t the op|
|00001960| 74 69 6f 6e 73 20 76 61 | 72 69 61 62 6c 65 20 6e |tions va|riable n|
|00001970| 61 6d 65 2d 2d 2d 66 6f | 72 0a 65 78 61 6d 70 6c |ame---fo|r.exampl|
|00001980| 65 2c 20 7b 66 43 6f 64 | 65 7d 42 49 53 4f 4e 46 |e, {fCod|e}BISONF|
|00001990| 4c 41 47 53 7b 66 7d 2e | 20 20 28 54 68 65 20 6e |LAGS{f}.| (The n|
|000019a0| 61 6d 65 20 7b 66 43 6f | 64 65 7d 43 46 4c 41 47 |ame {fCo|de}CFLAG|
|000019b0| 53 7b 66 7d 20 69 73 20 | 61 6e 20 65 78 63 65 70 |S{f} is |an excep|
|000019c0| 74 69 6f 6e 20 74 6f 0a | 74 68 69 73 20 72 75 6c |tion to.|this rul|
|000019d0| 65 2c 20 62 75 74 20 77 | 65 20 6b 65 65 70 20 69 |e, but w|e keep i|
|000019e0| 74 20 62 65 63 61 75 73 | 65 20 69 74 20 69 73 20 |t becaus|e it is |
|000019f0| 73 74 61 6e 64 61 72 64 | 2e 29 20 20 55 73 65 20 |standard|.) Use |
|00001a00| 7b 66 43 6f 64 65 7d 43 | 50 50 46 4c 41 47 53 7b |{fCode}C|PPFLAGS{|
|00001a10| 66 7d 0a 69 6e 20 61 6e | 79 20 63 6f 6d 70 69 6c |f}.in an|y compil|
|00001a20| 61 74 69 6f 6e 20 63 6f | 6d 6d 61 6e 64 20 74 68 |ation co|mmand th|
|00001a30| 61 74 20 72 75 6e 73 20 | 74 68 65 20 70 72 65 70 |at runs |the prep|
|00001a40| 72 6f 63 65 73 73 6f 72 | 2c 20 61 6e 64 20 75 73 |rocessor|, and us|
|00001a50| 65 0a 7b 66 43 6f 64 65 | 7d 4c 44 46 4c 41 47 53 |e.{fCode|}LDFLAGS|
|00001a60| 7b 66 7d 20 69 6e 20 61 | 6e 79 20 63 6f 6d 70 69 |{f} in a|ny compi|
|00001a70| 6c 61 74 69 6f 6e 20 63 | 6f 6d 6d 61 6e 64 20 74 |lation c|ommand t|
|00001a80| 68 61 74 20 64 6f 65 73 | 20 6c 69 6e 6b 69 6e 67 |hat does| linking|
|00001a90| 20 61 73 20 77 65 6c 6c | 20 61 73 0a 69 6e 20 61 | as well| as.in a|
|00001aa0| 6e 79 20 64 69 72 65 63 | 74 20 75 73 65 20 6f 66 |ny direc|t use of|
|00001ab0| 20 7b 66 43 6f 64 65 7d | 6c 64 7b 66 7d 2e 0a 0a | {fCode}|ld{f}...|
|00001ac0| 49 66 20 74 68 65 72 65 | 20 61 72 65 20 43 20 63 |If there| are C c|
|00001ad0| 6f 6d 70 69 6c 65 72 20 | 6f 70 74 69 6f 6e 73 20 |ompiler |options |
|00001ae0| 74 68 61 74 20 7b 66 45 | 6d 70 68 61 73 69 73 7d |that {fE|mphasis}|
|00001af0| 6d 75 73 74 7b 66 7d 20 | 62 65 20 75 73 65 64 20 |must{f} |be used |
|00001b00| 66 6f 72 20 70 72 6f 70 | 65 72 0a 63 6f 6d 70 69 |for prop|er.compi|
|00001b10| 6c 61 74 69 6f 6e 20 6f | 66 20 63 65 72 74 61 69 |lation o|f certai|
|00001b20| 6e 20 66 69 6c 65 73 2c | 20 64 6f 20 6e 6f 74 20 |n files,| do not |
|00001b30| 69 6e 63 6c 75 64 65 20 | 74 68 65 6d 20 69 6e 20 |include |them in |
|00001b40| 7b 66 43 6f 64 65 7d 43 | 46 4c 41 47 53 7b 66 7d |{fCode}C|FLAGS{f}|
|00001b50| 2e 0a 55 73 65 72 73 20 | 65 78 70 65 63 74 20 74 |..Users |expect t|
|00001b60| 6f 20 62 65 20 61 62 6c | 65 20 74 6f 20 73 70 65 |o be abl|e to spe|
|00001b70| 63 69 66 79 20 7b 66 43 | 6f 64 65 7d 43 46 4c 41 |cify {fC|ode}CFLA|
|00001b80| 47 53 7b 66 7d 20 66 72 | 65 65 6c 79 20 74 68 65 |GS{f} fr|eely the|
|00001b90| 6d 73 65 6c 76 65 73 2e | 0a 49 6e 73 74 65 61 64 |mselves.|.Instead|
|00001ba0| 2c 20 61 72 72 61 6e 67 | 65 20 74 6f 20 70 61 73 |, arrang|e to pas|
|00001bb0| 73 20 74 68 65 20 6e 65 | 63 65 73 73 61 72 79 20 |s the ne|cessary |
|00001bc0| 6f 70 74 69 6f 6e 73 20 | 74 6f 20 74 68 65 20 43 |options |to the C|
|00001bd0| 20 63 6f 6d 70 69 6c 65 | 72 0a 69 6e 64 65 70 65 | compile|r.indepe|
|00001be0| 6e 64 65 6e 74 6c 79 20 | 6f 66 20 7b 66 43 6f 64 |ndently |of {fCod|
|00001bf0| 65 7d 43 46 4c 41 47 53 | 7b 66 7d 2c 20 62 79 20 |e}CFLAGS|{f}, by |
|00001c00| 77 72 69 74 69 6e 67 20 | 74 68 65 6d 20 65 78 70 |writing |them exp|
|00001c10| 6c 69 63 69 74 6c 79 20 | 69 6e 20 74 68 65 0a 63 |licitly |in the.c|
|00001c20| 6f 6d 70 69 6c 61 74 69 | 6f 6e 20 63 6f 6d 6d 61 |ompilati|on comma|
|00001c30| 6e 64 73 20 6f 72 20 62 | 79 20 64 65 66 69 6e 69 |nds or b|y defini|
|00001c40| 6e 67 20 61 6e 20 69 6d | 70 6c 69 63 69 74 20 72 |ng an im|plicit r|
|00001c50| 75 6c 65 2c 20 6c 69 6b | 65 20 74 68 69 73 3a 0a |ule, lik|e this:.|
|00001c60| 0a 23 57 72 61 70 20 6f | 66 66 0a 23 66 43 6f 64 |.#Wrap o|ff.#fCod|
|00001c70| 65 0a 43 46 4c 41 47 53 | 20 3d 20 2d 67 0a 41 4c |e.CFLAGS| = -g.AL|
|00001c80| 4c 5c 5f 43 46 4c 41 47 | 53 20 3d 20 2d 49 2e 20 |L\_CFLAG|S = -I. |
|00001c90| 24 28 43 46 4c 41 47 53 | 29 0a 2e 63 2e 6f 3a 0a |$(CFLAGS|)..c.o:.|
|00001ca0| 20 20 20 20 20 20 20 20 | 24 28 43 43 29 20 2d 63 | |$(CC) -c|
|00001cb0| 20 24 28 43 50 50 46 4c | 41 47 53 29 20 24 28 41 | $(CPPFL|AGS) $(A|
|00001cc0| 4c 4c 5c 5f 43 46 4c 41 | 47 53 29 20 24 5c 3c 0a |LL\_CFLA|GS) $\<.|
|00001cd0| 23 66 0a 23 57 72 61 70 | 20 6f 6e 0a 0a 44 6f 20 |#f.#Wrap| on..Do |
|00001ce0| 69 6e 63 6c 75 64 65 20 | 74 68 65 20 7b 66 45 6d |include |the {fEm|
|00001cf0| 70 68 61 73 69 73 7d 2d | 67 7b 66 7d 20 6f 70 74 |phasis}-|g{f} opt|
|00001d00| 69 6f 6e 20 69 6e 20 7b | 66 43 6f 64 65 7d 43 46 |ion in {|fCode}CF|
|00001d10| 4c 41 47 53 7b 66 7d 2c | 20 62 65 63 61 75 73 65 |LAGS{f},| because|
|00001d20| 20 74 68 61 74 20 69 73 | 20 6e 6f 74 0a 7b 66 45 | that is| not.{fE|
|00001d30| 6d 70 68 61 73 69 73 7d | 72 65 71 75 69 72 65 64 |mphasis}|required|
|00001d40| 7b 66 7d 20 66 6f 72 20 | 70 72 6f 70 65 72 20 63 |{f} for |proper c|
|00001d50| 6f 6d 70 69 6c 61 74 69 | 6f 6e 2e 20 20 59 6f 75 |ompilati|on. You|
|00001d60| 20 63 61 6e 20 63 6f 6e | 73 69 64 65 72 20 69 74 | can con|sider it|
|00001d70| 20 61 20 64 65 66 61 75 | 6c 74 0a 74 68 61 74 20 | a defau|lt.that |
|00001d80| 69 73 20 6f 6e 6c 79 20 | 72 65 63 6f 6d 6d 65 6e |is only |recommen|
|00001d90| 64 65 64 2e 20 20 49 66 | 20 74 68 65 20 70 61 63 |ded. If| the pac|
|00001da0| 6b 61 67 65 20 69 73 20 | 73 65 74 20 75 70 20 73 |kage is |set up s|
|00001db0| 6f 20 74 68 61 74 20 69 | 74 20 69 73 0a 63 6f 6d |o that i|t is.com|
|00001dc0| 70 69 6c 65 64 20 77 69 | 74 68 20 47 43 43 20 62 |piled wi|th GCC b|
|00001dd0| 79 20 64 65 66 61 75 6c | 74 2c 20 74 68 65 6e 20 |y defaul|t, then |
|00001de0| 79 6f 75 20 6d 69 67 68 | 74 20 61 73 20 77 65 6c |you migh|t as wel|
|00001df0| 6c 20 69 6e 63 6c 75 64 | 65 20 7b 66 45 6d 70 68 |l includ|e {fEmph|
|00001e00| 61 73 69 73 7d 2d 4f 7b | 66 7d 0a 69 6e 20 74 68 |asis}-O{|f}.in th|
|00001e10| 65 20 64 65 66 61 75 6c | 74 20 76 61 6c 75 65 20 |e defaul|t value |
|00001e20| 6f 66 20 7b 66 43 6f 64 | 65 7d 43 46 4c 41 47 53 |of {fCod|e}CFLAGS|
|00001e30| 7b 66 7d 20 61 73 20 77 | 65 6c 6c 2e 0a 0a 50 75 |{f} as w|ell...Pu|
|00001e40| 74 20 7b 66 43 6f 64 65 | 7d 43 46 4c 41 47 53 7b |t {fCode|}CFLAGS{|
|00001e50| 66 7d 20 6c 61 73 74 20 | 69 6e 20 74 68 65 20 63 |f} last |in the c|
|00001e60| 6f 6d 70 69 6c 61 74 69 | 6f 6e 20 63 6f 6d 6d 61 |ompilati|on comma|
|00001e70| 6e 64 2c 20 61 66 74 65 | 72 20 6f 74 68 65 72 20 |nd, afte|r other |
|00001e80| 76 61 72 69 61 62 6c 65 | 73 0a 63 6f 6e 74 61 69 |variable|s.contai|
|00001e90| 6e 69 6e 67 20 63 6f 6d | 70 69 6c 65 72 20 6f 70 |ning com|piler op|
|00001ea0| 74 69 6f 6e 73 2c 20 73 | 6f 20 74 68 65 20 75 73 |tions, s|o the us|
|00001eb0| 65 72 20 63 61 6e 20 75 | 73 65 20 7b 66 43 6f 64 |er can u|se {fCod|
|00001ec0| 65 7d 43 46 4c 41 47 53 | 7b 66 7d 20 74 6f 0a 6f |e}CFLAGS|{f} to.o|
|00001ed0| 76 65 72 72 69 64 65 20 | 74 68 65 20 6f 74 68 65 |verride |the othe|
|00001ee0| 72 73 2e 0a 0a 45 76 65 | 72 79 20 4d 61 6b 65 66 |rs...Eve|ry Makef|
|00001ef0| 69 6c 65 20 73 68 6f 75 | 6c 64 20 64 65 66 69 6e |ile shou|ld defin|
|00001f00| 65 20 74 68 65 20 76 61 | 72 69 61 62 6c 65 20 7b |e the va|riable {|
|00001f10| 66 43 6f 64 65 7d 49 4e | 53 54 41 4c 4c 7b 66 7d |fCode}IN|STALL{f}|
|00001f20| 2c 20 77 68 69 63 68 20 | 69 73 20 74 68 65 0a 62 |, which |is the.b|
|00001f30| 61 73 69 63 20 63 6f 6d | 6d 61 6e 64 20 66 6f 72 |asic com|mand for|
|00001f40| 20 69 6e 73 74 61 6c 6c | 69 6e 67 20 61 20 66 69 | install|ing a fi|
|00001f50| 6c 65 20 69 6e 74 6f 20 | 74 68 65 20 73 79 73 74 |le into |the syst|
|00001f60| 65 6d 2e 0a 0a 45 76 65 | 72 79 20 4d 61 6b 65 66 |em...Eve|ry Makef|
|00001f70| 69 6c 65 20 73 68 6f 75 | 6c 64 20 61 6c 73 6f 20 |ile shou|ld also |
|00001f80| 64 65 66 69 6e 65 20 74 | 68 65 20 76 61 72 69 61 |define t|he varia|
|00001f90| 62 6c 65 73 20 7b 66 43 | 6f 64 65 7d 49 4e 53 54 |bles {fC|ode}INST|
|00001fa0| 41 4c 4c 5c 5f 50 52 4f | 47 52 41 4d 7b 66 7d 0a |ALL\_PRO|GRAM{f}.|
|00001fb0| 61 6e 64 20 7b 66 43 6f | 64 65 7d 49 4e 53 54 41 |and {fCo|de}INSTA|
|00001fc0| 4c 4c 5c 5f 44 41 54 41 | 7b 66 7d 2e 20 20 28 54 |LL\_DATA|{f}. (T|
|00001fd0| 68 65 20 64 65 66 61 75 | 6c 74 20 66 6f 72 20 65 |he defau|lt for e|
|00001fe0| 61 63 68 20 6f 66 20 74 | 68 65 73 65 20 73 68 6f |ach of t|hese sho|
|00001ff0| 75 6c 64 20 62 65 0a 7b | 66 43 6f 64 65 7d 24 28 |uld be.{|fCode}$(|
|00002000| 49 4e 53 54 41 4c 4c 29 | 7b 66 7d 2e 29 20 20 54 |INSTALL)|{f}.) T|
|00002010| 68 65 6e 20 69 74 20 73 | 68 6f 75 6c 64 20 75 73 |hen it s|hould us|
|00002020| 65 20 74 68 6f 73 65 20 | 76 61 72 69 61 62 6c 65 |e those |variable|
|00002030| 73 20 61 73 20 74 68 65 | 20 63 6f 6d 6d 61 6e 64 |s as the| command|
|00002040| 73 0a 66 6f 72 20 61 63 | 74 75 61 6c 20 69 6e 73 |s.for ac|tual ins|
|00002050| 74 61 6c 6c 61 74 69 6f | 6e 2c 20 66 6f 72 20 65 |tallatio|n, for e|
|00002060| 78 65 63 75 74 61 62 6c | 65 73 20 61 6e 64 20 6e |xecutabl|es and n|
|00002070| 6f 6e 65 78 65 63 75 74 | 61 62 6c 65 73 0a 72 65 |onexecut|ables.re|
|00002080| 73 70 65 63 74 69 76 65 | 6c 79 2e 20 20 55 73 65 |spective|ly. Use|
|00002090| 20 74 68 65 73 65 20 76 | 61 72 69 61 62 6c 65 73 | these v|ariables|
|000020a0| 20 61 73 20 66 6f 6c 6c | 6f 77 73 3a 0a 0a 23 57 | as foll|ows:..#W|
|000020b0| 72 61 70 20 6f 66 66 0a | 23 66 43 6f 64 65 0a 24 |rap off.|#fCode.$|
|000020c0| 28 49 4e 53 54 41 4c 4c | 5c 5f 50 52 4f 47 52 41 |(INSTALL|\_PROGRA|
|000020d0| 4d 29 20 66 6f 6f 20 24 | 28 62 69 6e 64 69 72 29 |M) foo $|(bindir)|
|000020e0| 5c 2f 66 6f 6f 0a 24 28 | 49 4e 53 54 41 4c 4c 5c |\/foo.$(|INSTALL\|
|000020f0| 5f 44 41 54 41 29 20 6c | 69 62 66 6f 6f 2e 61 20 |_DATA) l|ibfoo.a |
|00002100| 24 28 6c 69 62 64 69 72 | 29 5c 2f 6c 69 62 66 6f |$(libdir|)\/libfo|
|00002110| 6f 2e 61 0a 23 66 0a 23 | 57 72 61 70 20 6f 6e 0a |o.a.#f.#|Wrap on.|
|00002120| 0a 41 6c 77 61 79 73 20 | 75 73 65 20 61 20 66 69 |.Always |use a fi|
|00002130| 6c 65 20 6e 61 6d 65 2c | 20 6e 6f 74 20 61 20 64 |le name,| not a d|
|00002140| 69 72 65 63 74 6f 72 79 | 20 6e 61 6d 65 2c 20 61 |irectory| name, a|
|00002150| 73 20 74 68 65 20 73 65 | 63 6f 6e 64 20 61 72 67 |s the se|cond arg|
|00002160| 75 6d 65 6e 74 20 6f 66 | 0a 74 68 65 20 69 6e 73 |ument of|.the ins|
|00002170| 74 61 6c 6c 61 74 69 6f | 6e 20 63 6f 6d 6d 61 6e |tallatio|n comman|
|00002180| 64 73 2e 20 20 55 73 65 | 20 61 20 73 65 70 61 72 |ds. Use| a separ|
|00002190| 61 74 65 20 63 6f 6d 6d | 61 6e 64 20 66 6f 72 20 |ate comm|and for |
|000021a0| 65 61 63 68 20 66 69 6c | 65 20 74 6f 20 62 65 0a |each fil|e to be.|
|000021b0| 69 6e 73 74 61 6c 6c 65 | 64 2e 0a 0a 44 41 54 41 |installe|d...DATA|
|000021c0| 58 0b 00 00 43 6f 6d 6d | 65 6e 74 73 0a 50 72 65 |X...Comm|ents.Pre|
|000021d0| 76 69 6f 75 73 3a 20 3c | 46 6f 72 6d 61 74 74 69 |vious: <|Formatti|
|000021e0| 6e 67 3d 3e 46 6f 72 6d | 61 74 74 69 6e 67 3e 20 |ng=>Form|atting> |
|000021f0| 2a 20 4e 65 78 74 3a 20 | 3c 53 79 6e 74 61 63 74 |* Next: |<Syntact|
|00002200| 69 63 20 43 6f 6e 76 65 | 6e 74 69 6f 6e 73 3d 3e |ic Conve|ntions=>|
|00002210| 53 79 6e 74 61 63 74 69 | 63 43 3e 20 2a 20 55 70 |Syntacti|cC> * Up|
|00002220| 3a 20 3c 54 6f 70 3d 3e | 21 52 6f 6f 74 3e 0a 0a |: <Top=>|!Root>..|
|00002230| 23 57 72 61 70 20 6f 6e | 0a 7b 66 48 32 7d 43 6f |#Wrap on|.{fH2}Co|
|00002240| 6d 6d 65 6e 74 69 6e 67 | 20 59 6f 75 72 20 57 6f |mmenting| Your Wo|
|00002250| 72 6b 7b 66 7d 0a 0a 45 | 76 65 72 79 20 70 72 6f |rk{f}..E|very pro|
|00002260| 67 72 61 6d 20 73 68 6f | 75 6c 64 20 73 74 61 72 |gram sho|uld star|
|00002270| 74 20 77 69 74 68 20 61 | 20 63 6f 6d 6d 65 6e 74 |t with a| comment|
|00002280| 20 73 61 79 69 6e 67 20 | 62 72 69 65 66 6c 79 20 | saying |briefly |
|00002290| 77 68 61 74 20 69 74 20 | 69 73 20 66 6f 72 2e 0a |what it |is for..|
|000022a0| 45 78 61 6d 70 6c 65 3a | 20 7b 66 45 6d 70 68 61 |Example:| {fEmpha|
|000022b0| 73 69 73 7d 66 6d 74 20 | 2d 20 66 69 6c 74 65 72 |sis}fmt |- filter|
|000022c0| 20 66 6f 72 20 73 69 6d | 70 6c 65 20 66 69 6c 6c | for sim|ple fill|
|000022d0| 69 6e 67 20 6f 66 20 74 | 65 78 74 7b 66 7d 2e 0a |ing of t|ext{f}..|
|000022e0| 0a 50 6c 65 61 73 65 20 | 70 75 74 20 61 20 63 6f |.Please |put a co|
|000022f0| 6d 6d 65 6e 74 20 6f 6e | 20 65 61 63 68 20 66 75 |mment on| each fu|
|00002300| 6e 63 74 69 6f 6e 20 73 | 61 79 69 6e 67 20 77 68 |nction s|aying wh|
|00002310| 61 74 20 74 68 65 20 66 | 75 6e 63 74 69 6f 6e 20 |at the f|unction |
|00002320| 64 6f 65 73 2c 0a 77 68 | 61 74 20 73 6f 72 74 73 |does,.wh|at sorts|
|00002330| 20 6f 66 20 61 72 67 75 | 6d 65 6e 74 73 20 69 74 | of argu|ments it|
|00002340| 20 67 65 74 73 2c 20 61 | 6e 64 20 77 68 61 74 20 | gets, a|nd what |
|00002350| 74 68 65 20 70 6f 73 73 | 69 62 6c 65 20 76 61 6c |the poss|ible val|
|00002360| 75 65 73 20 6f 66 0a 61 | 72 67 75 6d 65 6e 74 73 |ues of.a|rguments|
|00002370| 20 6d 65 61 6e 20 61 6e | 64 20 61 72 65 20 75 73 | mean an|d are us|
|00002380| 65 64 20 66 6f 72 2e 20 | 20 49 74 20 69 73 20 6e |ed for. | It is n|
|00002390| 6f 74 20 6e 65 63 65 73 | 73 61 72 79 20 74 6f 20 |ot neces|sary to |
|000023a0| 64 75 70 6c 69 63 61 74 | 65 20 69 6e 0a 77 6f 72 |duplicat|e in.wor|
|000023b0| 64 73 20 74 68 65 20 6d | 65 61 6e 69 6e 67 20 6f |ds the m|eaning o|
|000023c0| 66 20 74 68 65 20 43 20 | 61 72 67 75 6d 65 6e 74 |f the C |argument|
|000023d0| 20 64 65 63 6c 61 72 61 | 74 69 6f 6e 73 2c 20 69 | declara|tions, i|
|000023e0| 66 20 61 20 43 20 74 79 | 70 65 20 69 73 20 62 65 |f a C ty|pe is be|
|000023f0| 69 6e 67 0a 75 73 65 64 | 20 69 6e 20 69 74 73 20 |ing.used| in its |
|00002400| 63 75 73 74 6f 6d 61 72 | 79 20 66 61 73 68 69 6f |customar|y fashio|
|00002410| 6e 2e 20 20 49 66 20 74 | 68 65 72 65 20 69 73 20 |n. If t|here is |
|00002420| 61 6e 79 74 68 69 6e 67 | 20 6e 6f 6e 73 74 61 6e |anything| nonstan|
|00002430| 64 61 72 64 20 61 62 6f | 75 74 0a 69 74 73 20 75 |dard abo|ut.its u|
|00002440| 73 65 20 28 73 75 63 68 | 20 61 73 20 61 6e 20 61 |se (such| as an a|
|00002450| 72 67 75 6d 65 6e 74 20 | 6f 66 20 74 79 70 65 20 |rgument |of type |
|00002460| 7b 66 43 6f 64 65 7d 63 | 68 61 72 20 5c 2a 7b 66 |{fCode}c|har \*{f|
|00002470| 7d 20 77 68 69 63 68 20 | 69 73 20 72 65 61 6c 6c |} which |is reall|
|00002480| 79 20 74 68 65 0a 61 64 | 64 72 65 73 73 20 6f 66 |y the.ad|dress of|
|00002490| 20 74 68 65 20 73 65 63 | 6f 6e 64 20 63 68 61 72 | the sec|ond char|
|000024a0| 61 63 74 65 72 20 6f 66 | 20 61 20 73 74 72 69 6e |acter of| a strin|
|000024b0| 67 2c 20 6e 6f 74 20 74 | 68 65 20 66 69 72 73 74 |g, not t|he first|
|000024c0| 29 2c 20 6f 72 20 61 6e | 79 0a 70 6f 73 73 69 62 |), or an|y.possib|
|000024d0| 6c 65 20 76 61 6c 75 65 | 73 20 74 68 61 74 20 77 |le value|s that w|
|000024e0| 6f 75 6c 64 20 6e 6f 74 | 20 77 6f 72 6b 20 74 68 |ould not| work th|
|000024f0| 65 20 77 61 79 20 6f 6e | 65 20 77 6f 75 6c 64 20 |e way on|e would |
|00002500| 65 78 70 65 63 74 20 28 | 73 75 63 68 20 61 73 2c |expect (|such as,|
|00002510| 0a 74 68 61 74 20 73 74 | 72 69 6e 67 73 20 63 6f |.that st|rings co|
|00002520| 6e 74 61 69 6e 69 6e 67 | 20 6e 65 77 6c 69 6e 65 |ntaining| newline|
|00002530| 73 20 61 72 65 20 6e 6f | 74 20 67 75 61 72 61 6e |s are no|t guaran|
|00002540| 74 65 65 64 20 74 6f 20 | 77 6f 72 6b 29 2c 20 62 |teed to |work), b|
|00002550| 65 20 73 75 72 65 0a 74 | 6f 20 73 61 79 20 73 6f |e sure.t|o say so|
|00002560| 2e 0a 0a 41 6c 73 6f 20 | 65 78 70 6c 61 69 6e 20 |...Also |explain |
|00002570| 74 68 65 20 73 69 67 6e | 69 66 69 63 61 6e 63 65 |the sign|ificance|
|00002580| 20 6f 66 20 74 68 65 20 | 72 65 74 75 72 6e 20 76 | of the |return v|
|00002590| 61 6c 75 65 2c 20 69 66 | 20 74 68 65 72 65 20 69 |alue, if| there i|
|000025a0| 73 20 6f 6e 65 2e 0a 0a | 50 6c 65 61 73 65 20 70 |s one...|Please p|
|000025b0| 75 74 20 74 77 6f 20 73 | 70 61 63 65 73 20 61 66 |ut two s|paces af|
|000025c0| 74 65 72 20 74 68 65 20 | 65 6e 64 20 6f 66 20 61 |ter the |end of a|
|000025d0| 20 73 65 6e 74 65 6e 63 | 65 20 69 6e 20 79 6f 75 | sentenc|e in you|
|000025e0| 72 20 63 6f 6d 6d 65 6e | 74 73 2c 20 73 6f 0a 74 |r commen|ts, so.t|
|000025f0| 68 61 74 20 74 68 65 20 | 45 6d 61 63 73 20 73 65 |hat the |Emacs se|
|00002600| 6e 74 65 6e 63 65 20 63 | 6f 6d 6d 61 6e 64 73 20 |ntence c|ommands |
|00002610| 77 69 6c 6c 20 77 6f 72 | 6b 2e 20 20 41 6c 73 6f |will wor|k. Also|
|00002620| 2c 20 70 6c 65 61 73 65 | 20 77 72 69 74 65 0a 63 |, please| write.c|
|00002630| 6f 6d 70 6c 65 74 65 20 | 73 65 6e 74 65 6e 63 65 |omplete |sentence|
|00002640| 73 20 61 6e 64 20 63 61 | 70 69 74 61 6c 69 7a 65 |s and ca|pitalize|
|00002650| 20 74 68 65 20 66 69 72 | 73 74 20 77 6f 72 64 2e | the fir|st word.|
|00002660| 20 20 49 66 20 61 20 6c | 6f 77 65 72 2d 63 61 73 | If a l|ower-cas|
|00002670| 65 0a 69 64 65 6e 74 69 | 66 65 72 20 63 6f 6d 65 |e.identi|fer come|
|00002680| 73 20 61 74 20 74 68 65 | 20 62 65 67 69 6e 6e 69 |s at the| beginni|
|00002690| 6e 67 20 6f 66 20 61 20 | 73 65 6e 74 65 6e 63 65 |ng of a |sentence|
|000026a0| 2c 20 64 6f 6e 27 74 20 | 63 61 70 69 74 61 6c 69 |, don't |capitali|
|000026b0| 7a 65 20 69 74 21 0a 43 | 68 61 6e 67 69 6e 67 20 |ze it!.C|hanging |
|000026c0| 74 68 65 20 73 70 65 6c | 6c 69 6e 67 20 6d 61 6b |the spel|ling mak|
|000026d0| 65 73 20 69 74 20 61 20 | 64 69 66 66 65 72 65 6e |es it a |differen|
|000026e0| 74 20 69 64 65 6e 74 69 | 66 69 65 72 2e 20 20 49 |t identi|fier. I|
|000026f0| 66 20 79 6f 75 20 64 6f | 6e 27 74 0a 6c 69 6b 65 |f you do|n't.like|
|00002700| 20 73 74 61 72 74 69 6e | 67 20 61 20 73 65 6e 74 | startin|g a sent|
|00002710| 65 6e 63 65 20 77 69 74 | 68 20 61 20 6c 6f 77 65 |ence wit|h a lowe|
|00002720| 72 20 63 61 73 65 20 6c | 65 74 74 65 72 2c 20 77 |r case l|etter, w|
|00002730| 72 69 74 65 20 74 68 65 | 20 73 65 6e 74 65 6e 63 |rite the| sentenc|
|00002740| 65 0a 64 69 66 66 65 72 | 65 6e 74 6c 79 20 28 65 |e.differ|ently (e|
|00002750| 2e 67 2e 2c 20 60 60 54 | 68 65 20 69 64 65 6e 74 |.g., ``T|he ident|
|00002760| 69 66 69 65 72 20 6c 6f | 77 65 72 2d 63 61 73 65 |ifier lo|wer-case|
|00002770| 20 69 73 20 8c 27 27 29 | 2e 0a 0a 54 68 65 20 63 | is .'')|...The c|
|00002780| 6f 6d 6d 65 6e 74 20 6f | 6e 20 61 20 66 75 6e 63 |omment o|n a func|
|00002790| 74 69 6f 6e 20 69 73 20 | 6d 75 63 68 20 63 6c 65 |tion is |much cle|
|000027a0| 61 72 65 72 20 69 66 20 | 79 6f 75 20 75 73 65 20 |arer if |you use |
|000027b0| 74 68 65 20 61 72 67 75 | 6d 65 6e 74 0a 6e 61 6d |the argu|ment.nam|
|000027c0| 65 73 20 74 6f 20 73 70 | 65 61 6b 20 61 62 6f 75 |es to sp|eak abou|
|000027d0| 74 20 74 68 65 20 61 72 | 67 75 6d 65 6e 74 20 76 |t the ar|gument v|
|000027e0| 61 6c 75 65 73 2e 20 20 | 54 68 65 20 76 61 72 69 |alues. |The vari|
|000027f0| 61 62 6c 65 20 6e 61 6d | 65 20 69 74 73 65 6c 66 |able nam|e itself|
|00002800| 0a 73 68 6f 75 6c 64 20 | 62 65 20 6c 6f 77 65 72 |.should |be lower|
|00002810| 20 63 61 73 65 2c 20 62 | 75 74 20 77 72 69 74 65 | case, b|ut write|
|00002820| 20 69 74 20 69 6e 20 75 | 70 70 65 72 20 63 61 73 | it in u|pper cas|
|00002830| 65 20 77 68 65 6e 20 79 | 6f 75 20 61 72 65 20 73 |e when y|ou are s|
|00002840| 70 65 61 6b 69 6e 67 0a | 61 62 6f 75 74 20 74 68 |peaking.|about th|
|00002850| 65 20 76 61 6c 75 65 20 | 72 61 74 68 65 72 20 74 |e value |rather t|
|00002860| 68 61 6e 20 74 68 65 20 | 76 61 72 69 61 62 6c 65 |han the |variable|
|00002870| 20 69 74 73 65 6c 66 2e | 20 20 54 68 75 73 2c 20 | itself.| Thus, |
|00002880| 60 60 74 68 65 20 69 6e | 6f 64 65 0a 6e 75 6d 62 |``the in|ode.numb|
|00002890| 65 72 20 4e 4f 44 45 5c | 5f 4e 55 4d 27 27 20 72 |er NODE\|_NUM'' r|
|000028a0| 61 74 68 65 72 20 74 68 | 61 6e 20 60 60 61 6e 20 |ather th|an ``an |
|000028b0| 69 6e 6f 64 65 27 27 2e | 0a 0a 54 68 65 72 65 20 |inode''.|..There |
|000028c0| 69 73 20 75 73 75 61 6c | 6c 79 20 6e 6f 20 70 75 |is usual|ly no pu|
|000028d0| 72 70 6f 73 65 20 69 6e | 20 72 65 73 74 61 74 69 |rpose in| restati|
|000028e0| 6e 67 20 74 68 65 20 6e | 61 6d 65 20 6f 66 20 74 |ng the n|ame of t|
|000028f0| 68 65 20 66 75 6e 63 74 | 69 6f 6e 20 69 6e 0a 74 |he funct|ion in.t|
|00002900| 68 65 20 63 6f 6d 6d 65 | 6e 74 20 62 65 66 6f 72 |he comme|nt befor|
|00002910| 65 20 69 74 2c 20 62 65 | 63 61 75 73 65 20 74 68 |e it, be|cause th|
|00002920| 65 20 72 65 61 64 65 72 | 20 63 61 6e 20 73 65 65 |e reader| can see|
|00002930| 20 74 68 61 74 20 66 6f | 72 20 68 69 6d 73 65 6c | that fo|r himsel|
|00002940| 66 2e 0a 54 68 65 72 65 | 20 6d 69 67 68 74 20 62 |f..There| might b|
|00002950| 65 20 61 6e 20 65 78 63 | 65 70 74 69 6f 6e 20 77 |e an exc|eption w|
|00002960| 68 65 6e 20 74 68 65 20 | 63 6f 6d 6d 65 6e 74 20 |hen the |comment |
|00002970| 69 73 20 73 6f 20 6c 6f | 6e 67 20 74 68 61 74 20 |is so lo|ng that |
|00002980| 74 68 65 20 66 75 6e 63 | 74 69 6f 6e 0a 69 74 73 |the func|tion.its|
|00002990| 65 6c 66 20 77 6f 75 6c | 64 20 62 65 20 6f 66 66 |elf woul|d be off|
|000029a0| 20 74 68 65 20 62 6f 74 | 74 6f 6d 20 6f 66 20 74 | the bot|tom of t|
|000029b0| 68 65 20 73 63 72 65 65 | 6e 2e 0a 0a 54 68 65 72 |he scree|n...Ther|
|000029c0| 65 20 73 68 6f 75 6c 64 | 20 62 65 20 61 20 63 6f |e should| be a co|
|000029d0| 6d 6d 65 6e 74 20 6f 6e | 20 65 61 63 68 20 73 74 |mment on| each st|
|000029e0| 61 74 69 63 20 76 61 72 | 69 61 62 6c 65 20 61 73 |atic var|iable as|
|000029f0| 20 77 65 6c 6c 2c 20 6c | 69 6b 65 20 74 68 69 73 | well, l|ike this|
|00002a00| 3a 0a 0a 23 57 72 61 70 | 20 6f 66 66 0a 23 66 43 |:..#Wrap| off.#fC|
|00002a10| 6f 64 65 0a 5c 2f 5c 2a | 20 4e 6f 6e 7a 65 72 6f |ode.\/\*| Nonzero|
|00002a20| 20 6d 65 61 6e 73 20 74 | 72 75 6e 63 61 74 65 20 | means t|runcate |
|00002a30| 6c 69 6e 65 73 20 69 6e | 20 74 68 65 20 64 69 73 |lines in| the dis|
|00002a40| 70 6c 61 79 3b 0a 20 20 | 20 7a 65 72 6f 20 6d 65 |play;. | zero me|
|00002a50| 61 6e 73 20 63 6f 6e 74 | 69 6e 75 65 20 74 68 65 |ans cont|inue the|
|00002a60| 6d 2e 20 20 5c 2a 5c 2f | 0a 69 6e 74 20 74 72 75 |m. \*\/|.int tru|
|00002a70| 6e 63 61 74 65 5c 5f 6c | 69 6e 65 73 3b 0a 23 66 |ncate\_l|ines;.#f|
|00002a80| 0a 23 57 72 61 70 20 6f | 6e 0a 0a 45 76 65 72 79 |.#Wrap o|n..Every|
|00002a90| 20 7b 66 45 6d 70 68 61 | 73 69 73 7d 5c 23 65 6e | {fEmpha|sis}\#en|
|00002aa0| 64 69 66 7b 66 7d 20 73 | 68 6f 75 6c 64 20 68 61 |dif{f} s|hould ha|
|00002ab0| 76 65 20 61 20 63 6f 6d | 6d 65 6e 74 2c 20 65 78 |ve a com|ment, ex|
|00002ac0| 63 65 70 74 20 69 6e 20 | 74 68 65 20 63 61 73 65 |cept in |the case|
|00002ad0| 20 6f 66 20 73 68 6f 72 | 74 0a 63 6f 6e 64 69 74 | of shor|t.condit|
|00002ae0| 69 6f 6e 61 6c 73 20 28 | 6a 75 73 74 20 61 20 66 |ionals (|just a f|
|00002af0| 65 77 20 6c 69 6e 65 73 | 29 20 74 68 61 74 20 61 |ew lines|) that a|
|00002b00| 72 65 20 6e 6f 74 20 6e | 65 73 74 65 64 2e 20 20 |re not n|ested. |
|00002b10| 54 68 65 20 63 6f 6d 6d | 65 6e 74 20 73 68 6f 75 |The comm|ent shou|
|00002b20| 6c 64 0a 73 74 61 74 65 | 20 74 68 65 20 63 6f 6e |ld.state| the con|
|00002b30| 64 69 74 69 6f 6e 20 6f | 66 20 74 68 65 20 63 6f |dition o|f the co|
|00002b40| 6e 64 69 74 69 6f 6e 61 | 6c 20 74 68 61 74 20 69 |nditiona|l that i|
|00002b50| 73 20 65 6e 64 69 6e 67 | 2c 20 7b 66 45 6d 70 68 |s ending|, {fEmph|
|00002b60| 61 73 69 73 7d 69 6e 63 | 6c 75 64 69 6e 67 0a 69 |asis}inc|luding.i|
|00002b70| 74 73 20 73 65 6e 73 65 | 7b 66 7d 2e 20 20 7b 66 |ts sense|{f}. {f|
|00002b80| 45 6d 70 68 61 73 69 73 | 7d 5c 23 65 6c 73 65 7b |Emphasis|}\#else{|
|00002b90| 66 7d 20 73 68 6f 75 6c | 64 20 68 61 76 65 20 61 |f} shoul|d have a|
|00002ba0| 20 63 6f 6d 6d 65 6e 74 | 20 64 65 73 63 72 69 62 | comment| describ|
|00002bb0| 69 6e 67 20 74 68 65 20 | 63 6f 6e 64 69 74 69 6f |ing the |conditio|
|00002bc0| 6e 0a 7b 66 45 6d 70 68 | 61 73 69 73 7d 61 6e 64 |n.{fEmph|asis}and|
|00002bd0| 20 73 65 6e 73 65 7b 66 | 7d 20 6f 66 20 74 68 65 | sense{f|} of the|
|00002be0| 20 63 6f 64 65 20 74 68 | 61 74 20 66 6f 6c 6c 6f | code th|at follo|
|00002bf0| 77 73 2e 20 20 46 6f 72 | 20 65 78 61 6d 70 6c 65 |ws. For| example|
|00002c00| 3a 0a 0a 23 57 72 61 70 | 20 6f 66 66 0a 23 66 43 |:..#Wrap| off.#fC|
|00002c10| 6f 64 65 0a 5c 23 69 66 | 64 65 66 20 66 6f 6f 0a |ode.\#if|def foo.|
|00002c20| 20 20 8c 0a 5c 23 65 6c | 73 65 20 5c 2f 5c 2a 20 | ..\#el|se \/\* |
|00002c30| 6e 6f 74 20 66 6f 6f 20 | 5c 2a 5c 2f 0a 20 20 8c |not foo |\*\/. .|
|00002c40| 0a 5c 23 65 6e 64 69 66 | 20 5c 2f 5c 2a 20 6e 6f |.\#endif| \/\* no|
|00002c50| 74 20 66 6f 6f 20 5c 2a | 5c 2f 0a 23 66 0a 23 57 |t foo \*|\/.#f.#W|
|00002c60| 72 61 70 20 6f 6e 0a 0a | 62 75 74 2c 20 62 79 20 |rap on..|but, by |
|00002c70| 63 6f 6e 74 72 61 73 74 | 2c 20 77 72 69 74 65 20 |contrast|, write |
|00002c80| 74 68 65 20 63 6f 6d 6d | 65 6e 74 73 20 74 68 69 |the comm|ents thi|
|00002c90| 73 20 77 61 79 20 66 6f | 72 20 61 20 7b 66 45 6d |s way fo|r a {fEm|
|00002ca0| 70 68 61 73 69 73 7d 5c | 23 69 66 6e 64 65 66 7b |phasis}\|#ifndef{|
|00002cb0| 66 7d 3a 0a 0a 23 57 72 | 61 70 20 6f 66 66 0a 23 |f}:..#Wr|ap off.#|
|00002cc0| 66 43 6f 64 65 0a 5c 23 | 69 66 6e 64 65 66 20 66 |fCode.\#|ifndef f|
|00002cd0| 6f 6f 0a 20 20 8c 0a 5c | 23 65 6c 73 65 20 5c 2f |oo. ..\|#else \/|
|00002ce0| 5c 2a 20 66 6f 6f 20 5c | 2a 5c 2f 0a 20 20 8c 0a |\* foo \|*\/. ..|
|00002cf0| 5c 23 65 6e 64 69 66 20 | 5c 2f 5c 2a 20 66 6f 6f |\#endif |\/\* foo|
|00002d00| 20 5c 2a 5c 2f 0a 23 66 | 0a 23 57 72 61 70 20 6f | \*\/.#f|.#Wrap o|
|00002d10| 6e 0a 0a 0a 44 41 54 41 | 6f 06 00 00 43 6f 6d 70 |n...DATA|o...Comp|
|00002d20| 61 74 69 62 69 6c 69 74 | 79 0a 50 72 65 76 69 6f |atibilit|y.Previo|
|00002d30| 75 73 3a 20 3c 43 68 61 | 6e 67 65 20 4c 6f 67 73 |us: <Cha|nge Logs|
|00002d40| 3d 3e 43 68 61 6e 67 65 | 4c 6f 67 73 3e 20 2a 20 |=>Change|Logs> * |
|00002d50| 4e 65 78 74 3a 20 3c 4d | 61 6b 65 66 69 6c 65 20 |Next: <M|akefile |
|00002d60| 43 6f 6e 76 65 6e 74 69 | 6f 6e 73 3d 3e 4d 61 6b |Conventi|ons=>Mak|
|00002d70| 65 66 69 6c 65 43 6f 3e | 20 2a 20 55 70 3a 20 3c |efileCo>| * Up: <|
|00002d80| 54 6f 70 3d 3e 21 52 6f | 6f 74 3e 0a 0a 23 57 72 |Top=>!Ro|ot>..#Wr|
|00002d90| 61 70 20 6f 6e 0a 7b 66 | 48 32 7d 43 6f 6d 70 61 |ap on.{f|H2}Compa|
|00002da0| 74 69 62 69 6c 69 74 79 | 20 77 69 74 68 20 4f 74 |tibility| with Ot|
|00002db0| 68 65 72 20 49 6d 70 6c | 65 6d 65 6e 74 61 74 69 |her Impl|ementati|
|00002dc0| 6f 6e 73 7b 66 7d 0a 0a | 57 69 74 68 20 63 65 72 |ons{f}..|With cer|
|00002dd0| 74 61 69 6e 20 65 78 63 | 65 70 74 69 6f 6e 73 2c |tain exc|eptions,|
|00002de0| 20 75 74 69 6c 69 74 79 | 20 70 72 6f 67 72 61 6d | utility| program|
|00002df0| 73 20 61 6e 64 20 6c 69 | 62 72 61 72 69 65 73 20 |s and li|braries |
|00002e00| 66 6f 72 20 47 4e 55 20 | 73 68 6f 75 6c 64 0a 62 |for GNU |should.b|
|00002e10| 65 20 75 70 77 61 72 64 | 20 63 6f 6d 70 61 74 69 |e upward| compati|
|00002e20| 62 6c 65 20 77 69 74 68 | 20 74 68 6f 73 65 20 69 |ble with| those i|
|00002e30| 6e 20 42 65 72 6b 65 6c | 65 79 20 55 6e 69 78 2c |n Berkel|ey Unix,|
|00002e40| 20 61 6e 64 20 75 70 77 | 61 72 64 20 63 6f 6d 70 | and upw|ard comp|
|00002e50| 61 74 69 62 6c 65 0a 77 | 69 74 68 20 41 4e 53 49 |atible.w|ith ANSI|
|00002e60| 20 43 20 69 66 20 41 4e | 53 49 20 43 20 73 70 65 | C if AN|SI C spe|
|00002e70| 63 69 66 69 65 73 20 74 | 68 65 69 72 20 62 65 68 |cifies t|heir beh|
|00002e80| 61 76 69 6f 72 2c 20 61 | 6e 64 20 75 70 77 61 72 |avior, a|nd upwar|
|00002e90| 64 0a 63 6f 6d 70 61 74 | 69 62 6c 65 20 77 69 74 |d.compat|ible wit|
|00002ea0| 68 20 50 4f 53 49 58 20 | 69 66 20 50 4f 53 49 58 |h POSIX |if POSIX|
|00002eb0| 20 73 70 65 63 69 66 69 | 65 73 20 74 68 65 69 72 | specifi|es their|
|00002ec0| 20 62 65 68 61 76 69 6f | 72 2e 0a 0a 57 68 65 6e | behavio|r...When|
|00002ed0| 20 74 68 65 73 65 20 73 | 74 61 6e 64 61 72 64 73 | these s|tandards|
|00002ee0| 20 63 6f 6e 66 6c 69 63 | 74 2c 20 69 74 20 69 73 | conflic|t, it is|
|00002ef0| 20 75 73 65 66 75 6c 20 | 74 6f 20 6f 66 66 65 72 | useful |to offer|
|00002f00| 20 63 6f 6d 70 61 74 69 | 62 69 6c 69 74 79 0a 6d | compati|bility.m|
|00002f10| 6f 64 65 73 20 66 6f 72 | 20 65 61 63 68 20 6f 66 |odes for| each of|
|00002f20| 20 74 68 65 6d 2e 0a 0a | 41 4e 53 49 20 43 20 61 | them...|ANSI C a|
|00002f30| 6e 64 20 50 4f 53 49 58 | 20 70 72 6f 68 69 62 69 |nd POSIX| prohibi|
|00002f40| 74 20 6d 61 6e 79 20 6b | 69 6e 64 73 20 6f 66 20 |t many k|inds of |
|00002f50| 65 78 74 65 6e 73 69 6f | 6e 73 2e 20 20 46 65 65 |extensio|ns. Fee|
|00002f60| 6c 0a 66 72 65 65 20 74 | 6f 20 6d 61 6b 65 20 74 |l.free t|o make t|
|00002f70| 68 65 20 65 78 74 65 6e | 73 69 6f 6e 73 20 61 6e |he exten|sions an|
|00002f80| 79 77 61 79 2c 20 61 6e | 64 20 69 6e 63 6c 75 64 |yway, an|d includ|
|00002f90| 65 20 61 20 7b 66 45 6d | 70 68 61 73 69 73 7d 2d |e a {fEm|phasis}-|
|00002fa0| 2d 61 6e 73 69 7b 66 7d | 20 6f 72 0a 7b 66 45 6d |-ansi{f}| or.{fEm|
|00002fb0| 70 68 61 73 69 73 7d 2d | 2d 63 6f 6d 70 61 74 69 |phasis}-|-compati|
|00002fc0| 62 6c 65 7b 66 7d 20 6f | 70 74 69 6f 6e 20 74 6f |ble{f} o|ption to|
|00002fd0| 20 74 75 72 6e 20 74 68 | 65 6d 20 6f 66 66 2e 20 | turn th|em off. |
|00002fe0| 20 48 6f 77 65 76 65 72 | 2c 20 69 66 20 74 68 65 | However|, if the|
|00002ff0| 20 65 78 74 65 6e 73 69 | 6f 6e 0a 68 61 73 20 61 | extensi|on.has a|
|00003000| 20 73 69 67 6e 69 66 69 | 63 61 6e 74 20 63 68 61 | signifi|cant cha|
|00003010| 6e 63 65 20 6f 66 20 62 | 72 65 61 6b 69 6e 67 20 |nce of b|reaking |
|00003020| 61 6e 79 20 72 65 61 6c | 20 70 72 6f 67 72 61 6d |any real| program|
|00003030| 73 20 6f 72 20 73 63 72 | 69 70 74 73 2c 0a 74 68 |s or scr|ipts,.th|
|00003040| 65 6e 20 69 74 20 69 73 | 20 6e 6f 74 20 72 65 61 |en it is| not rea|
|00003050| 6c 6c 79 20 75 70 77 61 | 72 64 20 63 6f 6d 70 61 |lly upwa|rd compa|
|00003060| 74 69 62 6c 65 2e 20 20 | 54 72 79 20 74 6f 20 72 |tible. |Try to r|
|00003070| 65 64 65 73 69 67 6e 20 | 69 74 73 0a 69 6e 74 65 |edesign |its.inte|
|00003080| 72 66 61 63 65 2e 0a 0a | 4d 61 6e 79 20 47 4e 55 |rface...|Many GNU|
|00003090| 20 70 72 6f 67 72 61 6d | 73 20 73 75 70 70 72 65 | program|s suppre|
|000030a0| 73 73 20 65 78 74 65 6e | 73 69 6f 6e 73 20 74 68 |ss exten|sions th|
|000030b0| 61 74 20 63 6f 6e 66 6c | 69 63 74 20 77 69 74 68 |at confl|ict with|
|000030c0| 20 50 4f 53 49 58 20 69 | 66 20 74 68 65 0a 65 6e | POSIX i|f the.en|
|000030d0| 76 69 72 6f 6e 6d 65 6e | 74 20 76 61 72 69 61 62 |vironmen|t variab|
|000030e0| 6c 65 20 7b 66 43 6f 64 | 65 7d 50 4f 53 49 58 4c |le {fCod|e}POSIXL|
|000030f0| 59 5c 5f 43 4f 52 52 45 | 43 54 7b 66 7d 20 69 73 |Y\_CORRE|CT{f} is|
|00003100| 20 64 65 66 69 6e 65 64 | 20 28 65 76 65 6e 20 69 | defined| (even i|
|00003110| 66 20 69 74 20 69 73 0a | 64 65 66 69 6e 65 64 20 |f it is.|defined |
|00003120| 77 69 74 68 20 61 20 6e | 75 6c 6c 20 76 61 6c 75 |with a n|ull valu|
|00003130| 65 29 2e 20 20 50 6c 65 | 61 73 65 20 6d 61 6b 65 |e). Ple|ase make|
|00003140| 20 79 6f 75 72 20 70 72 | 6f 67 72 61 6d 20 72 65 | your pr|ogram re|
|00003150| 63 6f 67 6e 69 7a 65 20 | 74 68 69 73 0a 76 61 72 |cognize |this.var|
|00003160| 69 61 62 6c 65 20 69 66 | 20 61 70 70 72 6f 70 72 |iable if| appropr|
|00003170| 69 61 74 65 2e 0a 0a 57 | 68 65 6e 20 61 20 66 65 |iate...W|hen a fe|
|00003180| 61 74 75 72 65 20 69 73 | 20 75 73 65 64 20 6f 6e |ature is| used on|
|00003190| 6c 79 20 62 79 20 75 73 | 65 72 73 20 28 6e 6f 74 |ly by us|ers (not|
|000031a0| 20 62 79 20 70 72 6f 67 | 72 61 6d 73 20 6f 72 20 | by prog|rams or |
|000031b0| 63 6f 6d 6d 61 6e 64 0a | 66 69 6c 65 73 29 2c 20 |command.|files), |
|000031c0| 61 6e 64 20 69 74 20 69 | 73 20 64 6f 6e 65 20 70 |and it i|s done p|
|000031d0| 6f 6f 72 6c 79 20 69 6e | 20 55 6e 69 78 2c 20 66 |oorly in| Unix, f|
|000031e0| 65 65 6c 20 66 72 65 65 | 20 74 6f 20 72 65 70 6c |eel free| to repl|
|000031f0| 61 63 65 20 69 74 0a 63 | 6f 6d 70 6c 65 74 65 6c |ace it.c|ompletel|
|00003200| 79 20 77 69 74 68 20 73 | 6f 6d 65 74 68 69 6e 67 |y with s|omething|
|00003210| 20 74 6f 74 61 6c 6c 79 | 20 64 69 66 66 65 72 65 | totally| differe|
|00003220| 6e 74 20 61 6e 64 20 62 | 65 74 74 65 72 2e 20 20 |nt and b|etter. |
|00003230| 28 46 6f 72 20 65 78 61 | 6d 70 6c 65 2c 0a 76 69 |(For exa|mple,.vi|
|00003240| 20 69 73 20 72 65 70 6c | 61 63 65 64 20 77 69 74 | is repl|aced wit|
|00003250| 68 20 45 6d 61 63 73 2e | 29 20 20 42 75 74 20 69 |h Emacs.|) But i|
|00003260| 74 20 69 73 20 6e 69 63 | 65 20 74 6f 20 6f 66 66 |t is nic|e to off|
|00003270| 65 72 20 61 20 63 6f 6d | 70 61 74 69 62 6c 65 0a |er a com|patible.|
|00003280| 66 65 61 74 75 72 65 20 | 61 73 20 77 65 6c 6c 2e |feature |as well.|
|00003290| 20 20 28 54 68 65 72 65 | 20 69 73 20 61 20 66 72 | (There| is a fr|
|000032a0| 65 65 20 76 69 20 63 6c | 6f 6e 65 2c 20 73 6f 20 |ee vi cl|one, so |
|000032b0| 77 65 20 6f 66 66 65 72 | 20 69 74 2e 29 0a 0a 41 |we offer| it.)..A|
|000032c0| 64 64 69 74 69 6f 6e 61 | 6c 20 75 73 65 66 75 6c |dditiona|l useful|
|000032d0| 20 66 65 61 74 75 72 65 | 73 20 6e 6f 74 20 69 6e | feature|s not in|
|000032e0| 20 42 65 72 6b 65 6c 65 | 79 20 55 6e 69 78 20 61 | Berkele|y Unix a|
|000032f0| 72 65 20 77 65 6c 63 6f | 6d 65 2e 0a 41 64 64 69 |re welco|me..Addi|
|00003300| 74 69 6f 6e 61 6c 20 70 | 72 6f 67 72 61 6d 73 20 |tional p|rograms |
|00003310| 77 69 74 68 20 6e 6f 20 | 63 6f 75 6e 74 65 72 70 |with no |counterp|
|00003320| 61 72 74 20 69 6e 20 55 | 6e 69 78 20 6d 61 79 20 |art in U|nix may |
|00003330| 62 65 20 75 73 65 66 75 | 6c 2c 0a 62 75 74 20 6f |be usefu|l,.but o|
|00003340| 75 72 20 66 69 72 73 74 | 20 70 72 69 6f 72 69 74 |ur first| priorit|
|00003350| 79 20 69 73 20 75 73 75 | 61 6c 6c 79 20 74 6f 20 |y is usu|ally to |
|00003360| 64 75 70 6c 69 63 61 74 | 65 20 77 68 61 74 20 55 |duplicat|e what U|
|00003370| 6e 69 78 20 61 6c 72 65 | 61 64 79 0a 68 61 73 2e |nix alre|ady.has.|
|00003380| 0a 0a 0a 00 44 41 54 41 | e3 1e 00 00 43 6f 6e 66 |....DATA|....Conf|
|00003390| 69 67 75 72 61 74 69 6f | 6e 0a 50 72 65 76 69 6f |iguratio|n.Previo|
|000033a0| 75 73 3a 20 3c 44 69 72 | 65 63 74 6f 72 79 20 56 |us: <Dir|ectory V|
|000033b0| 61 72 69 61 62 6c 65 73 | 3d 3e 44 69 72 65 63 74 |ariables|=>Direct|
|000033c0| 6f 72 79 56 3e 20 2a 20 | 4e 65 78 74 3a 20 3c 53 |oryV> * |Next: <S|
|000033d0| 6f 75 72 63 65 20 4c 61 | 6e 67 75 61 67 65 3d 3e |ource La|nguage=>|
|000033e0| 53 6f 75 72 63 65 4c 61 | 6e 67 3e 20 2a 20 55 70 |SourceLa|ng> * Up|
|000033f0| 3a 20 3c 54 6f 70 3d 3e | 21 52 6f 6f 74 3e 0a 0a |: <Top=>|!Root>..|
|00003400| 23 57 72 61 70 20 6f 6e | 0a 7b 66 48 32 7d 48 6f |#Wrap on|.{fH2}Ho|
|00003410| 77 20 43 6f 6e 66 69 67 | 75 72 61 74 69 6f 6e 20 |w Config|uration |
|00003420| 53 68 6f 75 6c 64 20 57 | 6f 72 6b 7b 66 7d 0a 0a |Should W|ork{f}..|
|00003430| 45 61 63 68 20 47 4e 55 | 20 64 69 73 74 72 69 62 |Each GNU| distrib|
|00003440| 75 74 69 6f 6e 20 73 68 | 6f 75 6c 64 20 63 6f 6d |ution sh|ould com|
|00003450| 65 20 77 69 74 68 20 61 | 20 73 68 65 6c 6c 20 73 |e with a| shell s|
|00003460| 63 72 69 70 74 20 6e 61 | 6d 65 64 0a 7b 66 43 6f |cript na|med.{fCo|
|00003470| 64 65 7d 63 6f 6e 66 69 | 67 75 72 65 7b 66 7d 2e |de}confi|gure{f}.|
|00003480| 20 20 54 68 69 73 20 73 | 63 72 69 70 74 20 69 73 | This s|cript is|
|00003490| 20 67 69 76 65 6e 20 61 | 72 67 75 6d 65 6e 74 73 | given a|rguments|
|000034a0| 20 77 68 69 63 68 20 64 | 65 73 63 72 69 62 65 20 | which d|escribe |
|000034b0| 74 68 65 0a 6b 69 6e 64 | 20 6f 66 20 6d 61 63 68 |the.kind| of mach|
|000034c0| 69 6e 65 20 61 6e 64 20 | 73 79 73 74 65 6d 20 79 |ine and |system y|
|000034d0| 6f 75 20 77 61 6e 74 20 | 74 6f 20 63 6f 6d 70 69 |ou want |to compi|
|000034e0| 6c 65 20 74 68 65 20 70 | 72 6f 67 72 61 6d 20 66 |le the p|rogram f|
|000034f0| 6f 72 2e 0a 0a 54 68 65 | 20 7b 66 43 6f 64 65 7d |or...The| {fCode}|
|00003500| 63 6f 6e 66 69 67 75 72 | 65 7b 66 7d 20 73 63 72 |configur|e{f} scr|
|00003510| 69 70 74 20 6d 75 73 74 | 20 72 65 63 6f 72 64 20 |ipt must| record |
|00003520| 74 68 65 20 63 6f 6e 66 | 69 67 75 72 61 74 69 6f |the conf|iguratio|
|00003530| 6e 20 6f 70 74 69 6f 6e | 73 20 73 6f 0a 74 68 61 |n option|s so.tha|
|00003540| 74 20 74 68 65 79 20 61 | 66 66 65 63 74 20 63 6f |t they a|ffect co|
|00003550| 6d 70 69 6c 61 74 69 6f | 6e 2e 0a 0a 4f 6e 65 20 |mpilatio|n...One |
|00003560| 77 61 79 20 74 6f 20 64 | 6f 20 74 68 69 73 20 69 |way to d|o this i|
|00003570| 73 20 74 6f 20 6d 61 6b | 65 20 61 20 6c 69 6e 6b |s to mak|e a link|
|00003580| 20 66 72 6f 6d 20 61 20 | 73 74 61 6e 64 61 72 64 | from a |standard|
|00003590| 20 6e 61 6d 65 20 73 75 | 63 68 20 61 73 0a 7b 66 | name su|ch as.{f|
|000035a0| 43 69 74 65 7d 63 6f 6e | 66 69 67 2e 68 7b 66 7d |Cite}con|fig.h{f}|
|000035b0| 20 74 6f 20 74 68 65 20 | 70 72 6f 70 65 72 20 63 | to the |proper c|
|000035c0| 6f 6e 66 69 67 75 72 61 | 74 69 6f 6e 20 66 69 6c |onfigura|tion fil|
|000035d0| 65 20 66 6f 72 20 74 68 | 65 20 63 68 6f 73 65 6e |e for th|e chosen|
|000035e0| 20 73 79 73 74 65 6d 2e | 0a 49 66 20 79 6f 75 20 | system.|.If you |
|000035f0| 75 73 65 20 74 68 69 73 | 20 74 65 63 68 6e 69 71 |use this| techniq|
|00003600| 75 65 2c 20 74 68 65 20 | 64 69 73 74 72 69 62 75 |ue, the |distribu|
|00003610| 74 69 6f 6e 20 73 68 6f | 75 6c 64 20 7b 66 45 6d |tion sho|uld {fEm|
|00003620| 70 68 61 73 69 73 7d 6e | 6f 74 7b 66 7d 20 63 6f |phasis}n|ot{f} co|
|00003630| 6e 74 61 69 6e 20 61 0a | 66 69 6c 65 20 6e 61 6d |ntain a.|file nam|
|00003640| 65 64 20 7b 66 43 69 74 | 65 7d 63 6f 6e 66 69 67 |ed {fCit|e}config|
|00003650| 2e 68 7b 66 7d 2e 20 20 | 54 68 69 73 20 69 73 20 |.h{f}. |This is |
|00003660| 73 6f 20 74 68 61 74 20 | 70 65 6f 70 6c 65 20 77 |so that |people w|
|00003670| 6f 6e 27 74 20 62 65 20 | 61 62 6c 65 20 74 6f 0a |on't be |able to.|
|00003680| 62 75 69 6c 64 20 74 68 | 65 20 70 72 6f 67 72 61 |build th|e progra|
|00003690| 6d 20 77 69 74 68 6f 75 | 74 20 63 6f 6e 66 69 67 |m withou|t config|
|000036a0| 75 72 69 6e 67 20 69 74 | 20 66 69 72 73 74 2e 0a |uring it| first..|
|000036b0| 0a 41 6e 6f 74 68 65 72 | 20 74 68 69 6e 67 20 74 |.Another| thing t|
|000036c0| 68 61 74 20 7b 66 43 6f | 64 65 7d 63 6f 6e 66 69 |hat {fCo|de}confi|
|000036d0| 67 75 72 65 7b 66 7d 20 | 63 61 6e 20 64 6f 20 69 |gure{f} |can do i|
|000036e0| 73 20 74 6f 20 65 64 69 | 74 20 74 68 65 20 4d 61 |s to edi|t the Ma|
|000036f0| 6b 65 66 69 6c 65 2e 20 | 20 49 66 0a 79 6f 75 20 |kefile. | If.you |
|00003700| 64 6f 20 74 68 69 73 2c | 20 74 68 65 20 64 69 73 |do this,| the dis|
|00003710| 74 72 69 62 75 74 69 6f | 6e 20 73 68 6f 75 6c 64 |tributio|n should|
|00003720| 20 7b 66 45 6d 70 68 61 | 73 69 73 7d 6e 6f 74 7b | {fEmpha|sis}not{|
|00003730| 66 7d 20 63 6f 6e 74 61 | 69 6e 20 61 20 66 69 6c |f} conta|in a fil|
|00003740| 65 20 6e 61 6d 65 64 0a | 7b 66 43 69 74 65 7d 4d |e named.|{fCite}M|
|00003750| 61 6b 65 66 69 6c 65 7b | 66 7d 2e 20 20 49 6e 73 |akefile{|f}. Ins|
|00003760| 74 65 61 64 2c 20 69 6e | 63 6c 75 64 65 20 61 20 |tead, in|clude a |
|00003770| 66 69 6c 65 20 7b 66 43 | 69 74 65 7d 4d 61 6b 65 |file {fC|ite}Make|
|00003780| 66 69 6c 65 2e 69 6e 7b | 66 7d 20 77 68 69 63 68 |file.in{|f} which|
|00003790| 0a 63 6f 6e 74 61 69 6e | 73 20 74 68 65 20 69 6e |.contain|s the in|
|000037a0| 70 75 74 20 75 73 65 64 | 20 66 6f 72 20 65 64 69 |put used| for edi|
|000037b0| 74 69 6e 67 2e 20 20 4f | 6e 63 65 20 61 67 61 69 |ting. O|nce agai|
|000037c0| 6e 2c 20 74 68 69 73 20 | 69 73 20 73 6f 20 74 68 |n, this |is so th|
|000037d0| 61 74 20 70 65 6f 70 6c | 65 0a 77 6f 6e 27 74 20 |at peopl|e.won't |
|000037e0| 62 65 20 61 62 6c 65 20 | 74 6f 20 62 75 69 6c 64 |be able |to build|
|000037f0| 20 74 68 65 20 70 72 6f | 67 72 61 6d 20 77 69 74 | the pro|gram wit|
|00003800| 68 6f 75 74 20 63 6f 6e | 66 69 67 75 72 69 6e 67 |hout con|figuring|
|00003810| 20 69 74 20 66 69 72 73 | 74 2e 0a 0a 49 66 20 7b | it firs|t...If {|
|00003820| 66 43 6f 64 65 7d 63 6f | 6e 66 69 67 75 72 65 7b |fCode}co|nfigure{|
|00003830| 66 7d 20 64 6f 65 73 20 | 77 72 69 74 65 20 74 68 |f} does |write th|
|00003840| 65 20 7b 66 43 69 74 65 | 7d 4d 61 6b 65 66 69 6c |e {fCite|}Makefil|
|00003850| 65 7b 66 7d 2c 20 74 68 | 65 6e 20 7b 66 43 69 74 |e{f}, th|en {fCit|
|00003860| 65 7d 4d 61 6b 65 66 69 | 6c 65 7b 66 7d 0a 73 68 |e}Makefi|le{f}.sh|
|00003870| 6f 75 6c 64 20 68 61 76 | 65 20 61 20 74 61 72 67 |ould hav|e a targ|
|00003880| 65 74 20 6e 61 6d 65 64 | 20 7b 66 43 69 74 65 7d |et named| {fCite}|
|00003890| 4d 61 6b 65 66 69 6c 65 | 7b 66 7d 20 77 68 69 63 |Makefile|{f} whic|
|000038a0| 68 20 63 61 75 73 65 73 | 20 7b 66 43 6f 64 65 7d |h causes| {fCode}|
|000038b0| 63 6f 6e 66 69 67 75 72 | 65 7b 66 7d 0a 74 6f 20 |configur|e{f}.to |
|000038c0| 62 65 20 72 65 72 75 6e | 2c 20 73 65 74 74 69 6e |be rerun|, settin|
|000038d0| 67 20 75 70 20 74 68 65 | 20 73 61 6d 65 20 63 6f |g up the| same co|
|000038e0| 6e 66 69 67 75 72 61 74 | 69 6f 6e 20 74 68 61 74 |nfigurat|ion that|
|000038f0| 20 77 61 73 20 73 65 74 | 20 75 70 20 6c 61 73 74 | was set| up last|
|00003900| 0a 74 69 6d 65 2e 20 20 | 54 68 65 20 66 69 6c 65 |.time. |The file|
|00003910| 73 20 74 68 61 74 20 7b | 66 43 6f 64 65 7d 63 6f |s that {|fCode}co|
|00003920| 6e 66 69 67 75 72 65 7b | 66 7d 20 72 65 61 64 73 |nfigure{|f} reads|
|00003930| 20 73 68 6f 75 6c 64 20 | 62 65 20 6c 69 73 74 65 | should |be liste|
|00003940| 64 20 61 73 0a 64 65 70 | 65 6e 64 65 6e 63 69 65 |d as.dep|endencie|
|00003950| 73 20 6f 66 20 7b 66 43 | 69 74 65 7d 4d 61 6b 65 |s of {fC|ite}Make|
|00003960| 66 69 6c 65 7b 66 7d 2e | 0a 0a 41 6c 6c 20 74 68 |file{f}.|..All th|
|00003970| 65 20 66 69 6c 65 73 20 | 77 68 69 63 68 20 61 72 |e files |which ar|
|00003980| 65 20 6f 75 74 70 75 74 | 20 66 72 6f 6d 20 74 68 |e output| from th|
|00003990| 65 20 7b 66 43 6f 64 65 | 7d 63 6f 6e 66 69 67 75 |e {fCode|}configu|
|000039a0| 72 65 7b 66 7d 20 73 63 | 72 69 70 74 20 73 68 6f |re{f} sc|ript sho|
|000039b0| 75 6c 64 0a 68 61 76 65 | 20 63 6f 6d 6d 65 6e 74 |uld.have| comment|
|000039c0| 73 20 61 74 20 74 68 65 | 20 62 65 67 69 6e 6e 69 |s at the| beginni|
|000039d0| 6e 67 20 65 78 70 6c 61 | 69 6e 69 6e 67 20 74 68 |ng expla|ining th|
|000039e0| 61 74 20 74 68 65 79 20 | 77 65 72 65 20 67 65 6e |at they |were gen|
|000039f0| 65 72 61 74 65 64 0a 61 | 75 74 6f 6d 61 74 69 63 |erated.a|utomatic|
|00003a00| 61 6c 6c 79 20 75 73 69 | 6e 67 20 7b 66 43 6f 64 |ally usi|ng {fCod|
|00003a10| 65 7d 63 6f 6e 66 69 67 | 75 72 65 7b 66 7d 2e 20 |e}config|ure{f}. |
|00003a20| 20 54 68 69 73 20 69 73 | 20 73 6f 20 74 68 61 74 | This is| so that|
|00003a30| 20 75 73 65 72 73 20 77 | 6f 6e 27 74 20 74 68 69 | users w|on't thi|
|00003a40| 6e 6b 0a 6f 66 20 74 72 | 79 69 6e 67 20 74 6f 20 |nk.of tr|ying to |
|00003a50| 65 64 69 74 20 74 68 65 | 6d 20 62 79 20 68 61 6e |edit the|m by han|
|00003a60| 64 2e 0a 0a 54 68 65 20 | 7b 66 43 6f 64 65 7d 63 |d...The |{fCode}c|
|00003a70| 6f 6e 66 69 67 75 72 65 | 7b 66 7d 20 73 63 72 69 |onfigure|{f} scri|
|00003a80| 70 74 20 73 68 6f 75 6c | 64 20 77 72 69 74 65 20 |pt shoul|d write |
|00003a90| 61 20 66 69 6c 65 20 6e | 61 6d 65 64 20 7b 66 43 |a file n|amed {fC|
|00003aa0| 69 74 65 7d 63 6f 6e 66 | 69 67 2e 73 74 61 74 75 |ite}conf|ig.statu|
|00003ab0| 73 7b 66 7d 0a 77 68 69 | 63 68 20 64 65 73 63 72 |s{f}.whi|ch descr|
|00003ac0| 69 62 65 73 20 77 68 69 | 63 68 20 63 6f 6e 66 69 |ibes whi|ch confi|
|00003ad0| 67 75 72 61 74 69 6f 6e | 20 6f 70 74 69 6f 6e 73 |guration| options|
|00003ae0| 20 77 65 72 65 20 73 70 | 65 63 69 66 69 65 64 20 | were sp|ecified |
|00003af0| 77 68 65 6e 20 74 68 65 | 0a 70 72 6f 67 72 61 6d |when the|.program|
|00003b00| 20 77 61 73 20 6c 61 73 | 74 20 63 6f 6e 66 69 67 | was las|t config|
|00003b10| 75 72 65 64 2e 20 20 54 | 68 69 73 20 66 69 6c 65 |ured. T|his file|
|00003b20| 20 73 68 6f 75 6c 64 20 | 62 65 20 61 20 73 68 65 | should |be a she|
|00003b30| 6c 6c 20 73 63 72 69 70 | 74 20 77 68 69 63 68 2c |ll scrip|t which,|
|00003b40| 0a 69 66 20 72 75 6e 2c | 20 77 69 6c 6c 20 72 65 |.if run,| will re|
|00003b50| 63 72 65 61 74 65 20 74 | 68 65 20 73 61 6d 65 20 |create t|he same |
|00003b60| 63 6f 6e 66 69 67 75 72 | 61 74 69 6f 6e 2e 0a 0a |configur|ation...|
|00003b70| 54 68 65 20 7b 66 43 6f | 64 65 7d 63 6f 6e 66 69 |The {fCo|de}confi|
|00003b80| 67 75 72 65 7b 66 7d 20 | 73 63 72 69 70 74 20 73 |gure{f} |script s|
|00003b90| 68 6f 75 6c 64 20 61 63 | 63 65 70 74 20 61 6e 20 |hould ac|cept an |
|00003ba0| 6f 70 74 69 6f 6e 20 6f | 66 20 74 68 65 20 66 6f |option o|f the fo|
|00003bb0| 72 6d 0a 7b 66 45 6d 70 | 68 61 73 69 73 7d 2d 2d |rm.{fEmp|hasis}--|
|00003bc0| 73 72 63 64 69 72 3d 7b | 66 53 74 72 6f 6e 67 7d |srcdir={|fStrong}|
|00003bd0| 64 69 72 6e 61 6d 65 7b | 66 7d 7b 66 7d 20 74 6f |dirname{|f}{f} to|
|00003be0| 20 73 70 65 63 69 66 79 | 20 74 68 65 20 64 69 72 | specify| the dir|
|00003bf0| 65 63 74 6f 72 79 20 77 | 68 65 72 65 20 73 6f 75 |ectory w|here sou|
|00003c00| 72 63 65 73 20 61 72 65 | 20 66 6f 75 6e 64 0a 28 |rces are| found.(|
|00003c10| 69 66 20 69 74 20 69 73 | 20 6e 6f 74 20 74 68 65 |if it is| not the|
|00003c20| 20 63 75 72 72 65 6e 74 | 20 64 69 72 65 63 74 6f | current| directo|
|00003c30| 72 79 29 2e 20 20 54 68 | 69 73 20 6d 61 6b 65 73 |ry). Th|is makes|
|00003c40| 20 69 74 20 70 6f 73 73 | 69 62 6c 65 20 74 6f 20 | it poss|ible to |
|00003c50| 62 75 69 6c 64 0a 74 68 | 65 20 70 72 6f 67 72 61 |build.th|e progra|
|00003c60| 6d 20 69 6e 20 61 20 73 | 65 70 61 72 61 74 65 20 |m in a s|eparate |
|00003c70| 64 69 72 65 63 74 6f 72 | 79 2c 20 73 6f 20 74 68 |director|y, so th|
|00003c80| 61 74 20 74 68 65 20 61 | 63 74 75 61 6c 20 73 6f |at the a|ctual so|
|00003c90| 75 72 63 65 20 64 69 72 | 65 63 74 6f 72 79 0a 69 |urce dir|ectory.i|
|00003ca0| 73 20 6e 6f 74 20 6d 6f | 64 69 66 69 65 64 2e 0a |s not mo|dified..|
|00003cb0| 0a 49 66 20 74 68 65 20 | 75 73 65 72 20 64 6f 65 |.If the |user doe|
|00003cc0| 73 20 6e 6f 74 20 73 70 | 65 63 69 66 79 20 7b 66 |s not sp|ecify {f|
|00003cd0| 45 6d 70 68 61 73 69 73 | 7d 2d 2d 73 72 63 64 69 |Emphasis|}--srcdi|
|00003ce0| 72 7b 66 7d 2c 20 74 68 | 65 6e 20 7b 66 43 6f 64 |r{f}, th|en {fCod|
|00003cf0| 65 7d 63 6f 6e 66 69 67 | 75 72 65 7b 66 7d 20 73 |e}config|ure{f} s|
|00003d00| 68 6f 75 6c 64 0a 63 68 | 65 63 6b 20 62 6f 74 68 |hould.ch|eck both|
|00003d10| 20 7b 66 43 69 74 65 7d | 2e 7b 66 7d 20 61 6e 64 | {fCite}|.{f} and|
|00003d20| 20 7b 66 43 69 74 65 7d | 2e 2e 7b 66 7d 20 74 6f | {fCite}|..{f} to|
|00003d30| 20 73 65 65 20 69 66 20 | 69 74 20 63 61 6e 20 66 | see if |it can f|
|00003d40| 69 6e 64 20 74 68 65 20 | 73 6f 75 72 63 65 73 2e |ind the |sources.|
|00003d50| 20 20 49 66 0a 69 74 20 | 66 69 6e 64 73 20 74 68 | If.it |finds th|
|00003d60| 65 20 73 6f 75 72 63 65 | 73 20 69 6e 20 6f 6e 65 |e source|s in one|
|00003d70| 20 6f 66 20 74 68 65 73 | 65 20 70 6c 61 63 65 73 | of thes|e places|
|00003d80| 2c 20 69 74 20 73 68 6f | 75 6c 64 20 75 73 65 20 |, it sho|uld use |
|00003d90| 74 68 65 6d 20 66 72 6f | 6d 0a 74 68 65 72 65 2e |them fro|m.there.|
|00003da0| 20 20 4f 74 68 65 72 77 | 69 73 65 2c 20 69 74 20 | Otherw|ise, it |
|00003db0| 73 68 6f 75 6c 64 20 72 | 65 70 6f 72 74 20 74 68 |should r|eport th|
|00003dc0| 61 74 20 69 74 20 63 61 | 6e 6e 6f 74 20 66 69 6e |at it ca|nnot fin|
|00003dd0| 64 20 74 68 65 20 73 6f | 75 72 63 65 73 2c 20 61 |d the so|urces, a|
|00003de0| 6e 64 0a 73 68 6f 75 6c | 64 20 65 78 69 74 20 77 |nd.shoul|d exit w|
|00003df0| 69 74 68 20 6e 6f 6e 7a | 65 72 6f 20 73 74 61 74 |ith nonz|ero stat|
|00003e00| 75 73 2e 0a 0a 55 73 75 | 61 6c 6c 79 20 74 68 65 |us...Usu|ally the|
|00003e10| 20 65 61 73 79 20 77 61 | 79 20 74 6f 20 73 75 70 | easy wa|y to sup|
|00003e20| 70 6f 72 74 20 7b 66 45 | 6d 70 68 61 73 69 73 7d |port {fE|mphasis}|
|00003e30| 2d 2d 73 72 63 64 69 72 | 7b 66 7d 20 69 73 20 62 |--srcdir|{f} is b|
|00003e40| 79 20 65 64 69 74 69 6e | 67 20 61 0a 64 65 66 69 |y editin|g a.defi|
|00003e50| 6e 69 74 69 6f 6e 20 6f | 66 20 7b 66 43 6f 64 65 |nition o|f {fCode|
|00003e60| 7d 56 50 41 54 48 7b 66 | 7d 20 69 6e 74 6f 20 74 |}VPATH{f|} into t|
|00003e70| 68 65 20 4d 61 6b 65 66 | 69 6c 65 2e 20 20 53 6f |he Makef|ile. So|
|00003e80| 6d 65 20 72 75 6c 65 73 | 20 6d 61 79 20 6e 65 65 |me rules| may nee|
|00003e90| 64 20 74 6f 0a 72 65 66 | 65 72 20 65 78 70 6c 69 |d to.ref|er expli|
|00003ea0| 63 69 74 6c 79 20 74 6f | 20 74 68 65 20 73 70 65 |citly to| the spe|
|00003eb0| 63 69 66 69 65 64 20 73 | 6f 75 72 63 65 20 64 69 |cified s|ource di|
|00003ec0| 72 65 63 74 6f 72 79 2e | 20 20 54 6f 20 6d 61 6b |rectory.| To mak|
|00003ed0| 65 20 74 68 69 73 0a 70 | 6f 73 73 69 62 6c 65 2c |e this.p|ossible,|
|00003ee0| 20 7b 66 43 6f 64 65 7d | 63 6f 6e 66 69 67 75 72 | {fCode}|configur|
|00003ef0| 65 7b 66 7d 20 63 61 6e | 20 61 64 64 20 74 6f 20 |e{f} can| add to |
|00003f00| 74 68 65 20 4d 61 6b 65 | 66 69 6c 65 20 61 20 76 |the Make|file a v|
|00003f10| 61 72 69 61 62 6c 65 20 | 6e 61 6d 65 64 0a 7b 66 |ariable |named.{f|
|00003f20| 43 6f 64 65 7d 73 72 63 | 64 69 72 7b 66 7d 20 77 |Code}src|dir{f} w|
|00003f30| 68 6f 73 65 20 76 61 6c | 75 65 20 69 73 20 70 72 |hose val|ue is pr|
|00003f40| 65 63 69 73 65 6c 79 20 | 74 68 65 20 73 70 65 63 |ecisely |the spec|
|00003f50| 69 66 69 65 64 20 64 69 | 72 65 63 74 6f 72 79 2e |ified di|rectory.|
|00003f60| 0a 0a 54 68 65 20 7b 66 | 43 6f 64 65 7d 63 6f 6e |..The {f|Code}con|
|00003f70| 66 69 67 75 72 65 7b 66 | 7d 20 73 63 72 69 70 74 |figure{f|} script|
|00003f80| 20 73 68 6f 75 6c 64 20 | 61 6c 73 6f 20 74 61 6b | should |also tak|
|00003f90| 65 20 61 6e 20 61 72 67 | 75 6d 65 6e 74 20 77 68 |e an arg|ument wh|
|00003fa0| 69 63 68 20 73 70 65 63 | 69 66 69 65 73 20 74 68 |ich spec|ifies th|
|00003fb0| 65 0a 74 79 70 65 20 6f | 66 20 73 79 73 74 65 6d |e.type o|f system|
|00003fc0| 20 74 6f 20 62 75 69 6c | 64 20 74 68 65 20 70 72 | to buil|d the pr|
|00003fd0| 6f 67 72 61 6d 20 66 6f | 72 2e 20 20 54 68 69 73 |ogram fo|r. This|
|00003fe0| 20 61 72 67 75 6d 65 6e | 74 20 73 68 6f 75 6c 64 | argumen|t should|
|00003ff0| 20 6c 6f 6f 6b 20 6c 69 | 6b 65 0a 74 68 69 73 3a | look li|ke.this:|
|00004000| 0a 0a 23 57 72 61 70 20 | 6f 66 66 0a 23 66 43 6f |..#Wrap |off.#fCo|
|00004010| 64 65 0a 7b 66 53 74 72 | 6f 6e 67 7d 63 70 75 7b |de.{fStr|ong}cpu{|
|00004020| 66 7d 2d 7b 66 53 74 72 | 6f 6e 67 7d 63 6f 6d 70 |f}-{fStr|ong}comp|
|00004030| 61 6e 79 7b 66 7d 2d 7b | 66 53 74 72 6f 6e 67 7d |any{f}-{|fStrong}|
|00004040| 73 79 73 74 65 6d 7b 66 | 7d 0a 23 66 0a 23 57 72 |system{f|}.#f.#Wr|
|00004050| 61 70 20 6f 6e 0a 0a 46 | 6f 72 20 65 78 61 6d 70 |ap on..F|or examp|
|00004060| 6c 65 2c 20 61 20 53 75 | 6e 20 33 20 6d 69 67 68 |le, a Su|n 3 migh|
|00004070| 74 20 62 65 20 7b 66 45 | 6d 70 68 61 73 69 73 7d |t be {fE|mphasis}|
|00004080| 6d 36 38 6b 2d 73 75 6e | 2d 73 75 6e 6f 73 34 2e |m68k-sun|-sunos4.|
|00004090| 31 7b 66 7d 2e 0a 0a 54 | 68 65 20 7b 66 43 6f 64 |1{f}...T|he {fCod|
|000040a0| 65 7d 63 6f 6e 66 69 67 | 75 72 65 7b 66 7d 20 73 |e}config|ure{f} s|
|000040b0| 63 72 69 70 74 20 6e 65 | 65 64 73 20 74 6f 20 62 |cript ne|eds to b|
|000040c0| 65 20 61 62 6c 65 20 74 | 6f 20 64 65 63 6f 64 65 |e able t|o decode|
|000040d0| 20 61 6c 6c 20 70 6c 61 | 75 73 69 62 6c 65 0a 61 | all pla|usible.a|
|000040e0| 6c 74 65 72 6e 61 74 69 | 76 65 73 20 66 6f 72 20 |lternati|ves for |
|000040f0| 68 6f 77 20 74 6f 20 64 | 65 73 63 72 69 62 65 20 |how to d|escribe |
|00004100| 61 20 6d 61 63 68 69 6e | 65 2e 20 20 54 68 75 73 |a machin|e. Thus|
|00004110| 2c 20 7b 66 45 6d 70 68 | 61 73 69 73 7d 73 75 6e |, {fEmph|asis}sun|
|00004120| 33 2d 73 75 6e 6f 73 34 | 2e 31 7b 66 7d 0a 77 6f |3-sunos4|.1{f}.wo|
|00004130| 75 6c 64 20 62 65 20 61 | 20 76 61 6c 69 64 20 61 |uld be a| valid a|
|00004140| 6c 69 61 73 2e 20 20 53 | 6f 20 77 6f 75 6c 64 20 |lias. S|o would |
|00004150| 7b 66 45 6d 70 68 61 73 | 69 73 7d 73 75 6e 33 2d |{fEmphas|is}sun3-|
|00004160| 62 73 64 34 2e 32 7b 66 | 7d 2c 20 73 69 6e 63 65 |bsd4.2{f|}, since|
|00004170| 20 53 75 6e 4f 53 20 69 | 73 0a 62 61 73 69 63 61 | SunOS i|s.basica|
|00004180| 6c 6c 79 20 42 53 44 20 | 61 6e 64 20 6e 6f 20 6f |lly BSD |and no o|
|00004190| 74 68 65 72 20 42 53 44 | 20 73 79 73 74 65 6d 20 |ther BSD| system |
|000041a0| 69 73 20 75 73 65 64 20 | 6f 6e 20 61 20 53 75 6e |is used |on a Sun|
|000041b0| 2e 20 20 46 6f 72 20 6d | 61 6e 79 0a 70 72 6f 67 |. For m|any.prog|
|000041c0| 72 61 6d 73 2c 20 7b 66 | 45 6d 70 68 61 73 69 73 |rams, {f|Emphasis|
|000041d0| 7d 76 61 78 2d 64 65 63 | 2d 75 6c 74 72 69 78 7b |}vax-dec|-ultrix{|
|000041e0| 66 7d 20 77 6f 75 6c 64 | 20 62 65 20 61 6e 20 61 |f} would| be an a|
|000041f0| 6c 69 61 73 20 66 6f 72 | 0a 7b 66 45 6d 70 68 61 |lias for|.{fEmpha|
|00004200| 73 69 73 7d 76 61 78 2d | 64 65 63 2d 62 73 64 7b |sis}vax-|dec-bsd{|
|00004210| 66 7d 2c 20 73 69 6d 70 | 6c 79 20 62 65 63 61 75 |f}, simp|ly becau|
|00004220| 73 65 20 74 68 65 20 64 | 69 66 66 65 72 65 6e 63 |se the d|ifferenc|
|00004230| 65 73 20 62 65 74 77 65 | 65 6e 20 55 6c 74 72 69 |es betwe|en Ultri|
|00004240| 78 20 61 6e 64 0a 42 53 | 44 20 61 72 65 20 72 61 |x and.BS|D are ra|
|00004250| 72 65 6c 79 20 6e 6f 74 | 69 63 65 61 62 6c 65 2c |rely not|iceable,|
|00004260| 20 62 75 74 20 61 20 66 | 65 77 20 70 72 6f 67 72 | but a f|ew progr|
|00004270| 61 6d 73 20 6d 69 67 68 | 74 20 6e 65 65 64 20 74 |ams migh|t need t|
|00004280| 6f 20 64 69 73 74 69 6e | 67 75 69 73 68 0a 74 68 |o distin|guish.th|
|00004290| 65 6d 2e 0a 0a 54 68 65 | 72 65 20 69 73 20 61 20 |em...The|re is a |
|000042a0| 73 68 65 6c 6c 20 73 63 | 72 69 70 74 20 63 61 6c |shell sc|ript cal|
|000042b0| 6c 65 64 20 7b 66 43 69 | 74 65 7d 63 6f 6e 66 69 |led {fCi|te}confi|
|000042c0| 67 2e 73 75 62 7b 66 7d | 20 74 68 61 74 20 79 6f |g.sub{f}| that yo|
|000042d0| 75 20 63 61 6e 20 75 73 | 65 0a 61 73 20 61 20 73 |u can us|e.as a s|
|000042e0| 75 62 72 6f 75 74 69 6e | 65 20 74 6f 20 76 61 6c |ubroutin|e to val|
|000042f0| 69 64 61 74 65 20 73 79 | 73 74 65 6d 20 74 79 70 |idate sy|stem typ|
|00004300| 65 73 20 61 6e 64 20 63 | 61 6e 6f 6e 69 63 61 6c |es and c|anonical|
|00004310| 69 7a 65 20 61 6c 69 61 | 73 65 73 2e 0a 0a 4f 74 |ize alia|ses...Ot|
|00004320| 68 65 72 20 6f 70 74 69 | 6f 6e 73 20 61 72 65 20 |her opti|ons are |
|00004330| 70 65 72 6d 69 74 74 65 | 64 20 74 6f 20 73 70 65 |permitte|d to spe|
|00004340| 63 69 66 79 20 69 6e 20 | 6d 6f 72 65 20 64 65 74 |cify in |more det|
|00004350| 61 69 6c 20 74 68 65 20 | 73 6f 66 74 77 61 72 65 |ail the |software|
|00004360| 0a 6f 72 20 68 61 72 64 | 77 61 72 65 20 70 72 65 |.or hard|ware pre|
|00004370| 73 65 6e 74 20 6f 6e 20 | 74 68 65 20 6d 61 63 68 |sent on |the mach|
|00004380| 69 6e 65 2c 20 61 6e 64 | 20 69 6e 63 6c 75 64 65 |ine, and| include|
|00004390| 20 6f 72 20 65 78 63 6c | 75 64 65 20 6f 70 74 69 | or excl|ude opti|
|000043a0| 6f 6e 61 6c 0a 70 61 72 | 74 73 20 6f 66 20 74 68 |onal.par|ts of th|
|000043b0| 65 20 70 61 63 6b 61 67 | 65 3a 0a 0a 23 49 6e 64 |e packag|e:..#Ind|
|000043c0| 65 6e 74 20 2b 34 0a 23 | 49 6e 64 65 6e 74 0a 7b |ent +4.#|Indent.{|
|000043d0| 66 45 6d 70 68 61 73 69 | 73 7d 2d 2d 65 6e 61 62 |fEmphasi|s}--enab|
|000043e0| 6c 65 2d 7b 66 53 74 72 | 6f 6e 67 7d 66 65 61 74 |le-{fStr|ong}feat|
|000043f0| 75 72 65 7b 66 7d 5b 3d | 7b 66 53 74 72 6f 6e 67 |ure{f}[=|{fStrong|
|00004400| 7d 70 61 72 61 6d 65 74 | 65 72 7b 66 7d 5d 7b 66 |}paramet|er{f}]{f|
|00004410| 7d 0a 23 49 6e 64 65 6e | 74 20 2b 34 0a 43 6f 6e |}.#Inden|t +4.Con|
|00004420| 66 69 67 75 72 65 20 74 | 68 65 20 70 61 63 6b 61 |figure t|he packa|
|00004430| 67 65 20 74 6f 20 62 75 | 69 6c 64 20 61 6e 64 20 |ge to bu|ild and |
|00004440| 69 6e 73 74 61 6c 6c 20 | 61 6e 20 6f 70 74 69 6f |install |an optio|
|00004450| 6e 61 6c 20 75 73 65 72 | 2d 6c 65 76 65 6c 0a 66 |nal user|-level.f|
|00004460| 61 63 69 6c 69 74 79 20 | 63 61 6c 6c 65 64 20 7b |acility |called {|
|00004470| 66 53 74 72 6f 6e 67 7d | 66 65 61 74 75 72 65 7b |fStrong}|feature{|
|00004480| 66 7d 2e 20 20 54 68 69 | 73 20 61 6c 6c 6f 77 73 |f}. Thi|s allows|
|00004490| 20 75 73 65 72 73 20 74 | 6f 20 63 68 6f 6f 73 65 | users t|o choose|
|000044a0| 20 77 68 69 63 68 0a 6f | 70 74 69 6f 6e 61 6c 20 | which.o|ptional |
|000044b0| 66 65 61 74 75 72 65 73 | 20 74 6f 20 69 6e 63 6c |features| to incl|
|000044c0| 75 64 65 2e 20 20 47 69 | 76 69 6e 67 20 61 6e 20 |ude. Gi|ving an |
|000044d0| 6f 70 74 69 6f 6e 61 6c | 20 7b 66 53 74 72 6f 6e |optional| {fStron|
|000044e0| 67 7d 70 61 72 61 6d 65 | 74 65 72 7b 66 7d 20 6f |g}parame|ter{f} o|
|000044f0| 66 0a 7b 66 45 6d 70 68 | 61 73 69 73 7d 6e 6f 7b |f.{fEmph|asis}no{|
|00004500| 66 7d 20 73 68 6f 75 6c | 64 20 6f 6d 69 74 20 7b |f} shoul|d omit {|
|00004510| 66 53 74 72 6f 6e 67 7d | 66 65 61 74 75 72 65 7b |fStrong}|feature{|
|00004520| 66 7d 2c 20 69 66 20 69 | 74 20 69 73 20 62 75 69 |f}, if i|t is bui|
|00004530| 6c 74 20 62 79 20 64 65 | 66 61 75 6c 74 2e 0a 0a |lt by de|fault...|
|00004540| 4e 6f 20 7b 66 45 6d 70 | 68 61 73 69 73 7d 2d 2d |No {fEmp|hasis}--|
|00004550| 65 6e 61 62 6c 65 7b 66 | 7d 20 6f 70 74 69 6f 6e |enable{f|} option|
|00004560| 20 73 68 6f 75 6c 64 20 | 7b 66 53 74 72 6f 6e 67 | should |{fStrong|
|00004570| 7d 65 76 65 72 7b 66 7d | 20 63 61 75 73 65 20 6f |}ever{f}| cause o|
|00004580| 6e 65 20 66 65 61 74 75 | 72 65 20 74 6f 0a 72 65 |ne featu|re to.re|
|00004590| 70 6c 61 63 65 20 61 6e | 6f 74 68 65 72 2e 20 20 |place an|other. |
|000045a0| 4e 6f 20 7b 66 45 6d 70 | 68 61 73 69 73 7d 2d 2d |No {fEmp|hasis}--|
|000045b0| 65 6e 61 62 6c 65 7b 66 | 7d 20 6f 70 74 69 6f 6e |enable{f|} option|
|000045c0| 20 73 68 6f 75 6c 64 20 | 65 76 65 72 20 73 75 62 | should |ever sub|
|000045d0| 73 74 69 74 75 74 65 20 | 6f 6e 65 0a 75 73 65 66 |stitute |one.usef|
|000045e0| 75 6c 20 62 65 68 61 76 | 69 6f 72 20 66 6f 72 20 |ul behav|ior for |
|000045f0| 61 6e 6f 74 68 65 72 20 | 75 73 65 66 75 6c 20 62 |another |useful b|
|00004600| 65 68 61 76 69 6f 72 2e | 20 20 54 68 65 20 6f 6e |ehavior.| The on|
|00004610| 6c 79 20 70 72 6f 70 65 | 72 20 75 73 65 20 66 6f |ly prope|r use fo|
|00004620| 72 0a 7b 66 45 6d 70 68 | 61 73 69 73 7d 2d 2d 65 |r.{fEmph|asis}--e|
|00004630| 6e 61 62 6c 65 7b 66 7d | 20 69 73 20 66 6f 72 20 |nable{f}| is for |
|00004640| 71 75 65 73 74 69 6f 6e | 73 20 6f 66 20 77 68 65 |question|s of whe|
|00004650| 74 68 65 72 20 74 6f 20 | 62 75 69 6c 64 20 70 61 |ther to |build pa|
|00004660| 72 74 20 6f 66 20 74 68 | 65 20 70 72 6f 67 72 61 |rt of th|e progra|
|00004670| 6d 0a 6f 72 20 65 78 63 | 6c 75 64 65 20 69 74 2e |m.or exc|lude it.|
|00004680| 0a 0a 23 49 6e 64 65 6e | 74 0a 7b 66 45 6d 70 68 |..#Inden|t.{fEmph|
|00004690| 61 73 69 73 7d 2d 2d 77 | 69 74 68 2d 7b 66 53 74 |asis}--w|ith-{fSt|
|000046a0| 72 6f 6e 67 7d 70 61 63 | 6b 61 67 65 7b 66 7d 7b |rong}pac|kage{f}{|
|000046b0| 66 7d 0a 23 49 6e 64 65 | 6e 74 20 2b 34 0a 54 68 |f}.#Inde|nt +4.Th|
|000046c0| 65 20 70 61 63 6b 61 67 | 65 20 7b 66 53 74 72 6f |e packag|e {fStro|
|000046d0| 6e 67 7d 70 61 63 6b 61 | 67 65 7b 66 7d 20 77 69 |ng}packa|ge{f} wi|
|000046e0| 6c 6c 20 62 65 20 69 6e | 73 74 61 6c 6c 65 64 2c |ll be in|stalled,|
|000046f0| 20 73 6f 20 63 6f 6e 66 | 69 67 75 72 65 20 74 68 | so conf|igure th|
|00004700| 69 73 20 70 61 63 6b 61 | 67 65 0a 74 6f 20 77 6f |is packa|ge.to wo|
|00004710| 72 6b 20 77 69 74 68 20 | 7b 66 53 74 72 6f 6e 67 |rk with |{fStrong|
|00004720| 7d 70 61 63 6b 61 67 65 | 7b 66 7d 2e 0a 0a 0a 50 |}package|{f}....P|
|00004730| 6f 73 73 69 62 6c 65 20 | 76 61 6c 75 65 73 20 6f |ossible |values o|
|00004740| 66 20 7b 66 53 74 72 6f | 6e 67 7d 70 61 63 6b 61 |f {fStro|ng}packa|
|00004750| 67 65 7b 66 7d 20 69 6e | 63 6c 75 64 65 20 7b 66 |ge{f} in|clude {f|
|00004760| 45 6d 70 68 61 73 69 73 | 7d 78 7b 66 7d 2c 20 7b |Emphasis|}x{f}, {|
|00004770| 66 45 6d 70 68 61 73 69 | 73 7d 78 2d 74 6f 6f 6c |fEmphasi|s}x-tool|
|00004780| 6b 69 74 7b 66 7d 2c 0a | 7b 66 45 6d 70 68 61 73 |kit{f},.|{fEmphas|
|00004790| 69 73 7d 67 6e 75 2d 61 | 73 7b 66 7d 20 28 6f 72 |is}gnu-a|s{f} (or|
|000047a0| 20 7b 66 45 6d 70 68 61 | 73 69 73 7d 67 61 73 7b | {fEmpha|sis}gas{|
|000047b0| 66 7d 29 2c 20 7b 66 45 | 6d 70 68 61 73 69 73 7d |f}), {fE|mphasis}|
|000047c0| 67 6e 75 2d 6c 64 7b 66 | 7d 2c 20 7b 66 45 6d 70 |gnu-ld{f|}, {fEmp|
|000047d0| 68 61 73 69 73 7d 67 6e | 75 2d 6c 69 62 63 7b 66 |hasis}gn|u-libc{f|
|000047e0| 7d 2c 20 61 6e 64 0a 7b | 66 45 6d 70 68 61 73 69 |}, and.{|fEmphasi|
|000047f0| 73 7d 67 64 62 7b 66 7d | 2e 0a 0a 44 6f 20 6e 6f |s}gdb{f}|...Do no|
|00004800| 74 20 75 73 65 20 61 20 | 7b 66 45 6d 70 68 61 73 |t use a |{fEmphas|
|00004810| 69 73 7d 2d 2d 77 69 74 | 68 7b 66 7d 20 6f 70 74 |is}--wit|h{f} opt|
|00004820| 69 6f 6e 20 74 6f 20 73 | 70 65 63 69 66 79 20 74 |ion to s|pecify t|
|00004830| 68 65 20 66 69 6c 65 20 | 6e 61 6d 65 20 74 6f 20 |he file |name to |
|00004840| 75 73 65 20 74 6f 0a 66 | 69 6e 64 20 63 65 72 74 |use to.f|ind cert|
|00004850| 61 69 6e 20 66 69 6c 65 | 73 2e 20 20 54 68 61 74 |ain file|s. That|
|00004860| 20 69 73 20 6f 75 74 73 | 69 64 65 20 74 68 65 20 | is outs|ide the |
|00004870| 73 63 6f 70 65 20 6f 66 | 20 77 68 61 74 20 7b 66 |scope of| what {f|
|00004880| 45 6d 70 68 61 73 69 73 | 7d 2d 2d 77 69 74 68 7b |Emphasis|}--with{|
|00004890| 66 7d 0a 6f 70 74 69 6f | 6e 73 20 61 72 65 20 66 |f}.optio|ns are f|
|000048a0| 6f 72 2e 0a 0a 23 49 6e | 64 65 6e 74 0a 7b 66 45 |or...#In|dent.{fE|
|000048b0| 6d 70 68 61 73 69 73 7d | 2d 2d 6e 66 70 7b 66 7d |mphasis}|--nfp{f}|
|000048c0| 0a 23 49 6e 64 65 6e 74 | 20 2b 34 0a 54 68 65 20 |.#Indent| +4.The |
|000048d0| 74 61 72 67 65 74 20 6d | 61 63 68 69 6e 65 20 68 |target m|achine h|
|000048e0| 61 73 20 6e 6f 20 66 6c | 6f 61 74 69 6e 67 20 70 |as no fl|oating p|
|000048f0| 6f 69 6e 74 20 70 72 6f | 63 65 73 73 6f 72 2e 0a |oint pro|cessor..|
|00004900| 0a 23 49 6e 64 65 6e 74 | 0a 7b 66 45 6d 70 68 61 |.#Indent|.{fEmpha|
|00004910| 73 69 73 7d 2d 2d 67 61 | 73 7b 66 7d 0a 23 49 6e |sis}--ga|s{f}.#In|
|00004920| 64 65 6e 74 20 2b 34 0a | 54 68 65 20 74 61 72 67 |dent +4.|The targ|
|00004930| 65 74 20 6d 61 63 68 69 | 6e 65 20 61 73 73 65 6d |et machi|ne assem|
|00004940| 62 6c 65 72 20 69 73 20 | 47 41 53 2c 20 74 68 65 |bler is |GAS, the|
|00004950| 20 47 4e 55 20 61 73 73 | 65 6d 62 6c 65 72 2e 0a | GNU ass|embler..|
|00004960| 54 68 69 73 20 69 73 20 | 6f 62 73 6f 6c 65 74 65 |This is |obsolete|
|00004970| 3b 20 75 73 65 72 73 20 | 73 68 6f 75 6c 64 20 75 |; users |should u|
|00004980| 73 65 20 7b 66 45 6d 70 | 68 61 73 69 73 7d 2d 2d |se {fEmp|hasis}--|
|00004990| 77 69 74 68 2d 67 6e 75 | 2d 61 73 7b 66 7d 20 69 |with-gnu|-as{f} i|
|000049a0| 6e 73 74 65 61 64 2e 0a | 0a 23 49 6e 64 65 6e 74 |nstead..|.#Indent|
|000049b0| 0a 7b 66 45 6d 70 68 61 | 73 69 73 7d 2d 2d 78 7b |.{fEmpha|sis}--x{|
|000049c0| 66 7d 0a 23 49 6e 64 65 | 6e 74 20 2b 34 0a 54 68 |f}.#Inde|nt +4.Th|
|000049d0| 65 20 74 61 72 67 65 74 | 20 6d 61 63 68 69 6e 65 |e target| machine|
|000049e0| 20 68 61 73 20 74 68 65 | 20 58 20 57 69 6e 64 6f | has the| X Windo|
|000049f0| 77 20 53 79 73 74 65 6d | 20 69 6e 73 74 61 6c 6c |w System| install|
|00004a00| 65 64 2e 0a 54 68 69 73 | 20 69 73 20 6f 62 73 6f |ed..This| is obso|
|00004a10| 6c 65 74 65 3b 20 75 73 | 65 72 73 20 73 68 6f 75 |lete; us|ers shou|
|00004a20| 6c 64 20 75 73 65 20 7b | 66 45 6d 70 68 61 73 69 |ld use {|fEmphasi|
|00004a30| 73 7d 2d 2d 77 69 74 68 | 2d 78 7b 66 7d 20 69 6e |s}--with|-x{f} in|
|00004a40| 73 74 65 61 64 2e 0a 0a | 23 49 6e 64 65 6e 74 0a |stead...|#Indent.|
|00004a50| 0a 41 6c 6c 20 7b 66 43 | 6f 64 65 7d 63 6f 6e 66 |.All {fC|ode}conf|
|00004a60| 69 67 75 72 65 7b 66 7d | 20 73 63 72 69 70 74 73 |igure{f}| scripts|
|00004a70| 20 73 68 6f 75 6c 64 20 | 61 63 63 65 70 74 20 61 | should |accept a|
|00004a80| 6c 6c 20 6f 66 20 74 68 | 65 73 65 20 60 60 64 65 |ll of th|ese ``de|
|00004a90| 74 61 69 6c 27 27 0a 6f | 70 74 69 6f 6e 73 2c 20 |tail''.o|ptions, |
|00004aa0| 77 68 65 74 68 65 72 20 | 6f 72 20 6e 6f 74 20 74 |whether |or not t|
|00004ab0| 68 65 79 20 6d 61 6b 65 | 20 61 6e 79 20 64 69 66 |hey make| any dif|
|00004ac0| 66 65 72 65 6e 63 65 20 | 74 6f 20 74 68 65 20 70 |ference |to the p|
|00004ad0| 61 72 74 69 63 75 6c 61 | 72 0a 70 61 63 6b 61 67 |articula|r.packag|
|00004ae0| 65 20 61 74 20 68 61 6e | 64 2e 20 20 49 6e 20 70 |e at han|d. In p|
|00004af0| 61 72 74 69 63 75 6c 61 | 72 2c 20 74 68 65 79 20 |articula|r, they |
|00004b00| 73 68 6f 75 6c 64 20 61 | 63 63 65 70 74 20 61 6e |should a|ccept an|
|00004b10| 79 20 6f 70 74 69 6f 6e | 20 74 68 61 74 0a 73 74 |y option| that.st|
|00004b20| 61 72 74 73 20 77 69 74 | 68 20 7b 66 45 6d 70 68 |arts wit|h {fEmph|
|00004b30| 61 73 69 73 7d 2d 2d 77 | 69 74 68 2d 7b 66 7d 20 |asis}--w|ith-{f} |
|00004b40| 6f 72 20 7b 66 45 6d 70 | 68 61 73 69 73 7d 2d 2d |or {fEmp|hasis}--|
|00004b50| 65 6e 61 62 6c 65 2d 7b | 66 7d 2e 20 20 54 68 69 |enable-{|f}. Thi|
|00004b60| 73 20 69 73 20 73 6f 20 | 75 73 65 72 73 20 77 69 |s is so |users wi|
|00004b70| 6c 6c 0a 62 65 20 61 62 | 6c 65 20 74 6f 20 63 6f |ll.be ab|le to co|
|00004b80| 6e 66 69 67 75 72 65 20 | 61 6e 20 65 6e 74 69 72 |nfigure |an entir|
|00004b90| 65 20 47 4e 55 20 73 6f | 75 72 63 65 20 74 72 65 |e GNU so|urce tre|
|00004ba0| 65 20 61 74 20 6f 6e 63 | 65 20 77 69 74 68 20 61 |e at onc|e with a|
|00004bb0| 20 73 69 6e 67 6c 65 20 | 73 65 74 0a 6f 66 20 6f | single |set.of o|
|00004bc0| 70 74 69 6f 6e 73 2e 0a | 0a 59 6f 75 20 77 69 6c |ptions..|.You wil|
|00004bd0| 6c 20 6e 6f 74 65 20 74 | 68 61 74 20 74 68 65 20 |l note t|hat the |
|00004be0| 63 61 74 65 67 6f 72 69 | 65 73 20 7b 66 45 6d 70 |categori|es {fEmp|
|00004bf0| 68 61 73 69 73 7d 2d 2d | 77 69 74 68 2d 7b 66 7d |hasis}--|with-{f}|
|00004c00| 20 61 6e 64 20 7b 66 45 | 6d 70 68 61 73 69 73 7d | and {fE|mphasis}|
|00004c10| 2d 2d 65 6e 61 62 6c 65 | 2d 7b 66 7d 0a 61 72 65 |--enable|-{f}.are|
|00004c20| 20 6e 61 72 72 6f 77 3a | 20 74 68 65 79 20 7b 66 | narrow:| they {f|
|00004c30| 53 74 72 6f 6e 67 7d 64 | 6f 20 6e 6f 74 7b 66 7d |Strong}d|o not{f}|
|00004c40| 20 70 72 6f 76 69 64 65 | 20 61 20 70 6c 61 63 65 | provide| a place|
|00004c50| 20 66 6f 72 20 61 6e 79 | 20 73 6f 72 74 20 6f 66 | for any| sort of|
|00004c60| 20 6f 70 74 69 6f 6e 0a | 79 6f 75 20 6d 69 67 68 | option.|you migh|
|00004c70| 74 20 74 68 69 6e 6b 20 | 6f 66 2e 20 20 54 68 61 |t think |of. Tha|
|00004c80| 74 20 69 73 20 64 65 6c | 69 62 65 72 61 74 65 2e |t is del|iberate.|
|00004c90| 20 20 57 65 20 77 61 6e | 74 20 74 6f 20 6c 69 6d | We wan|t to lim|
|00004ca0| 69 74 20 74 68 65 20 70 | 6f 73 73 69 62 6c 65 0a |it the p|ossible.|
|00004cb0| 63 6f 6e 66 69 67 75 72 | 61 74 69 6f 6e 20 6f 70 |configur|ation op|
|00004cc0| 74 69 6f 6e 73 20 69 6e | 20 47 4e 55 20 73 6f 66 |tions in| GNU sof|
|00004cd0| 74 77 61 72 65 2e 20 20 | 57 65 20 64 6f 20 6e 6f |tware. |We do no|
|00004ce0| 74 20 77 61 6e 74 20 47 | 4e 55 20 70 72 6f 67 72 |t want G|NU progr|
|00004cf0| 61 6d 73 20 74 6f 0a 68 | 61 76 65 20 69 64 69 6f |ams to.h|ave idio|
|00004d00| 73 79 6e 63 72 61 74 69 | 63 20 63 6f 6e 66 69 67 |syncrati|c config|
|00004d10| 75 72 61 74 69 6f 6e 20 | 6f 70 74 69 6f 6e 73 2e |uration |options.|
|00004d20| 0a 0a 50 61 63 6b 61 67 | 65 73 20 74 68 61 74 20 |..Packag|es that |
|00004d30| 70 65 72 66 6f 72 6d 20 | 70 61 72 74 20 6f 66 20 |perform |part of |
|00004d40| 63 6f 6d 70 69 6c 61 74 | 69 6f 6e 20 6d 61 79 20 |compilat|ion may |
|00004d50| 73 75 70 70 6f 72 74 20 | 63 72 6f 73 73 2d 63 6f |support |cross-co|
|00004d60| 6d 70 69 6c 61 74 69 6f | 6e 2e 0a 49 6e 20 73 75 |mpilatio|n..In su|
|00004d70| 63 68 20 61 20 63 61 73 | 65 2c 20 74 68 65 20 68 |ch a cas|e, the h|
|00004d80| 6f 73 74 20 61 6e 64 20 | 74 61 72 67 65 74 20 6d |ost and |target m|
|00004d90| 61 63 68 69 6e 65 73 20 | 66 6f 72 20 74 68 65 20 |achines |for the |
|00004da0| 70 72 6f 67 72 61 6d 20 | 6d 61 79 20 62 65 0a 64 |program |may be.d|
|00004db0| 69 66 66 65 72 65 6e 74 | 2e 20 20 54 68 65 20 7b |ifferent|. The {|
|00004dc0| 66 43 6f 64 65 7d 63 6f | 6e 66 69 67 75 72 65 7b |fCode}co|nfigure{|
|00004dd0| 66 7d 20 73 63 72 69 70 | 74 20 73 68 6f 75 6c 64 |f} scrip|t should|
|00004de0| 20 6e 6f 72 6d 61 6c 6c | 79 20 74 72 65 61 74 20 | normall|y treat |
|00004df0| 74 68 65 0a 73 70 65 63 | 69 66 69 65 64 20 74 79 |the.spec|ified ty|
|00004e00| 70 65 20 6f 66 20 73 79 | 73 74 65 6d 20 61 73 20 |pe of sy|stem as |
|00004e10| 62 6f 74 68 20 74 68 65 | 20 68 6f 73 74 20 61 6e |both the| host an|
|00004e20| 64 20 74 68 65 20 74 61 | 72 67 65 74 2c 20 74 68 |d the ta|rget, th|
|00004e30| 75 73 20 70 72 6f 64 75 | 63 69 6e 67 0a 61 20 70 |us produ|cing.a p|
|00004e40| 72 6f 67 72 61 6d 20 77 | 68 69 63 68 20 77 6f 72 |rogram w|hich wor|
|00004e50| 6b 73 20 66 6f 72 20 74 | 68 65 20 73 61 6d 65 20 |ks for t|he same |
|00004e60| 74 79 70 65 20 6f 66 20 | 6d 61 63 68 69 6e 65 20 |type of |machine |
|00004e70| 74 68 61 74 20 69 74 20 | 72 75 6e 73 20 6f 6e 2e |that it |runs on.|
|00004e80| 0a 0a 54 68 65 20 77 61 | 79 20 74 6f 20 62 75 69 |..The wa|y to bui|
|00004e90| 6c 64 20 61 20 63 72 6f | 73 73 2d 63 6f 6d 70 69 |ld a cro|ss-compi|
|00004ea0| 6c 65 72 2c 20 63 72 6f | 73 73 2d 61 73 73 65 6d |ler, cro|ss-assem|
|00004eb0| 62 6c 65 72 2c 20 6f 72 | 20 77 68 61 74 20 68 61 |bler, or| what ha|
|00004ec0| 76 65 20 79 6f 75 2c 20 | 69 73 0a 74 6f 20 73 70 |ve you, |is.to sp|
|00004ed0| 65 63 69 66 79 20 74 68 | 65 20 6f 70 74 69 6f 6e |ecify th|e option|
|00004ee0| 20 7b 66 45 6d 70 68 61 | 73 69 73 7d 2d 2d 68 6f | {fEmpha|sis}--ho|
|00004ef0| 73 74 3d 7b 66 53 74 72 | 6f 6e 67 7d 68 6f 73 74 |st={fStr|ong}host|
|00004f00| 74 79 70 65 7b 66 7d 7b | 66 7d 20 77 68 65 6e 20 |type{f}{|f} when |
|00004f10| 72 75 6e 6e 69 6e 67 0a | 7b 66 43 6f 64 65 7d 63 |running.|{fCode}c|
|00004f20| 6f 6e 66 69 67 75 72 65 | 7b 66 7d 2e 20 20 54 68 |onfigure|{f}. Th|
|00004f30| 69 73 20 73 70 65 63 69 | 66 69 65 73 20 74 68 65 |is speci|fies the|
|00004f40| 20 68 6f 73 74 20 73 79 | 73 74 65 6d 20 77 69 74 | host sy|stem wit|
|00004f50| 68 6f 75 74 20 63 68 61 | 6e 67 69 6e 67 20 74 68 |hout cha|nging th|
|00004f60| 65 0a 74 79 70 65 20 6f | 66 20 74 61 72 67 65 74 |e.type o|f target|
|00004f70| 20 73 79 73 74 65 6d 2e | 20 20 54 68 65 20 73 79 | system.| The sy|
|00004f80| 6e 74 61 78 20 66 6f 72 | 20 7b 66 53 74 72 6f 6e |ntax for| {fStron|
|00004f90| 67 7d 68 6f 73 74 74 79 | 70 65 7b 66 7d 20 69 73 |g}hostty|pe{f} is|
|00004fa0| 20 74 68 65 20 73 61 6d | 65 20 61 73 0a 64 65 73 | the sam|e as.des|
|00004fb0| 63 72 69 62 65 64 20 61 | 62 6f 76 65 2e 0a 0a 42 |cribed a|bove...B|
|00004fc0| 6f 6f 74 73 74 72 61 70 | 70 69 6e 67 20 61 20 63 |ootstrap|ping a c|
|00004fd0| 72 6f 73 73 2d 63 6f 6d | 70 69 6c 65 72 20 72 65 |ross-com|piler re|
|00004fe0| 71 75 69 72 65 73 20 63 | 6f 6d 70 69 6c 69 6e 67 |quires c|ompiling|
|00004ff0| 20 69 74 20 6f 6e 20 61 | 20 6d 61 63 68 69 6e 65 | it on a| machine|
|00005000| 20 6f 74 68 65 72 0a 74 | 68 61 6e 20 74 68 65 20 | other.t|han the |
|00005010| 68 6f 73 74 20 69 74 20 | 77 69 6c 6c 20 72 75 6e |host it |will run|
|00005020| 20 6f 6e 2e 20 20 43 6f | 6d 70 69 6c 61 74 69 6f | on. Co|mpilatio|
|00005030| 6e 20 70 61 63 6b 61 67 | 65 73 20 61 63 63 65 70 |n packag|es accep|
|00005040| 74 20 61 0a 63 6f 6e 66 | 69 67 75 72 61 74 69 6f |t a.conf|iguratio|
|00005050| 6e 20 6f 70 74 69 6f 6e | 20 7b 66 45 6d 70 68 61 |n option| {fEmpha|
|00005060| 73 69 73 7d 2d 2d 62 75 | 69 6c 64 3d 7b 66 53 74 |sis}--bu|ild={fSt|
|00005070| 72 6f 6e 67 7d 68 6f 73 | 74 74 79 70 65 7b 66 7d |rong}hos|ttype{f}|
|00005080| 7b 66 7d 20 66 6f 72 20 | 73 70 65 63 69 66 79 69 |{f} for |specifyi|
|00005090| 6e 67 20 74 68 65 0a 63 | 6f 6e 66 69 67 75 72 61 |ng the.c|onfigura|
|000050a0| 74 69 6f 6e 20 6f 6e 20 | 77 68 69 63 68 20 79 6f |tion on |which yo|
|000050b0| 75 20 77 69 6c 6c 20 63 | 6f 6d 70 69 6c 65 20 74 |u will c|ompile t|
|000050c0| 68 65 6d 2c 20 69 6e 20 | 63 61 73 65 20 74 68 61 |hem, in |case tha|
|000050d0| 74 20 69 73 20 64 69 66 | 66 65 72 65 6e 74 0a 66 |t is dif|ferent.f|
|000050e0| 72 6f 6d 20 74 68 65 20 | 68 6f 73 74 2e 0a 0a 50 |rom the |host...P|
|000050f0| 72 6f 67 72 61 6d 73 20 | 66 6f 72 20 77 68 69 63 |rograms |for whic|
|00005100| 68 20 63 72 6f 73 73 2d | 6f 70 65 72 61 74 69 6f |h cross-|operatio|
|00005110| 6e 20 69 73 20 6e 6f 74 | 20 6d 65 61 6e 69 6e 67 |n is not| meaning|
|00005120| 66 75 6c 20 6e 65 65 64 | 20 6e 6f 74 20 61 63 63 |ful need| not acc|
|00005130| 65 70 74 20 74 68 65 0a | 7b 66 45 6d 70 68 61 73 |ept the.|{fEmphas|
|00005140| 69 73 7d 2d 2d 68 6f 73 | 74 7b 66 7d 20 6f 70 74 |is}--hos|t{f} opt|
|00005150| 69 6f 6e 2c 20 62 65 63 | 61 75 73 65 20 63 6f 6e |ion, bec|ause con|
|00005160| 66 69 67 75 72 69 6e 67 | 20 61 6e 20 65 6e 74 69 |figuring| an enti|
|00005170| 72 65 20 6f 70 65 72 61 | 74 69 6e 67 20 73 79 73 |re opera|ting sys|
|00005180| 74 65 6d 20 66 6f 72 0a | 63 72 6f 73 73 2d 6f 70 |tem for.|cross-op|
|00005190| 65 72 61 74 69 6f 6e 20 | 69 73 20 6e 6f 74 20 61 |eration |is not a|
|000051a0| 20 6d 65 61 6e 69 6e 67 | 66 75 6c 20 74 68 69 6e | meaning|ful thin|
|000051b0| 67 2e 0a 0a 53 6f 6d 65 | 20 70 72 6f 67 72 61 6d |g...Some| program|
|000051c0| 73 20 68 61 76 65 20 77 | 61 79 73 20 6f 66 20 63 |s have w|ays of c|
|000051d0| 6f 6e 66 69 67 75 72 69 | 6e 67 20 74 68 65 6d 73 |onfiguri|ng thems|
|000051e0| 65 6c 76 65 73 20 61 75 | 74 6f 6d 61 74 69 63 61 |elves au|tomatica|
|000051f0| 6c 6c 79 2e 20 20 49 66 | 0a 79 6f 75 72 20 70 72 |lly. If|.your pr|
|00005200| 6f 67 72 61 6d 20 69 73 | 20 73 65 74 20 75 70 20 |ogram is| set up |
|00005210| 74 6f 20 64 6f 20 74 68 | 69 73 2c 20 79 6f 75 72 |to do th|is, your|
|00005220| 20 7b 66 43 6f 64 65 7d | 63 6f 6e 66 69 67 75 72 | {fCode}|configur|
|00005230| 65 7b 66 7d 20 73 63 72 | 69 70 74 20 63 61 6e 20 |e{f} scr|ipt can |
|00005240| 73 69 6d 70 6c 79 0a 69 | 67 6e 6f 72 65 20 6d 6f |simply.i|gnore mo|
|00005250| 73 74 20 6f 66 20 69 74 | 73 20 61 72 67 75 6d 65 |st of it|s argume|
|00005260| 6e 74 73 2e 0a 0a 0a 00 | 44 41 54 41 43 06 00 00 |nts.....|DATAC...|
|00005270| 43 6f 6e 74 72 69 62 75 | 74 69 6f 6e 73 0a 50 72 |Contribu|tions.Pr|
|00005280| 65 76 69 6f 75 73 3a 20 | 3c 52 65 61 64 69 6e 67 |evious: |<Reading|
|00005290| 20 4e 6f 6e 2d 46 72 65 | 65 20 43 6f 64 65 3d 3e | Non-Fre|e Code=>|
|000052a0| 52 65 61 64 69 6e 67 4e | 6f 6e 3e 20 2a 20 4e 65 |ReadingN|on> * Ne|
|000052b0| 78 74 3a 20 3c 43 68 61 | 6e 67 65 20 4c 6f 67 73 |xt: <Cha|nge Logs|
|000052c0| 3d 3e 43 68 61 6e 67 65 | 4c 6f 67 73 3e 20 2a 20 |=>Change|Logs> * |
|000052d0| 55 70 3a 20 3c 54 6f 70 | 3d 3e 21 52 6f 6f 74 3e |Up: <Top|=>!Root>|
|000052e0| 0a 0a 23 57 72 61 70 20 | 6f 6e 0a 7b 66 48 32 7d |..#Wrap |on.{fH2}|
|000052f0| 41 63 63 65 70 74 69 6e | 67 20 43 6f 6e 74 72 69 |Acceptin|g Contri|
|00005300| 62 75 74 69 6f 6e 73 7b | 66 7d 0a 0a 49 66 20 73 |butions{|f}..If s|
|00005310| 6f 6d 65 6f 6e 65 20 65 | 6c 73 65 20 73 65 6e 64 |omeone e|lse send|
|00005320| 73 20 79 6f 75 20 61 20 | 70 69 65 63 65 20 6f 66 |s you a |piece of|
|00005330| 20 63 6f 64 65 20 74 6f | 20 61 64 64 20 74 6f 20 | code to| add to |
|00005340| 74 68 65 20 70 72 6f 67 | 72 61 6d 20 79 6f 75 20 |the prog|ram you |
|00005350| 61 72 65 0a 77 6f 72 6b | 69 6e 67 20 6f 6e 2c 20 |are.work|ing on, |
|00005360| 77 65 20 6e 65 65 64 20 | 6c 65 67 61 6c 20 70 61 |we need |legal pa|
|00005370| 70 65 72 73 20 74 6f 20 | 75 73 65 20 69 74 2d 2d |pers to |use it--|
|00005380| 2d 74 68 65 20 73 61 6d | 65 20 73 6f 72 74 20 6f |-the sam|e sort o|
|00005390| 66 20 6c 65 67 61 6c 0a | 70 61 70 65 72 73 20 77 |f legal.|papers w|
|000053a0| 65 20 77 69 6c 6c 20 6e | 65 65 64 20 74 6f 20 67 |e will n|eed to g|
|000053b0| 65 74 20 66 72 6f 6d 20 | 79 6f 75 2e 20 20 7b 66 |et from |you. {f|
|000053c0| 45 6d 70 68 61 73 69 73 | 7d 45 61 63 68 7b 66 7d |Emphasis|}Each{f}|
|000053d0| 20 73 69 67 6e 69 66 69 | 63 61 6e 74 0a 63 6f 6e | signifi|cant.con|
|000053e0| 74 72 69 62 75 74 6f 72 | 20 74 6f 20 61 20 70 72 |tributor| to a pr|
|000053f0| 6f 67 72 61 6d 20 6d 75 | 73 74 20 73 69 67 6e 20 |ogram mu|st sign |
|00005400| 73 6f 6d 65 20 73 6f 72 | 74 20 6f 66 20 6c 65 67 |some sor|t of leg|
|00005410| 61 6c 20 70 61 70 65 72 | 73 20 69 6e 20 6f 72 64 |al paper|s in ord|
|00005420| 65 72 0a 66 6f 72 20 75 | 73 20 74 6f 20 68 61 76 |er.for u|s to hav|
|00005430| 65 20 63 6c 65 61 72 20 | 74 69 74 6c 65 20 74 6f |e clear |title to|
|00005440| 20 74 68 65 20 70 72 6f | 67 72 61 6d 2e 20 20 54 | the pro|gram. T|
|00005450| 68 65 20 6d 61 69 6e 20 | 61 75 74 68 6f 72 20 61 |he main |author a|
|00005460| 6c 6f 6e 65 20 69 73 20 | 6e 6f 74 0a 65 6e 6f 75 |lone is |not.enou|
|00005470| 67 68 2e 0a 0a 53 6f 2c | 20 62 65 66 6f 72 65 20 |gh...So,| before |
|00005480| 61 64 64 69 6e 67 20 69 | 6e 20 61 6e 79 20 63 6f |adding i|n any co|
|00005490| 6e 74 72 69 62 75 74 69 | 6f 6e 73 20 66 72 6f 6d |ntributi|ons from|
|000054a0| 20 6f 74 68 65 72 20 70 | 65 6f 70 6c 65 2c 20 74 | other p|eople, t|
|000054b0| 65 6c 6c 20 75 73 0a 73 | 6f 20 77 65 20 63 61 6e |ell us.s|o we can|
|000054c0| 20 61 72 72 61 6e 67 65 | 20 74 6f 20 67 65 74 20 | arrange| to get |
|000054d0| 74 68 65 20 70 61 70 65 | 72 73 2e 20 20 54 68 65 |the pape|rs. The|
|000054e0| 6e 20 77 61 69 74 20 75 | 6e 74 69 6c 20 77 65 20 |n wait u|ntil we |
|000054f0| 74 65 6c 6c 20 79 6f 75 | 0a 74 68 61 74 20 77 65 |tell you|.that we|
|00005500| 20 68 61 76 65 20 72 65 | 63 65 69 76 65 64 20 74 | have re|ceived t|
|00005510| 68 65 20 73 69 67 6e 65 | 64 20 70 61 70 65 72 73 |he signe|d papers|
|00005520| 2c 20 62 65 66 6f 72 65 | 20 79 6f 75 20 61 63 74 |, before| you act|
|00005530| 75 61 6c 6c 79 20 75 73 | 65 20 74 68 65 0a 63 6f |ually us|e the.co|
|00005540| 6e 74 72 69 62 75 74 69 | 6f 6e 2e 0a 0a 54 68 69 |ntributi|on...Thi|
|00005550| 73 20 61 70 70 6c 69 65 | 73 20 62 6f 74 68 20 62 |s applie|s both b|
|00005560| 65 66 6f 72 65 20 79 6f | 75 20 72 65 6c 65 61 73 |efore yo|u releas|
|00005570| 65 20 74 68 65 20 70 72 | 6f 67 72 61 6d 20 61 6e |e the pr|ogram an|
|00005580| 64 20 61 66 74 65 72 77 | 61 72 64 2e 20 20 49 66 |d afterw|ard. If|
|00005590| 0a 79 6f 75 20 72 65 63 | 65 69 76 65 20 64 69 66 |.you rec|eive dif|
|000055a0| 66 73 20 74 6f 20 66 69 | 78 20 61 20 62 75 67 2c |fs to fi|x a bug,|
|000055b0| 20 61 6e 64 20 74 68 65 | 79 20 6d 61 6b 65 20 73 | and the|y make s|
|000055c0| 69 67 6e 69 66 69 63 61 | 6e 74 20 63 68 61 6e 67 |ignifica|nt chang|
|000055d0| 65 2c 20 77 65 0a 6e 65 | 65 64 20 6c 65 67 61 6c |e, we.ne|ed legal|
|000055e0| 20 70 61 70 65 72 73 20 | 66 6f 72 20 69 74 2e 0a | papers |for it..|
|000055f0| 0a 59 6f 75 20 64 6f 6e | 27 74 20 6e 65 65 64 20 |.You don|'t need |
|00005600| 70 61 70 65 72 73 20 66 | 6f 72 20 63 68 61 6e 67 |papers f|or chang|
|00005610| 65 73 20 6f 66 20 61 20 | 66 65 77 20 6c 69 6e 65 |es of a |few line|
|00005620| 73 20 68 65 72 65 20 6f | 72 20 74 68 65 72 65 2c |s here o|r there,|
|00005630| 20 73 69 6e 63 65 0a 74 | 68 65 79 20 61 72 65 20 | since.t|hey are |
|00005640| 6e 6f 74 20 73 69 67 6e | 69 66 69 63 61 6e 74 20 |not sign|ificant |
|00005650| 66 6f 72 20 63 6f 70 79 | 72 69 67 68 74 20 70 75 |for copy|right pu|
|00005660| 72 70 6f 73 65 73 2e 20 | 20 41 6c 73 6f 2c 20 79 |rposes. | Also, y|
|00005670| 6f 75 20 64 6f 6e 27 74 | 20 6e 65 65 64 0a 70 61 |ou don't| need.pa|
|00005680| 70 65 72 73 20 69 66 20 | 61 6c 6c 20 79 6f 75 20 |pers if |all you |
|00005690| 67 65 74 20 66 72 6f 6d | 20 74 68 65 20 73 75 67 |get from| the sug|
|000056a0| 67 65 73 74 69 6f 6e 20 | 69 73 20 73 6f 6d 65 20 |gestion |is some |
|000056b0| 69 64 65 61 73 2c 20 6e | 6f 74 20 61 63 74 75 61 |ideas, n|ot actua|
|000056c0| 6c 20 63 6f 64 65 0a 77 | 68 69 63 68 20 79 6f 75 |l code.w|hich you|
|000056d0| 20 75 73 65 2e 20 20 46 | 6f 72 20 65 78 61 6d 70 | use. F|or examp|
|000056e0| 6c 65 2c 20 69 66 20 79 | 6f 75 20 77 72 69 74 65 |le, if y|ou write|
|000056f0| 20 61 20 64 69 66 66 65 | 72 65 6e 74 20 73 6f 6c | a diffe|rent sol|
|00005700| 75 74 69 6f 6e 20 74 6f | 20 74 68 65 0a 70 72 6f |ution to| the.pro|
|00005710| 62 6c 65 6d 2c 20 79 6f | 75 20 64 6f 6e 27 74 20 |blem, yo|u don't |
|00005720| 6e 65 65 64 20 74 6f 20 | 67 65 74 20 70 61 70 65 |need to |get pape|
|00005730| 72 73 2e 0a 0a 49 20 6b | 6e 6f 77 20 74 68 69 73 |rs...I k|now this|
|00005740| 20 69 73 20 66 72 75 73 | 74 72 61 74 69 6e 67 3b | is frus|trating;|
|00005750| 20 69 74 27 73 20 66 72 | 75 73 74 72 61 74 69 6e | it's fr|ustratin|
|00005760| 67 20 66 6f 72 20 75 73 | 20 61 73 20 77 65 6c 6c |g for us| as well|
|00005770| 2e 20 20 42 75 74 20 69 | 66 0a 79 6f 75 20 64 6f |. But i|f.you do|
|00005780| 6e 27 74 20 77 61 69 74 | 2c 20 79 6f 75 20 61 72 |n't wait|, you ar|
|00005790| 65 20 67 6f 69 6e 67 20 | 6f 75 74 20 6f 6e 20 61 |e going |out on a|
|000057a0| 20 6c 69 6d 62 2d 2d 2d | 66 6f 72 20 65 78 61 6d | limb---|for exam|
|000057b0| 70 6c 65 2c 20 77 68 61 | 74 20 69 66 20 74 68 65 |ple, wha|t if the|
|000057c0| 0a 63 6f 6e 74 72 69 62 | 75 74 6f 72 27 73 20 65 |.contrib|utor's e|
|000057d0| 6d 70 6c 6f 79 65 72 20 | 77 6f 6e 27 74 20 73 69 |mployer |won't si|
|000057e0| 67 6e 20 61 20 64 69 73 | 63 6c 61 69 6d 65 72 3f |gn a dis|claimer?|
|000057f0| 20 20 59 6f 75 20 6d 69 | 67 68 74 20 68 61 76 65 | You mi|ght have|
|00005800| 20 74 6f 20 74 61 6b 65 | 0a 74 68 61 74 20 63 6f | to take|.that co|
|00005810| 64 65 20 6f 75 74 20 61 | 67 61 69 6e 21 0a 0a 54 |de out a|gain!..T|
|00005820| 68 65 20 76 65 72 79 20 | 77 6f 72 73 74 20 74 68 |he very |worst th|
|00005830| 69 6e 67 20 69 73 20 69 | 66 20 79 6f 75 20 66 6f |ing is i|f you fo|
|00005840| 72 67 65 74 20 74 6f 20 | 74 65 6c 6c 20 75 73 20 |rget to |tell us |
|00005850| 61 62 6f 75 74 20 74 68 | 65 20 6f 74 68 65 72 0a |about th|e other.|
|00005860| 63 6f 6e 74 72 69 62 75 | 74 6f 72 2e 20 20 57 65 |contribu|tor. We|
|00005870| 20 63 6f 75 6c 64 20 62 | 65 20 76 65 72 79 20 65 | could b|e very e|
|00005880| 6d 62 61 72 72 61 73 73 | 65 64 20 69 6e 20 63 6f |mbarrass|ed in co|
|00005890| 75 72 74 20 73 6f 6d 65 | 20 64 61 79 20 61 73 20 |urt some| day as |
|000058a0| 61 0a 72 65 73 75 6c 74 | 2e 0a 0a 00 44 41 54 41 |a.result|....DATA|
|000058b0| 83 1b 00 00 44 69 72 65 | 63 74 6f 72 79 20 56 61 |....Dire|ctory Va|
|000058c0| 72 69 61 62 6c 65 73 0a | 50 72 65 76 69 6f 75 73 |riables.|Previous|
|000058d0| 3a 20 3c 43 6f 6d 6d 61 | 6e 64 20 56 61 72 69 61 |: <Comma|nd Varia|
|000058e0| 62 6c 65 73 3d 3e 43 6f | 6d 6d 61 6e 64 56 61 72 |bles=>Co|mmandVar|
|000058f0| 3e 20 2a 20 4e 65 78 74 | 3a 20 3c 43 6f 6e 66 69 |> * Next|: <Confi|
|00005900| 67 75 72 61 74 69 6f 6e | 3d 3e 43 6f 6e 66 69 67 |guration|=>Config|
|00005910| 75 72 61 74 3e 20 2a 20 | 55 70 3a 20 3c 4d 61 6b |urat> * |Up: <Mak|
|00005920| 65 66 69 6c 65 20 43 6f | 6e 76 65 6e 74 69 6f 6e |efile Co|nvention|
|00005930| 73 3d 3e 4d 61 6b 65 66 | 69 6c 65 43 6f 3e 0a 0a |s=>Makef|ileCo>..|
|00005940| 23 57 72 61 70 20 6f 6e | 0a 7b 66 48 33 7d 56 61 |#Wrap on|.{fH3}Va|
|00005950| 72 69 61 62 6c 65 73 20 | 66 6f 72 20 49 6e 73 74 |riables |for Inst|
|00005960| 61 6c 6c 61 74 69 6f 6e | 20 44 69 72 65 63 74 6f |allation| Directo|
|00005970| 72 69 65 73 7b 66 7d 0a | 0a 49 6e 73 74 61 6c 6c |ries{f}.|.Install|
|00005980| 61 74 69 6f 6e 20 64 69 | 72 65 63 74 6f 72 69 65 |ation di|rectorie|
|00005990| 73 20 73 68 6f 75 6c 64 | 20 61 6c 77 61 79 73 20 |s should| always |
|000059a0| 62 65 20 6e 61 6d 65 64 | 20 62 79 20 76 61 72 69 |be named| by vari|
|000059b0| 61 62 6c 65 73 2c 20 73 | 6f 20 69 74 20 69 73 0a |ables, s|o it is.|
|000059c0| 65 61 73 79 20 74 6f 20 | 69 6e 73 74 61 6c 6c 20 |easy to |install |
|000059d0| 69 6e 20 61 20 6e 6f 6e | 73 74 61 6e 64 61 72 64 |in a non|standard|
|000059e0| 20 70 6c 61 63 65 2e 20 | 20 54 68 65 20 73 74 61 | place. | The sta|
|000059f0| 6e 64 61 72 64 20 6e 61 | 6d 65 73 20 66 6f 72 20 |ndard na|mes for |
|00005a00| 74 68 65 73 65 0a 76 61 | 72 69 61 62 6c 65 73 20 |these.va|riables |
|00005a10| 61 72 65 3a 0a 0a 23 49 | 6e 64 65 6e 74 20 2b 34 |are:..#I|ndent +4|
|00005a20| 0a 23 49 6e 64 65 6e 74 | 0a 7b 66 45 6d 70 68 61 |.#Indent|.{fEmpha|
|00005a30| 73 69 73 7d 70 72 65 66 | 69 78 7b 66 7d 0a 23 49 |sis}pref|ix{f}.#I|
|00005a40| 6e 64 65 6e 74 20 2b 34 | 0a 41 20 70 72 65 66 69 |ndent +4|.A prefi|
|00005a50| 78 20 75 73 65 64 20 69 | 6e 20 63 6f 6e 73 74 72 |x used i|n constr|
|00005a60| 75 63 74 69 6e 67 20 74 | 68 65 20 64 65 66 61 75 |ucting t|he defau|
|00005a70| 6c 74 20 76 61 6c 75 65 | 73 20 6f 66 20 74 68 65 |lt value|s of the|
|00005a80| 20 76 61 72 69 61 62 6c | 65 73 20 6c 69 73 74 65 | variabl|es liste|
|00005a90| 64 0a 62 65 6c 6f 77 2e | 20 20 54 68 65 20 64 65 |d.below.| The de|
|00005aa0| 66 61 75 6c 74 20 76 61 | 6c 75 65 20 6f 66 20 7b |fault va|lue of {|
|00005ab0| 66 43 6f 64 65 7d 70 72 | 65 66 69 78 7b 66 7d 20 |fCode}pr|efix{f} |
|00005ac0| 73 68 6f 75 6c 64 20 62 | 65 20 7b 66 43 69 74 65 |should b|e {fCite|
|00005ad0| 7d 5c 2f 75 73 72 5c 2f | 6c 6f 63 61 6c 7b 66 7d |}\/usr\/|local{f}|
|00005ae0| 0a 28 61 74 20 6c 65 61 | 73 74 20 66 6f 72 20 6e |.(at lea|st for n|
|00005af0| 6f 77 29 2e 0a 0a 23 49 | 6e 64 65 6e 74 0a 7b 66 |ow)...#I|ndent.{f|
|00005b00| 45 6d 70 68 61 73 69 73 | 7d 65 78 65 63 5c 5f 70 |Emphasis|}exec\_p|
|00005b10| 72 65 66 69 78 7b 66 7d | 0a 23 49 6e 64 65 6e 74 |refix{f}|.#Indent|
|00005b20| 20 2b 34 0a 41 20 70 72 | 65 66 69 78 20 75 73 65 | +4.A pr|efix use|
|00005b30| 64 20 69 6e 20 63 6f 6e | 73 74 72 75 63 74 69 6e |d in con|structin|
|00005b40| 67 20 74 68 65 20 64 65 | 66 61 75 6c 74 20 76 61 |g the de|fault va|
|00005b50| 6c 75 65 73 20 6f 66 20 | 73 6f 6d 65 20 6f 66 20 |lues of |some of |
|00005b60| 74 68 65 0a 76 61 72 69 | 61 62 6c 65 73 20 6c 69 |the.vari|ables li|
|00005b70| 73 74 65 64 20 62 65 6c | 6f 77 2e 20 20 54 68 65 |sted bel|ow. The|
|00005b80| 20 64 65 66 61 75 6c 74 | 20 76 61 6c 75 65 20 6f | default| value o|
|00005b90| 66 20 7b 66 43 6f 64 65 | 7d 65 78 65 63 5c 5f 70 |f {fCode|}exec\_p|
|00005ba0| 72 65 66 69 78 7b 66 7d | 20 73 68 6f 75 6c 64 0a |refix{f}| should.|
|00005bb0| 62 65 20 7b 66 43 6f 64 | 65 7d 24 28 70 72 65 66 |be {fCod|e}$(pref|
|00005bc0| 69 78 29 7b 66 7d 2e 0a | 0a 47 65 6e 65 72 61 6c |ix){f}..|.General|
|00005bd0| 6c 79 2c 20 7b 66 43 6f | 64 65 7d 24 28 65 78 65 |ly, {fCo|de}$(exe|
|00005be0| 63 5c 5f 70 72 65 66 69 | 78 29 7b 66 7d 20 69 73 |c\_prefi|x){f} is|
|00005bf0| 20 75 73 65 64 20 66 6f | 72 20 64 69 72 65 63 74 | used fo|r direct|
|00005c00| 6f 72 69 65 73 20 74 68 | 61 74 20 63 6f 6e 74 61 |ories th|at conta|
|00005c10| 69 6e 0a 6d 61 63 68 69 | 6e 65 2d 73 70 65 63 69 |in.machi|ne-speci|
|00005c20| 66 69 63 20 66 69 6c 65 | 73 20 28 73 75 63 68 20 |fic file|s (such |
|00005c30| 61 73 20 65 78 65 63 75 | 74 61 62 6c 65 73 20 61 |as execu|tables a|
|00005c40| 6e 64 20 73 75 62 72 6f | 75 74 69 6e 65 20 6c 69 |nd subro|utine li|
|00005c50| 62 72 61 72 69 65 73 29 | 2c 0a 77 68 69 6c 65 20 |braries)|,.while |
|00005c60| 7b 66 43 6f 64 65 7d 24 | 28 70 72 65 66 69 78 29 |{fCode}$|(prefix)|
|00005c70| 7b 66 7d 20 69 73 20 75 | 73 65 64 20 64 69 72 65 |{f} is u|sed dire|
|00005c80| 63 74 6c 79 20 66 6f 72 | 20 6f 74 68 65 72 20 64 |ctly for| other d|
|00005c90| 69 72 65 63 74 6f 72 69 | 65 73 2e 0a 0a 23 49 6e |irectori|es...#In|
|00005ca0| 64 65 6e 74 0a 7b 66 45 | 6d 70 68 61 73 69 73 7d |dent.{fE|mphasis}|
|00005cb0| 62 69 6e 64 69 72 7b 66 | 7d 0a 23 49 6e 64 65 6e |bindir{f|}.#Inden|
|00005cc0| 74 20 2b 34 0a 54 68 65 | 20 64 69 72 65 63 74 6f |t +4.The| directo|
|00005cd0| 72 79 20 66 6f 72 20 69 | 6e 73 74 61 6c 6c 69 6e |ry for i|nstallin|
|00005ce0| 67 20 65 78 65 63 75 74 | 61 62 6c 65 20 70 72 6f |g execut|able pro|
|00005cf0| 67 72 61 6d 73 20 74 68 | 61 74 20 75 73 65 72 73 |grams th|at users|
|00005d00| 20 63 61 6e 20 72 75 6e | 2e 0a 54 68 69 73 20 73 | can run|..This s|
|00005d10| 68 6f 75 6c 64 20 6e 6f | 72 6d 61 6c 6c 79 20 62 |hould no|rmally b|
|00005d20| 65 20 7b 66 43 69 74 65 | 7d 5c 2f 75 73 72 5c 2f |e {fCite|}\/usr\/|
|00005d30| 6c 6f 63 61 6c 5c 2f 62 | 69 6e 7b 66 7d 2c 20 62 |local\/b|in{f}, b|
|00005d40| 75 74 20 77 72 69 74 65 | 20 69 74 20 61 73 0a 7b |ut write| it as.{|
|00005d50| 66 43 69 74 65 7d 24 28 | 65 78 65 63 5c 5f 70 72 |fCite}$(|exec\_pr|
|00005d60| 65 66 69 78 29 5c 2f 62 | 69 6e 7b 66 7d 2e 0a 0a |efix)\/b|in{f}...|
|00005d70| 23 49 6e 64 65 6e 74 0a | 7b 66 45 6d 70 68 61 73 |#Indent.|{fEmphas|
|00005d80| 69 73 7d 6c 69 62 64 69 | 72 7b 66 7d 0a 23 49 6e |is}libdi|r{f}.#In|
|00005d90| 64 65 6e 74 20 2b 34 0a | 54 68 65 20 64 69 72 65 |dent +4.|The dire|
|00005da0| 63 74 6f 72 79 20 66 6f | 72 20 69 6e 73 74 61 6c |ctory fo|r instal|
|00005db0| 6c 69 6e 67 20 65 78 65 | 63 75 74 61 62 6c 65 20 |ling exe|cutable |
|00005dc0| 66 69 6c 65 73 20 74 6f | 20 62 65 20 72 75 6e 20 |files to| be run |
|00005dd0| 62 79 20 74 68 65 20 70 | 72 6f 67 72 61 6d 0a 72 |by the p|rogram.r|
|00005de0| 61 74 68 65 72 20 74 68 | 61 6e 20 62 79 20 75 73 |ather th|an by us|
|00005df0| 65 72 73 2e 20 20 4f 62 | 6a 65 63 74 20 66 69 6c |ers. Ob|ject fil|
|00005e00| 65 73 20 61 6e 64 20 6c | 69 62 72 61 72 69 65 73 |es and l|ibraries|
|00005e10| 20 6f 66 20 6f 62 6a 65 | 63 74 20 63 6f 64 65 20 | of obje|ct code |
|00005e20| 73 68 6f 75 6c 64 0a 61 | 6c 73 6f 20 67 6f 20 69 |should.a|lso go i|
|00005e30| 6e 20 74 68 69 73 20 64 | 69 72 65 63 74 6f 72 79 |n this d|irectory|
|00005e40| 2e 20 20 54 68 65 20 69 | 64 65 61 20 69 73 20 74 |. The i|dea is t|
|00005e50| 68 61 74 20 74 68 69 73 | 20 64 69 72 65 63 74 6f |hat this| directo|
|00005e60| 72 79 20 69 73 20 75 73 | 65 64 20 66 6f 72 0a 66 |ry is us|ed for.f|
|00005e70| 69 6c 65 73 20 74 68 61 | 74 20 70 65 72 74 61 69 |iles tha|t pertai|
|00005e80| 6e 20 74 6f 20 61 20 73 | 70 65 63 69 66 69 63 20 |n to a s|pecific |
|00005e90| 6d 61 63 68 69 6e 65 20 | 61 72 63 68 69 74 65 63 |machine |architec|
|00005ea0| 74 75 72 65 2c 20 62 75 | 74 20 6e 65 65 64 20 6e |ture, bu|t need n|
|00005eb0| 6f 74 20 62 65 0a 69 6e | 20 74 68 65 20 70 61 74 |ot be.in| the pat|
|00005ec0| 68 20 66 6f 72 20 63 6f | 6d 6d 61 6e 64 73 2e 20 |h for co|mmands. |
|00005ed0| 20 54 68 65 20 76 61 6c | 75 65 20 6f 66 20 7b 66 | The val|ue of {f|
|00005ee0| 43 6f 64 65 7d 6c 69 62 | 64 69 72 7b 66 7d 20 73 |Code}lib|dir{f} s|
|00005ef0| 68 6f 75 6c 64 20 6e 6f | 72 6d 61 6c 6c 79 20 62 |hould no|rmally b|
|00005f00| 65 0a 7b 66 43 69 74 65 | 7d 5c 2f 75 73 72 5c 2f |e.{fCite|}\/usr\/|
|00005f10| 6c 6f 63 61 6c 5c 2f 6c | 69 62 7b 66 7d 2c 20 62 |local\/l|ib{f}, b|
|00005f20| 75 74 20 77 72 69 74 65 | 20 69 74 20 61 73 20 7b |ut write| it as {|
|00005f30| 66 43 69 74 65 7d 24 28 | 65 78 65 63 5c 5f 70 72 |fCite}$(|exec\_pr|
|00005f40| 65 66 69 78 29 5c 2f 6c | 69 62 7b 66 7d 2e 0a 0a |efix)\/l|ib{f}...|
|00005f50| 23 49 6e 64 65 6e 74 0a | 7b 66 45 6d 70 68 61 73 |#Indent.|{fEmphas|
|00005f60| 69 73 7d 64 61 74 61 64 | 69 72 7b 66 7d 0a 23 49 |is}datad|ir{f}.#I|
|00005f70| 6e 64 65 6e 74 20 2b 34 | 0a 54 68 65 20 64 69 72 |ndent +4|.The dir|
|00005f80| 65 63 74 6f 72 79 20 66 | 6f 72 20 69 6e 73 74 61 |ectory f|or insta|
|00005f90| 6c 6c 69 6e 67 20 72 65 | 61 64 2d 6f 6e 6c 79 20 |lling re|ad-only |
|00005fa0| 64 61 74 61 20 66 69 6c | 65 73 20 77 68 69 63 68 |data fil|es which|
|00005fb0| 20 74 68 65 20 70 72 6f | 67 72 61 6d 73 0a 72 65 | the pro|grams.re|
|00005fc0| 66 65 72 20 74 6f 20 77 | 68 69 6c 65 20 74 68 65 |fer to w|hile the|
|00005fd0| 79 20 72 75 6e 2e 20 20 | 54 68 69 73 20 64 69 72 |y run. |This dir|
|00005fe0| 65 63 74 6f 72 79 20 69 | 73 20 75 73 65 64 20 66 |ectory i|s used f|
|00005ff0| 6f 72 20 66 69 6c 65 73 | 20 77 68 69 63 68 20 61 |or files| which a|
|00006000| 72 65 0a 69 6e 64 65 70 | 65 6e 64 65 6e 74 20 6f |re.indep|endent o|
|00006010| 66 20 74 68 65 20 74 79 | 70 65 20 6f 66 20 6d 61 |f the ty|pe of ma|
|00006020| 63 68 69 6e 65 20 62 65 | 69 6e 67 20 75 73 65 64 |chine be|ing used|
|00006030| 2e 20 20 54 68 69 73 20 | 73 68 6f 75 6c 64 20 6e |. This |should n|
|00006040| 6f 72 6d 61 6c 6c 79 20 | 62 65 0a 7b 66 43 69 74 |ormally |be.{fCit|
|00006050| 65 7d 5c 2f 75 73 72 5c | 2f 6c 6f 63 61 6c 5c 2f |e}\/usr\|/local\/|
|00006060| 6c 69 62 7b 66 7d 2c 20 | 62 75 74 20 77 72 69 74 |lib{f}, |but writ|
|00006070| 65 20 69 74 20 61 73 20 | 7b 66 43 69 74 65 7d 24 |e it as |{fCite}$|
|00006080| 28 70 72 65 66 69 78 29 | 5c 2f 6c 69 62 7b 66 7d |(prefix)|\/lib{f}|
|00006090| 2e 0a 0a 23 49 6e 64 65 | 6e 74 0a 7b 66 45 6d 70 |...#Inde|nt.{fEmp|
|000060a0| 68 61 73 69 73 7d 73 74 | 61 74 65 64 69 72 7b 66 |hasis}st|atedir{f|
|000060b0| 7d 0a 23 49 6e 64 65 6e | 74 20 2b 34 0a 54 68 65 |}.#Inden|t +4.The|
|000060c0| 20 64 69 72 65 63 74 6f | 72 79 20 66 6f 72 20 69 | directo|ry for i|
|000060d0| 6e 73 74 61 6c 6c 69 6e | 67 20 64 61 74 61 20 66 |nstallin|g data f|
|000060e0| 69 6c 65 73 20 77 68 69 | 63 68 20 74 68 65 20 70 |iles whi|ch the p|
|000060f0| 72 6f 67 72 61 6d 73 20 | 6d 6f 64 69 66 79 20 77 |rograms |modify w|
|00006100| 68 69 6c 65 0a 74 68 65 | 79 20 72 75 6e 2e 20 20 |hile.the|y run. |
|00006110| 54 68 65 73 65 20 66 69 | 6c 65 73 20 73 68 6f 75 |These fi|les shou|
|00006120| 6c 64 20 62 65 20 69 6e | 64 65 70 65 6e 64 65 6e |ld be in|dependen|
|00006130| 74 20 6f 66 20 74 68 65 | 20 74 79 70 65 20 6f 66 |t of the| type of|
|00006140| 20 6d 61 63 68 69 6e 65 | 0a 62 65 69 6e 67 20 75 | machine|.being u|
|00006150| 73 65 64 2c 20 61 6e 64 | 20 69 74 20 73 68 6f 75 |sed, and| it shou|
|00006160| 6c 64 20 62 65 20 70 6f | 73 73 69 62 6c 65 20 74 |ld be po|ssible t|
|00006170| 6f 20 73 68 61 72 65 20 | 74 68 65 6d 20 61 6d 6f |o share |them amo|
|00006180| 6e 67 20 6d 61 63 68 69 | 6e 65 73 20 61 74 20 61 |ng machi|nes at a|
|00006190| 0a 6e 65 74 77 6f 72 6b | 20 69 6e 73 74 61 6c 6c |.network| install|
|000061a0| 61 74 69 6f 6e 2e 20 20 | 54 68 69 73 20 73 68 6f |ation. |This sho|
|000061b0| 75 6c 64 20 6e 6f 72 6d | 61 6c 6c 79 20 62 65 20 |uld norm|ally be |
|000061c0| 7b 66 43 69 74 65 7d 5c | 2f 75 73 72 5c 2f 6c 6f |{fCite}\|/usr\/lo|
|000061d0| 63 61 6c 5c 2f 6c 69 62 | 7b 66 7d 2c 0a 62 75 74 |cal\/lib|{f},.but|
|000061e0| 20 77 72 69 74 65 20 69 | 74 20 61 73 20 7b 66 43 | write i|t as {fC|
|000061f0| 69 74 65 7d 24 28 70 72 | 65 66 69 78 29 5c 2f 6c |ite}$(pr|efix)\/l|
|00006200| 69 62 7b 66 7d 2e 0a 0a | 23 49 6e 64 65 6e 74 0a |ib{f}...|#Indent.|
|00006210| 7b 66 45 6d 70 68 61 73 | 69 73 7d 69 6e 63 6c 75 |{fEmphas|is}inclu|
|00006220| 64 65 64 69 72 7b 66 7d | 0a 23 49 6e 64 65 6e 74 |dedir{f}|.#Indent|
|00006230| 20 2b 34 0a 54 68 65 20 | 64 69 72 65 63 74 6f 72 | +4.The |director|
|00006240| 79 20 66 6f 72 20 69 6e | 73 74 61 6c 6c 69 6e 67 |y for in|stalling|
|00006250| 20 68 65 61 64 65 72 20 | 66 69 6c 65 73 20 74 6f | header |files to|
|00006260| 20 62 65 20 69 6e 63 6c | 75 64 65 64 20 62 79 20 | be incl|uded by |
|00006270| 75 73 65 72 0a 70 72 6f | 67 72 61 6d 73 20 77 69 |user.pro|grams wi|
|00006280| 74 68 20 74 68 65 20 43 | 20 7b 66 45 6d 70 68 61 |th the C| {fEmpha|
|00006290| 73 69 73 7d 5c 23 69 6e | 63 6c 75 64 65 7b 66 7d |sis}\#in|clude{f}|
|000062a0| 20 70 72 65 70 72 6f 63 | 65 73 73 6f 72 20 64 69 | preproc|essor di|
|000062b0| 72 65 63 74 69 76 65 2e | 20 20 54 68 69 73 0a 73 |rective.| This.s|
|000062c0| 68 6f 75 6c 64 20 6e 6f | 72 6d 61 6c 6c 79 20 62 |hould no|rmally b|
|000062d0| 65 20 7b 66 43 69 74 65 | 7d 5c 2f 75 73 72 5c 2f |e {fCite|}\/usr\/|
|000062e0| 6c 6f 63 61 6c 5c 2f 69 | 6e 63 6c 75 64 65 7b 66 |local\/i|nclude{f|
|000062f0| 7d 2c 20 62 75 74 20 77 | 72 69 74 65 20 69 74 20 |}, but w|rite it |
|00006300| 61 73 0a 7b 66 43 69 74 | 65 7d 24 28 70 72 65 66 |as.{fCit|e}$(pref|
|00006310| 69 78 29 5c 2f 69 6e 63 | 6c 75 64 65 7b 66 7d 2e |ix)\/inc|lude{f}.|
|00006320| 0a 0a 4d 6f 73 74 20 63 | 6f 6d 70 69 6c 65 72 73 |..Most c|ompilers|
|00006330| 20 6f 74 68 65 72 20 74 | 68 61 6e 20 47 43 43 20 | other t|han GCC |
|00006340| 64 6f 20 6e 6f 74 20 6c | 6f 6f 6b 20 66 6f 72 20 |do not l|ook for |
|00006350| 68 65 61 64 65 72 20 66 | 69 6c 65 73 20 69 6e 0a |header f|iles in.|
|00006360| 7b 66 43 69 74 65 7d 5c | 2f 75 73 72 5c 2f 6c 6f |{fCite}\|/usr\/lo|
|00006370| 63 61 6c 5c 2f 69 6e 63 | 6c 75 64 65 7b 66 7d 2e |cal\/inc|lude{f}.|
|00006380| 20 20 53 6f 20 69 6e 73 | 74 61 6c 6c 69 6e 67 20 | So ins|talling |
|00006390| 74 68 65 20 68 65 61 64 | 65 72 20 66 69 6c 65 73 |the head|er files|
|000063a0| 20 74 68 69 73 20 77 61 | 79 20 69 73 0a 6f 6e 6c | this wa|y is.onl|
|000063b0| 79 20 75 73 65 66 75 6c | 20 77 69 74 68 20 47 43 |y useful| with GC|
|000063c0| 43 2e 20 20 53 6f 6d 65 | 74 69 6d 65 73 20 74 68 |C. Some|times th|
|000063d0| 69 73 20 69 73 20 6e 6f | 74 20 61 20 70 72 6f 62 |is is no|t a prob|
|000063e0| 6c 65 6d 20 62 65 63 61 | 75 73 65 20 73 6f 6d 65 |lem beca|use some|
|000063f0| 0a 6c 69 62 72 61 72 69 | 65 73 20 61 72 65 20 6f |.librari|es are o|
+--------+-------------------------+-------------------------+--------+--------+
Only 25.0 KB of data is shown above.
