home *** CD-ROM | disk | FTP | other *** search
| Texinfo Document | 1994-10-26 | 40.9 KB |
open in: 
MacOS 8.1
|
Win98
|
DOS
view JSON data
|
view as text
This file was processed as: Texinfo Document
(document/texInfo).
You can browse this item here: FlexCat_english.texinfo
| Confidence | Program | Detection | Match Type | Support
|
|---|
| 100%
| dexvert
| Texinfo Document (document/texInfo)
| magic
| Supported |
| 1%
| dexvert
| Text File (text/txt)
| fallback
| Supported |
| 100%
| file
| TeX document text
| default
| |
| 99%
| file
| Java source, ISO-8859 text
| default
| |
| 100%
| perlTextCheck
| Likely Text (Perl)
| default
| |
| 100%
| siegfried
| x-fmt/111 Plain Text File
| default
| |
| 100%
| detectItEasy
| Format: plain text[LF]
| default (weak)
|
|
hex view+--------+-------------------------+-------------------------+--------+--------+
|00000000| 5c 69 6e 70 75 74 20 61 | 6d 69 67 61 74 65 78 69 |\input a|migatexi|
|00000010| 6e 66 6f 0a 5c 69 6e 70 | 75 74 20 74 65 78 69 6e |nfo.\inp|ut texin|
|00000020| 66 6f 0a 40 63 20 25 2a | 2a 73 74 61 72 74 20 6f |fo.@c %*|*start o|
|00000030| 66 20 68 65 61 64 65 72 | 0a 40 73 65 74 66 69 6c |f header|.@setfil|
|00000040| 65 6e 61 6d 65 20 46 6c | 65 78 43 61 74 5f 65 6e |ename Fl|exCat_en|
|00000050| 67 6c 69 73 68 2e 67 75 | 69 64 65 0a 40 73 65 74 |glish.gu|ide.@set|
|00000060| 74 69 74 6c 65 20 46 6c | 65 78 43 61 74 20 40 76 |title Fl|exCat @v|
|00000070| 61 6c 75 65 7b 56 45 52 | 53 49 4f 4e 7d 20 20 20 |alue{VER|SION} |
|00000080| 20 44 6f 63 75 6d 65 6e | 74 61 74 69 6f 6e 0a 40 | Documen|tation.@|
|00000090| 73 65 74 63 68 61 70 74 | 65 72 6e 65 77 70 61 67 |setchapt|ernewpag|
|000000a0| 65 20 6f 66 66 0a 0a 40 | 63 0a 40 63 20 20 46 6c |e off..@|c.@c Fl|
|000000b0| 65 78 43 61 74 3a 09 09 | 20 20 20 20 54 68 65 20 |exCat:..| The |
|000000c0| 66 6c 65 78 69 62 6c 65 | 20 63 61 74 61 6c 6f 67 |flexible| catalog|
|000000d0| 20 67 65 6e 65 72 61 74 | 6f 72 09 20 20 20 20 56 | generat|or. V|
|000000e0| 31 2e 34 0a 40 63 20 20 | 43 6f 70 79 72 69 67 68 |1.4.@c |Copyrigh|
|000000f0| 74 20 28 43 29 20 20 20 | 31 39 39 33 20 20 20 20 |t (C) |1993 |
|00000100| 4a 6f 63 68 65 6e 20 57 | 69 65 64 6d 61 6e 6e 0a |Jochen W|iedmann.|
|00000110| 40 63 0a 40 63 20 20 54 | 68 69 73 20 70 72 6f 67 |@c.@c T|his prog|
|00000120| 72 61 6d 20 69 73 20 66 | 72 65 65 20 73 6f 66 74 |ram is f|ree soft|
|00000130| 77 61 72 65 3b 20 79 6f | 75 20 63 61 6e 20 72 65 |ware; yo|u can re|
|00000140| 64 69 73 74 72 69 62 75 | 74 65 20 69 74 20 61 6e |distribu|te it an|
|00000150| 64 2f 6f 72 20 6d 6f 64 | 69 66 79 0a 40 63 20 20 |d/or mod|ify.@c |
|00000160| 69 74 20 75 6e 64 65 72 | 20 74 68 65 20 74 65 72 |it under| the ter|
|00000170| 6d 73 20 6f 66 20 74 68 | 65 20 47 4e 55 20 47 65 |ms of th|e GNU Ge|
|00000180| 6e 65 72 61 6c 20 50 75 | 62 6c 69 63 20 4c 69 63 |neral Pu|blic Lic|
|00000190| 65 6e 73 65 20 61 73 20 | 70 75 62 6c 69 73 68 65 |ense as |publishe|
|000001a0| 64 20 62 79 0a 40 63 20 | 20 74 68 65 20 46 72 65 |d by.@c | the Fre|
|000001b0| 65 20 53 6f 66 74 77 61 | 72 65 20 46 6f 75 6e 64 |e Softwa|re Found|
|000001c0| 61 74 69 6f 6e 3b 20 65 | 69 74 68 65 72 20 76 65 |ation; e|ither ve|
|000001d0| 72 73 69 6f 6e 20 32 20 | 6f 66 20 74 68 65 20 4c |rsion 2 |of the L|
|000001e0| 69 63 65 6e 73 65 2c 20 | 6f 72 0a 40 63 20 20 28 |icense, |or.@c (|
|000001f0| 61 74 20 79 6f 75 72 20 | 6f 70 74 69 6f 6e 29 20 |at your |option) |
|00000200| 61 6e 79 20 6c 61 74 65 | 72 20 76 65 72 73 69 6f |any late|r versio|
|00000210| 6e 2e 0a 40 63 0a 40 63 | 20 20 54 68 69 73 20 70 |n..@c.@c| This p|
|00000220| 72 6f 67 72 61 6d 20 69 | 73 20 64 69 73 74 72 69 |rogram i|s distri|
|00000230| 62 75 74 65 64 20 69 6e | 20 74 68 65 20 68 6f 70 |buted in| the hop|
|00000240| 65 20 74 68 61 74 20 69 | 74 20 77 69 6c 6c 20 62 |e that i|t will b|
|00000250| 65 20 75 73 65 66 75 6c | 2c 0a 40 63 20 20 62 75 |e useful|,.@c bu|
|00000260| 74 20 57 49 54 48 4f 55 | 54 20 41 4e 59 20 57 41 |t WITHOU|T ANY WA|
|00000270| 52 52 41 4e 54 59 3b 20 | 77 69 74 68 6f 75 74 20 |RRANTY; |without |
|00000280| 65 76 65 6e 20 74 68 65 | 20 69 6d 70 6c 69 65 64 |even the| implied|
|00000290| 20 77 61 72 72 61 6e 74 | 79 20 6f 66 0a 40 63 20 | warrant|y of.@c |
|000002a0| 20 4d 45 52 43 48 41 4e | 54 41 42 49 4c 49 54 59 | MERCHAN|TABILITY|
|000002b0| 20 6f 72 20 46 49 54 4e | 45 53 53 20 46 4f 52 20 | or FITN|ESS FOR |
|000002c0| 41 20 50 41 52 54 49 43 | 55 4c 41 52 20 50 55 52 |A PARTIC|ULAR PUR|
|000002d0| 50 4f 53 45 2e 20 20 53 | 65 65 20 74 68 65 0a 40 |POSE. S|ee the.@|
|000002e0| 63 20 20 47 4e 55 20 47 | 65 6e 65 72 61 6c 20 50 |c GNU G|eneral P|
|000002f0| 75 62 6c 69 63 20 4c 69 | 63 65 6e 73 65 20 66 6f |ublic Li|cense fo|
|00000300| 72 20 6d 6f 72 65 20 64 | 65 74 61 69 6c 73 2e 0a |r more d|etails..|
|00000310| 40 63 0a 40 63 20 20 59 | 6f 75 20 73 68 6f 75 6c |@c.@c Y|ou shoul|
|00000320| 64 20 68 61 76 65 20 72 | 65 63 65 69 76 65 64 20 |d have r|eceived |
|00000330| 61 20 63 6f 70 79 20 6f | 66 20 74 68 65 20 47 4e |a copy o|f the GN|
|00000340| 55 20 47 65 6e 65 72 61 | 6c 20 50 75 62 6c 69 63 |U Genera|l Public|
|00000350| 20 4c 69 63 65 6e 73 65 | 0a 40 63 20 20 61 6c 6f | License|.@c alo|
|00000360| 6e 67 20 77 69 74 68 20 | 74 68 69 73 20 70 72 6f |ng with |this pro|
|00000370| 67 72 61 6d 3b 20 69 66 | 20 6e 6f 74 2c 20 77 72 |gram; if| not, wr|
|00000380| 69 74 65 20 74 6f 20 74 | 68 65 20 46 72 65 65 20 |ite to t|he Free |
|00000390| 53 6f 66 74 77 61 72 65 | 0a 40 63 20 20 46 6f 75 |Software|.@c Fou|
|000003a0| 6e 64 61 74 69 6f 6e 2c | 20 49 6e 63 2e 2c 20 36 |ndation,| Inc., 6|
|000003b0| 37 35 20 4d 61 73 73 20 | 41 76 65 2c 20 43 61 6d |75 Mass |Ave, Cam|
|000003c0| 62 72 69 64 67 65 2c 20 | 4d 41 20 30 32 31 33 39 |bridge, |MA 02139|
|000003d0| 2c 20 55 53 41 2e 0a 40 | 63 0a 40 63 0a 40 63 20 |, USA..@|c.@c.@c |
|000003e0| 20 54 68 69 73 20 66 69 | 6c 65 20 63 6f 6e 74 61 | This fi|le conta|
|000003f0| 69 6e 73 20 74 68 65 20 | 65 6e 67 6c 69 73 68 20 |ins the |english |
|00000400| 64 6f 63 75 6d 65 6e 74 | 61 74 69 6f 6e 2e 0a 40 |document|ation..@|
|00000410| 63 0a 40 63 20 20 43 6f | 6d 70 75 74 65 72 3a 09 |c.@c Co|mputer:.|
|00000420| 41 6d 69 67 61 20 31 32 | 30 30 09 09 20 20 20 20 |Amiga 12|00.. |
|00000430| 43 6f 6d 70 69 6c 65 72 | 3a 09 44 49 43 45 20 56 |Compiler|:.DICE V|
|00000440| 32 2e 30 37 2e 35 34 20 | 28 33 2e 30 29 0a 40 63 |2.07.54 |(3.0).@c|
|00000450| 0a 40 63 20 20 41 75 74 | 6f 72 3a 09 4a 6f 63 68 |.@c Aut|or:.Joch|
|00000460| 65 6e 20 57 69 65 64 6d | 61 6e 6e 0a 40 63 09 09 |en Wiedm|ann.@c..|
|00000470| 41 6d 20 45 69 73 74 65 | 69 63 68 20 39 0a 40 63 |Am Eiste|ich 9.@c|
|00000480| 09 20 20 37 32 35 35 35 | 20 4d 65 74 7a 69 6e 67 |. 72555| Metzing|
|00000490| 65 6e 0a 40 63 09 09 54 | 65 6c 2e 20 30 37 31 32 |en.@c..T|el. 0712|
|000004a0| 33 20 2f 20 31 34 38 38 | 31 0a 40 63 09 09 49 6e |3 / 1488|1.@c..In|
|000004b0| 74 65 72 6e 65 74 3a 20 | 77 69 65 64 6d 61 6e 6e |ternet: |wiedmann|
|000004c0| 40 75 6e 69 2d 74 75 65 | 62 69 6e 67 65 6e 2e 64 |@uni-tue|bingen.d|
|000004d0| 65 0a 40 63 0a 0a 40 73 | 65 74 20 56 45 52 53 49 |e.@c..@s|et VERSI|
|000004e0| 4f 4e 20 31 2e 34 0a 40 | 69 66 74 65 78 0a 40 70 |ON 1.4.@|iftex.@p|
|000004f0| 61 72 73 6b 69 70 3d 30 | 2e 37 35 65 6d 0a 40 65 |arskip=0|.75em.@e|
|00000500| 6e 64 20 69 66 74 65 78 | 0a 40 63 20 25 2a 2a 65 |nd iftex|.@c %**e|
|00000510| 6e 64 20 6f 66 20 68 65 | 61 64 65 72 0a 0a 0a 40 |nd of he|ader...@|
|00000520| 74 69 74 6c 65 70 61 67 | 65 0a 0a 40 74 69 74 6c |titlepag|e..@titl|
|00000530| 65 7b 46 6c 65 78 43 61 | 74 7d 0a 40 73 75 62 74 |e{FlexCa|t}.@subt|
|00000540| 69 74 6c 65 7b 54 68 65 | 20 66 6c 65 78 69 62 6c |itle{The| flexibl|
|00000550| 65 20 63 61 74 61 6c 6f | 67 20 67 65 6e 65 72 61 |e catalo|g genera|
|00000560| 74 6f 72 7d 0a 40 73 75 | 62 74 69 74 6c 65 7b 7d |tor}.@su|btitle{}|
|00000570| 0a 40 73 75 62 74 69 74 | 6c 65 7b 56 65 72 73 69 |.@subtit|le{Versi|
|00000580| 6f 6e 20 40 76 61 6c 75 | 65 7b 56 45 52 53 49 4f |on @valu|e{VERSIO|
|00000590| 4e 7d 7d 0a 40 61 75 74 | 68 6f 72 20 4a 6f 63 68 |N}}.@aut|hor Joch|
|000005a0| 65 6e 20 57 69 65 64 6d | 61 6e 6e 0a 40 76 73 6b |en Wiedm|ann.@vsk|
|000005b0| 69 70 20 30 70 74 20 70 | 6c 75 73 20 31 66 69 6c |ip 0pt p|lus 1fil|
|000005c0| 6c 6c 0a 40 74 65 78 0a | 40 68 61 6c 69 67 6e 7b |ll.@tex.|@halign{|
|000005d0| 40 68 66 69 6c 23 26 23 | 40 68 66 69 6c 40 63 72 |@hfil#&#|@hfil@cr|
|000005e0| 0a 43 6f 70 79 72 69 67 | 68 74 20 40 63 6f 70 79 |.Copyrig|ht @copy|
|000005f0| 72 69 67 68 74 20 31 39 | 39 33 20 26 20 4a 6f 63 |right 19|93 & Joc|
|00000600| 68 65 6e 20 57 69 65 64 | 6d 61 6e 6e 40 63 72 0a |hen Wied|mann@cr.|
|00000610| 09 20 20 20 26 20 41 6d | 20 45 69 73 74 65 69 63 |. & Am| Eisteic|
|00000620| 68 20 39 40 63 72 0a 09 | 20 20 37 32 35 35 35 20 |h 9@cr..| 72555 |
|00000630| 26 20 4d 65 74 7a 69 6e | 67 65 6e 20 28 44 65 75 |& Metzin|gen (Deu|
|00000640| 74 73 63 68 6c 61 6e 64 | 29 40 63 72 0a 09 20 20 |tschland|)@cr.. |
|00000650| 20 26 20 54 65 6c 2e 20 | 30 37 31 32 33 20 2f 20 | & Tel. |07123 / |
|00000660| 31 34 38 38 31 40 63 72 | 0a 09 20 20 20 26 20 49 |14881@cr|.. & I|
|00000670| 6e 74 65 72 6e 65 74 3a | 20 77 69 65 64 6d 61 6e |nternet:| wiedman|
|00000680| 6e 40 40 75 6e 69 2d 74 | 75 65 62 69 6e 67 65 6e |n@@uni-t|uebingen|
|00000690| 2e 64 65 40 63 72 0a 7d | 0a 40 65 6e 64 20 74 65 |.de@cr.}|.@end te|
|000006a0| 78 0a 0a 50 65 72 6d 69 | 73 73 69 6f 6e 20 69 73 |x..Permi|ssion is|
|000006b0| 20 67 72 61 6e 74 65 64 | 20 74 6f 20 6d 61 6b 65 | granted| to make|
|000006c0| 20 61 6e 64 20 64 69 73 | 74 72 69 62 75 74 65 20 | and dis|tribute |
|000006d0| 76 65 72 62 61 74 69 6d | 20 61 6e 64 20 6d 6f 64 |verbatim| and mod|
|000006e0| 69 66 69 65 64 20 63 6f | 70 69 65 73 20 6f 66 0a |ified co|pies of.|
|000006f0| 74 68 69 73 20 6d 61 6e | 75 61 6c 20 61 6e 64 20 |this man|ual and |
|00000700| 74 68 65 20 70 72 6f 67 | 72 61 6d 20 46 6c 65 78 |the prog|ram Flex|
|00000710| 43 61 74 20 66 6f 6c 6c | 6f 77 69 6e 67 20 74 68 |Cat foll|owing th|
|00000720| 65 20 74 65 72 6d 73 20 | 6f 66 20 74 68 65 20 60 |e terms |of the `|
|00000730| 60 47 4e 55 20 47 65 6e | 65 72 61 6c 0a 50 75 62 |`GNU Gen|eral.Pub|
|00000740| 6c 69 63 20 4c 69 63 65 | 6e 73 65 27 27 20 70 72 |lic Lice|nse'' pr|
|00000750| 6f 76 69 64 65 64 20 74 | 68 65 20 63 6f 70 79 72 |ovided t|he copyr|
|00000760| 69 67 68 74 20 6e 6f 74 | 69 63 65 20 61 6e 64 20 |ight not|ice and |
|00000770| 74 68 69 73 20 70 65 72 | 6d 69 73 73 69 6f 6e 20 |this per|mission |
|00000780| 6e 6f 74 69 63 65 0a 61 | 72 65 20 70 72 65 73 65 |notice.a|re prese|
|00000790| 72 76 65 64 20 6f 6e 20 | 61 6c 6c 20 63 6f 70 69 |rved on |all copi|
|000007a0| 65 73 20 61 6e 64 20 74 | 68 65 20 60 60 47 4e 55 |es and t|he ``GNU|
|000007b0| 20 47 65 6e 65 72 61 6c | 20 50 75 62 6c 69 63 20 | General| Public |
|000007c0| 4c 69 63 65 6e 73 65 27 | 27 20 28 69 6e 20 74 68 |License'|' (in th|
|000007d0| 65 0a 66 69 6c 65 20 40 | 66 69 6c 65 7b 43 4f 50 |e.file @|file{COP|
|000007e0| 59 49 4e 47 7d 29 20 69 | 73 20 64 69 73 74 72 69 |YING}) i|s distri|
|000007f0| 62 75 74 65 64 20 61 73 | 20 77 65 6c 6c 2e 0a 0a |buted as| well...|
|00000800| 40 69 67 6e 6f 72 65 0a | 50 65 72 6d 69 73 73 69 |@ignore.|Permissi|
|00000810| 6f 6e 20 69 73 20 67 72 | 61 6e 74 65 64 20 74 6f |on is gr|anted to|
|00000820| 20 70 72 6f 63 65 73 73 | 20 74 68 69 73 20 66 69 | process| this fi|
|00000830| 6c 65 20 62 79 20 54 65 | 58 20 61 6e 64 20 70 72 |le by Te|X and pr|
|00000840| 69 6e 74 20 74 68 65 20 | 72 65 73 75 6c 74 73 2c |int the |results,|
|00000850| 0a 70 72 6f 76 69 64 65 | 64 20 74 68 65 20 70 72 |.provide|d the pr|
|00000860| 69 6e 74 65 64 20 64 6f | 63 75 6d 65 6e 74 20 63 |inted do|cument c|
|00000870| 61 72 72 69 65 73 20 61 | 20 63 6f 70 79 69 6e 67 |arries a| copying|
|00000880| 20 70 65 72 6d 69 73 73 | 69 6f 6e 20 6e 6f 74 69 | permiss|ion noti|
|00000890| 63 65 20 69 64 65 6e 74 | 69 63 61 6c 20 74 6f 0a |ce ident|ical to.|
|000008a0| 74 68 69 73 20 6f 6e 65 | 20 65 78 63 65 70 74 20 |this one| except |
|000008b0| 66 6f 72 20 74 68 65 20 | 72 65 6d 6f 76 61 6c 20 |for the |removal |
|000008c0| 6f 66 20 74 68 69 73 20 | 70 61 72 61 67 72 61 70 |of this |paragrap|
|000008d0| 68 20 28 74 68 69 73 20 | 70 61 72 61 67 72 61 70 |h (this |paragrap|
|000008e0| 68 20 6e 6f 74 20 62 65 | 69 6e 67 0a 72 65 6c 65 |h not be|ing.rele|
|000008f0| 76 61 6e 74 20 74 6f 20 | 74 68 65 20 70 72 69 6e |vant to |the prin|
|00000900| 74 65 64 20 6d 61 6e 75 | 61 6c 29 2e 0a 40 65 6e |ted manu|al)..@en|
|00000910| 64 20 69 67 6e 6f 72 65 | 0a 0a 54 68 65 20 61 75 |d ignore|..The au|
|00000920| 74 68 6f 72 20 67 69 76 | 65 73 20 40 73 74 72 6f |thor giv|es @stro|
|00000930| 6e 67 7b 61 62 73 6f 6c | 75 74 65 6c 79 20 6e 6f |ng{absol|utely no|
|00000940| 7d 20 77 61 72 72 61 6e | 74 79 20 74 68 61 74 20 |} warran|ty that |
|00000950| 74 68 65 20 70 72 6f 67 | 72 61 6d 20 64 65 73 63 |the prog|ram desc|
|00000960| 72 69 62 65 64 0a 69 6e | 20 74 68 69 73 20 64 6f |ribed.in| this do|
|00000970| 63 75 6d 65 6e 74 61 74 | 69 6f 6e 20 61 6e 64 20 |cumentat|ion and |
|00000980| 74 68 65 20 72 65 73 75 | 6c 74 73 20 70 72 6f 64 |the resu|lts prod|
|00000990| 75 63 65 64 20 62 79 20 | 69 74 20 61 72 65 20 63 |uced by |it are c|
|000009a0| 6f 72 72 65 63 74 2e 20 | 54 68 65 0a 61 75 74 68 |orrect. |The.auth|
|000009b0| 6f 72 20 63 61 6e 6e 6f | 74 20 62 65 20 68 65 6c |or canno|t be hel|
|000009c0| 64 20 72 65 73 70 6f 6e | 73 69 62 6c 65 20 66 6f |d respon|sible fo|
|000009d0| 72 20 40 73 74 72 6f 6e | 67 7b 61 6e 79 7d 20 64 |r @stron|g{any} d|
|000009e0| 61 6d 61 67 65 20 20 72 | 65 73 75 6c 74 69 6e 67 |amage r|esulting|
|000009f0| 20 66 72 6f 6d 0a 74 68 | 65 20 75 73 65 20 6f 66 | from.th|e use of|
|00000a00| 20 74 68 69 73 20 73 6f | 66 74 77 61 72 65 2e 0a | this so|ftware..|
|00000a10| 40 65 6e 64 20 74 69 74 | 6c 65 70 61 67 65 0a 40 |@end tit|lepage.@|
|00000a20| 69 66 74 65 78 0a 40 68 | 65 61 64 69 6e 67 73 20 |iftex.@h|eadings |
|00000a30| 64 6f 75 62 6c 65 0a 40 | 65 6e 64 20 69 66 74 65 |double.@|end ifte|
|00000a40| 78 0a 0a 40 69 66 69 6e | 66 6f 0a 40 6e 6f 64 65 |x..@ifin|fo.@node|
|00000a50| 20 54 6f 70 0a 40 74 6f | 70 20 46 6c 65 78 43 61 | Top.@to|p FlexCa|
|00000a60| 74 20 56 40 76 61 6c 75 | 65 7b 56 45 52 53 49 4f |t V@valu|e{VERSIO|
|00000a70| 4e 7d 20 44 6f 63 75 6d | 65 6e 74 61 74 69 6f 6e |N} Docum|entation|
|00000a80| 0a 54 68 69 73 20 66 69 | 6c 65 20 64 65 73 63 72 |.This fi|le descr|
|00000a90| 69 62 65 73 20 74 68 65 | 20 55 73 61 67 65 20 6f |ibes the| Usage o|
|00000aa0| 66 20 46 6c 65 78 43 61 | 74 20 56 40 76 61 6c 75 |f FlexCa|t V@valu|
|00000ab0| 65 7b 56 45 52 53 49 4f | 4e 7d 2c 20 61 20 70 72 |e{VERSIO|N}, a pr|
|00000ac0| 6f 67 72 61 6d 20 77 68 | 69 63 68 0a 67 65 6e 65 |ogram wh|ich.gene|
|00000ad0| 72 61 74 65 73 20 63 61 | 74 61 6c 6f 67 73 20 61 |rates ca|talogs a|
|00000ae0| 6e 64 20 74 68 65 20 73 | 6f 75 72 63 65 20 74 6f |nd the s|ource to|
|00000af0| 20 68 61 6e 64 6c 65 20 | 74 68 65 6d 2e 20 46 6c | handle |them. Fl|
|00000b00| 65 78 43 61 74 20 77 6f | 72 6b 73 20 73 69 6d 69 |exCat wo|rks simi|
|00000b10| 6c 61 72 20 74 6f 0a 40 | 63 6f 64 65 7b 43 61 74 |lar to.@|code{Cat|
|00000b20| 43 6f 6d 70 7d 20 61 6e | 64 20 40 63 6f 64 65 7b |Comp} an|d @code{|
|00000b30| 4b 69 74 43 61 74 7d 2c | 20 62 75 74 20 64 69 66 |KitCat},| but dif|
|00000b40| 66 65 72 73 20 69 6e 20 | 67 65 6e 65 72 61 74 69 |fers in |generati|
|00000b50| 6e 67 20 61 6e 79 20 73 | 6f 75 72 63 65 20 79 6f |ng any s|ource yo|
|00000b60| 75 0a 77 61 6e 74 2e 20 | 54 68 69 73 20 69 73 20 |u.want. |This is |
|00000b70| 64 6f 6e 65 20 62 79 20 | 75 73 69 6e 67 20 74 68 |done by |using th|
|00000b80| 65 20 73 6f 20 63 61 6c | 6c 65 64 20 40 63 6f 64 |e so cal|led @cod|
|00000b90| 65 7b 53 6f 75 72 63 65 | 20 64 65 73 63 72 69 70 |e{Source| descrip|
|00000ba0| 74 69 6f 6e 73 7d 2c 20 | 77 68 69 63 68 0a 61 72 |tions}, |which.ar|
|00000bb0| 65 20 61 20 74 65 6d 70 | 6c 61 74 65 20 66 6f 72 |e a temp|late for|
|00000bc0| 20 74 68 65 20 63 6f 64 | 65 20 74 6f 20 67 65 6e | the cod|e to gen|
|00000bd0| 65 72 61 74 65 2e 20 54 | 68 65 79 20 63 61 6e 20 |erate. T|hey can |
|00000be0| 62 65 20 65 64 69 74 65 | 64 20 61 6e 64 20 68 65 |be edite|d and he|
|00000bf0| 6e 63 65 0a 61 64 61 70 | 74 65 64 20 74 6f 20 61 |nce.adap|ted to a|
|00000c00| 6e 79 20 70 72 6f 67 72 | 61 6d 6d 69 6e 67 20 6c |ny progr|amming l|
|00000c10| 61 6e 67 75 61 67 65 20 | 61 6e 64 20 69 6e 64 69 |anguage |and indi|
|00000c20| 76 69 64 75 61 6c 20 6e | 65 65 64 73 2e 20 28 48 |vidual n|eeds. (H|
|00000c30| 6f 70 65 66 75 6c 6c 79 | 21 29 0a 0a 40 6d 65 6e |opefully|!)..@men|
|00000c40| 75 0a 47 65 6e 65 72 61 | 6c 3a 0a 0a 2a 20 44 69 |u.Genera|l:..* Di|
|00000c50| 73 63 6c 61 69 6d 65 72 | 3a 3a 09 20 20 20 20 20 |sclaimer|::. |
|00000c60| 43 6f 70 79 72 69 67 68 | 74 73 2c 20 28 4e 4f 29 |Copyrigh|ts, (NO)|
|00000c70| 20 77 61 72 72 61 6e 74 | 79 0a 2a 20 53 75 72 76 | warrant|y.* Surv|
|00000c80| 65 79 3a 3a 09 20 20 20 | 20 20 57 68 61 74 20 69 |ey::. | What i|
|00000c90| 73 20 46 6c 65 78 43 61 | 74 3f 0a 2a 20 49 6e 73 |s FlexCa|t?.* Ins|
|00000ca0| 74 61 6c 6c 61 74 69 6f | 6e 3a 3a 20 20 20 20 20 |tallatio|n:: |
|00000cb0| 48 6f 77 20 63 61 6e 20 | 49 20 67 65 74 20 69 74 |How can |I get it|
|00000cc0| 20 77 6f 72 6b 69 6e 67 | 3f 0a 0a 55 73 69 6e 67 | working|?..Using|
|00000cd0| 20 46 6c 65 78 43 61 74 | 3a 0a 0a 2a 20 50 72 6f | FlexCat|:..* Pro|
|00000ce0| 67 72 61 6d 20 73 74 61 | 72 74 3a 3a 09 20 43 61 |gram sta|rt::. Ca|
|00000cf0| 6c 6c 69 6e 67 20 46 6c | 65 78 43 61 74 20 66 72 |lling Fl|exCat fr|
|00000d00| 6f 6d 20 74 68 65 20 43 | 4c 49 0a 2a 20 43 61 74 |om the C|LI.* Cat|
|00000d10| 61 6c 6f 67 20 64 65 73 | 63 72 69 70 74 69 6f 6e |alog des|cription|
|00000d20| 3a 3a 20 20 43 61 74 61 | 6c 6f 67 20 64 65 73 63 |:: Cata|log desc|
|00000d30| 72 69 70 74 69 6f 6e 20 | 66 69 6c 65 73 20 28 40 |ription |files (@|
|00000d40| 6b 65 79 7b 2e 63 64 7d | 2d 66 69 6c 65 73 29 0a |key{.cd}|-files).|
|00000d50| 2a 20 43 61 74 61 6c 6f | 67 20 74 72 61 6e 73 6c |* Catalo|g transl|
|00000d60| 61 74 69 6f 6e 3a 3a 20 | 20 43 61 74 61 6c 6f 67 |ation:: | Catalog|
|00000d70| 20 74 72 61 6e 73 6c 61 | 74 69 6f 6e 20 66 69 6c | transla|tion fil|
|00000d80| 65 73 20 28 40 6b 65 79 | 7b 2e 63 74 7d 2d 66 69 |es (@key|{.ct}-fi|
|00000d90| 6c 65 73 29 0a 2a 20 53 | 6f 75 72 63 65 20 64 65 |les).* S|ource de|
|00000da0| 73 63 72 69 70 74 69 6f | 6e 3a 3a 09 20 53 6f 75 |scriptio|n::. Sou|
|00000db0| 72 63 65 20 64 65 73 63 | 72 69 70 74 69 6f 6e 20 |rce desc|ription |
|00000dc0| 28 40 6b 65 79 7b 2e 73 | 64 7d 2d 66 69 6c 65 73 |(@key{.s|d}-files|
|00000dd0| 29 0a 2a 20 55 73 69 6e | 67 20 46 6c 65 78 43 61 |).* Usin|g FlexCa|
|00000de0| 74 20 73 6f 75 72 63 65 | 3a 3a 20 55 73 69 6e 67 |t source|:: Using|
|00000df0| 20 46 6c 65 78 43 61 74 | 20 73 6f 75 72 63 65 20 | FlexCat| source |
|00000e00| 69 6e 20 6f 77 6e 20 70 | 72 6f 67 72 61 6d 73 0a |in own p|rograms.|
|00000e10| 0a 55 6e 6e 65 63 65 73 | 73 69 74 69 65 73 3a 0a |.Unneces|sities:.|
|00000e20| 0a 2a 20 46 75 74 75 72 | 65 3a 3a 09 09 46 75 72 |.* Futur|e::..Fur|
|00000e30| 74 68 65 72 20 64 65 76 | 65 6c 6f 70 6d 65 6e 74 |ther dev|elopment|
|00000e40| 20 6f 66 20 46 6c 65 78 | 43 61 74 0a 2a 20 43 72 | of Flex|Cat.* Cr|
|00000e50| 65 64 69 74 73 3a 3a 09 | 09 57 68 61 74 20 49 20 |edits::.|.What I |
|00000e60| 61 6c 77 61 79 73 20 77 | 61 6e 74 65 64 20 74 6f |always w|anted to|
|00000e70| 20 73 61 79 40 64 6f 74 | 73 7b 7d 0a 2a 20 49 6e | say@dot|s{}.* In|
|00000e80| 64 65 78 3a 3a 09 09 57 | 68 65 72 65 20 79 6f 75 |dex::..W|here you|
|00000e90| 20 66 69 6e 64 20 77 68 | 61 74 20 79 6f 75 20 61 | find wh|at you a|
|00000ea0| 72 65 20 6e 65 76 65 72 | 20 6c 6f 6f 6b 69 6e 67 |re never| looking|
|00000eb0| 20 66 6f 72 0a 40 65 6e | 64 20 6d 65 6e 75 0a 40 | for.@en|d menu.@|
|00000ec0| 65 6e 64 20 69 66 69 6e | 66 6f 0a 0a 0a 0a 0a 0a |end ifin|fo......|
|00000ed0| 40 69 66 69 6e 66 6f 0a | 40 6e 6f 64 65 20 44 69 |@ifinfo.|@node Di|
|00000ee0| 73 63 6c 61 69 6d 65 72 | 0a 40 63 68 61 70 74 65 |sclaimer|.@chapte|
|00000ef0| 72 20 43 6f 70 79 72 69 | 67 68 74 20 61 6e 64 20 |r Copyri|ght and |
|00000f00| 6f 74 68 65 72 20 6c 65 | 67 61 6c 20 73 74 75 66 |other le|gal stuf|
|00000f10| 66 0a 40 63 69 6e 64 65 | 78 20 43 6f 70 79 72 69 |f.@cinde|x Copyri|
|00000f20| 67 68 74 0a 40 63 69 6e | 64 65 78 20 44 69 73 74 |ght.@cin|dex Dist|
|00000f30| 72 69 62 75 74 69 6f 6e | 0a 40 63 69 6e 64 65 78 |ribution|.@cindex|
|00000f40| 20 50 65 72 6d 69 73 73 | 69 6f 6e 73 0a 40 63 69 | Permiss|ions.@ci|
|00000f50| 6e 64 65 78 20 50 72 6f | 68 69 62 69 74 69 6f 6e |ndex Pro|hibition|
|00000f60| 73 0a 40 63 69 6e 64 65 | 78 20 41 75 74 68 6f 72 |s.@cinde|x Author|
|00000f70| 0a 40 63 69 6e 64 65 78 | 20 41 64 72 65 73 73 0a |.@cindex| Adress.|
|00000f80| 40 63 69 6e 64 65 78 20 | 49 6e 74 65 72 6e 65 74 |@cindex |Internet|
|00000f90| 0a 40 63 69 6e 64 65 78 | 20 4d 61 69 6c 0a 40 65 |.@cindex| Mail.@e|
|00000fa0| 78 61 6d 70 6c 65 0a 43 | 6f 70 79 72 69 67 68 74 |xample.C|opyright|
|00000fb0| 20 40 63 6f 70 79 72 69 | 67 68 74 7b 7d 20 31 39 | @copyri|ght{} 19|
|00000fc0| 39 33 09 4a 6f 63 68 65 | 6e 20 57 69 65 64 6d 61 |93.Joche|n Wiedma|
|00000fd0| 6e 6e 0a 09 09 09 41 6d | 20 45 69 73 74 65 69 63 |nn....Am| Eisteic|
|00000fe0| 68 20 39 0a 09 09 20 20 | 37 32 35 35 35 20 4d 65 |h 9... |72555 Me|
|00000ff0| 74 7a 69 6e 67 65 6e 20 | 28 44 65 75 74 73 63 68 |tzingen |(Deutsch|
|00001000| 6c 61 6e 64 29 0a 09 09 | 09 54 65 6c 2e 20 30 37 |land)...|.Tel. 07|
|00001010| 31 32 33 20 2f 20 31 34 | 38 38 31 0a 09 09 09 49 |123 / 14|881....I|
|00001020| 6e 74 65 72 6e 65 74 3a | 20 77 69 65 64 6d 61 6e |nternet:| wiedman|
|00001030| 6e 40 40 75 6e 69 2d 74 | 75 65 62 69 6e 67 65 6e |n@@uni-t|uebingen|
|00001040| 2e 64 65 0a 40 65 6e 64 | 20 65 78 61 6d 70 6c 65 |.de.@end| example|
|00001050| 0a 0a 50 65 72 6d 69 73 | 73 69 6f 6e 20 69 73 20 |..Permis|sion is |
|00001060| 67 72 61 6e 74 65 64 20 | 74 6f 20 6d 61 6b 65 20 |granted |to make |
|00001070| 61 6e 64 20 64 69 73 74 | 72 69 62 75 74 65 20 76 |and dist|ribute v|
|00001080| 65 72 62 61 74 69 6d 20 | 61 6e 64 20 6d 6f 64 69 |erbatim |and modi|
|00001090| 66 69 65 64 20 63 6f 70 | 69 65 73 20 6f 66 0a 74 |fied cop|ies of.t|
|000010a0| 68 69 73 20 64 6f 63 75 | 6d 65 6e 74 61 74 69 6f |his docu|mentatio|
|000010b0| 6e 20 61 6e 64 20 74 68 | 65 20 70 72 6f 67 72 61 |n and th|e progra|
|000010c0| 6d 20 46 6c 65 78 43 61 | 74 20 66 6f 6c 6c 6f 77 |m FlexCa|t follow|
|000010d0| 69 6e 67 20 74 68 65 20 | 74 65 72 6d 73 20 6f 66 |ing the |terms of|
|000010e0| 20 74 68 65 20 60 60 47 | 4e 55 0a 47 65 6e 65 72 | the ``G|NU.Gener|
|000010f0| 61 6c 20 50 75 62 6c 69 | 63 20 4c 69 63 65 6e 73 |al Publi|c Licens|
|00001100| 65 27 27 20 70 72 6f 76 | 69 64 65 64 20 74 68 65 |e'' prov|ided the|
|00001110| 20 63 6f 70 79 72 69 67 | 68 74 20 6e 6f 74 69 63 | copyrig|ht notic|
|00001120| 65 20 61 6e 64 20 74 68 | 69 73 20 70 65 72 6d 69 |e and th|is permi|
|00001130| 73 73 69 6f 6e 0a 6e 6f | 74 69 63 65 20 61 72 65 |ssion.no|tice are|
|00001140| 20 70 72 65 73 65 72 76 | 65 64 20 6f 6e 20 61 6c | preserv|ed on al|
|00001150| 6c 20 63 6f 70 69 65 73 | 20 61 6e 64 20 74 68 65 |l copies| and the|
|00001160| 20 60 60 47 4e 55 20 47 | 65 6e 65 72 61 6c 20 50 | ``GNU G|eneral P|
|00001170| 75 62 6c 69 63 20 4c 69 | 63 65 6e 73 65 27 27 0a |ublic Li|cense''.|
|00001180| 28 69 6e 20 74 68 65 20 | 66 69 6c 65 20 40 66 69 |(in the |file @fi|
|00001190| 6c 65 7b 43 4f 50 59 49 | 4e 47 7d 29 20 69 73 20 |le{COPYI|NG}) is |
|000011a0| 64 69 73 74 72 69 62 75 | 74 65 64 20 61 73 20 77 |distribu|ted as w|
|000011b0| 65 6c 6c 2e 0a 0a 40 69 | 67 6e 6f 72 65 0a 50 65 |ell...@i|gnore.Pe|
|000011c0| 72 6d 69 73 73 69 6f 6e | 20 69 73 20 67 72 61 6e |rmission| is gran|
|000011d0| 74 65 64 20 74 6f 20 70 | 72 6f 63 65 73 73 20 74 |ted to p|rocess t|
|000011e0| 68 69 73 20 66 69 6c 65 | 20 62 79 20 54 65 58 20 |his file| by TeX |
|000011f0| 61 6e 64 20 70 72 69 6e | 74 20 74 68 65 20 72 65 |and prin|t the re|
|00001200| 73 75 6c 74 73 2c 0a 70 | 72 6f 76 69 64 65 64 20 |sults,.p|rovided |
|00001210| 74 68 65 20 70 72 69 6e | 74 65 64 20 64 6f 63 75 |the prin|ted docu|
|00001220| 6d 65 6e 74 20 63 61 72 | 72 69 65 73 20 61 20 63 |ment car|ries a c|
|00001230| 6f 70 79 69 6e 67 20 70 | 65 72 6d 69 73 73 69 6f |opying p|ermissio|
|00001240| 6e 20 6e 6f 74 69 63 65 | 20 69 64 65 6e 74 69 63 |n notice| identic|
|00001250| 61 6c 20 74 6f 0a 74 68 | 69 73 20 6f 6e 65 20 65 |al to.th|is one e|
|00001260| 78 63 65 70 74 20 66 6f | 72 20 74 68 65 20 72 65 |xcept fo|r the re|
|00001270| 6d 6f 76 61 6c 20 6f 66 | 20 74 68 69 73 20 70 61 |moval of| this pa|
|00001280| 72 61 67 72 61 70 68 20 | 28 74 68 69 73 20 70 61 |ragraph |(this pa|
|00001290| 72 61 67 72 61 70 68 20 | 6e 6f 74 20 62 65 69 6e |ragraph |not bein|
|000012a0| 67 0a 72 65 6c 65 76 61 | 6e 74 20 74 6f 20 74 68 |g.releva|nt to th|
|000012b0| 65 20 70 72 69 6e 74 65 | 64 20 6d 61 6e 75 61 6c |e printe|d manual|
|000012c0| 29 2e 0a 40 65 6e 64 20 | 69 67 6e 6f 72 65 0a 0a |)..@end |ignore..|
|000012d0| 54 68 65 20 61 75 74 68 | 6f 72 20 67 69 76 65 73 |The auth|or gives|
|000012e0| 20 40 73 74 72 6f 6e 67 | 7b 61 62 73 6f 6c 75 74 | @strong|{absolut|
|000012f0| 65 6c 79 20 6e 6f 7d 20 | 77 61 72 72 61 6e 74 79 |ely no} |warranty|
|00001300| 20 74 68 61 74 20 74 68 | 65 20 70 72 6f 67 72 61 | that th|e progra|
|00001310| 6d 20 64 65 73 63 72 69 | 62 65 64 0a 69 6e 20 74 |m descri|bed.in t|
|00001320| 68 69 73 20 64 6f 63 75 | 6d 65 6e 74 61 74 69 6f |his docu|mentatio|
|00001330| 6e 20 61 6e 64 20 74 68 | 65 20 72 65 73 75 6c 74 |n and th|e result|
|00001340| 73 20 70 72 6f 64 75 63 | 65 64 20 62 79 20 69 74 |s produc|ed by it|
|00001350| 20 61 72 65 20 63 6f 72 | 72 65 63 74 2e 20 54 68 | are cor|rect. Th|
|00001360| 65 0a 61 75 74 68 6f 72 | 20 63 61 6e 6e 6f 74 20 |e.author| cannot |
|00001370| 62 65 20 68 65 6c 64 20 | 72 65 73 70 6f 6e 73 69 |be held |responsi|
|00001380| 62 6c 65 20 66 6f 72 20 | 40 73 74 72 6f 6e 67 7b |ble for |@strong{|
|00001390| 61 6e 79 7d 20 64 61 6d | 61 67 65 20 20 72 65 73 |any} dam|age res|
|000013a0| 75 6c 74 69 6e 67 20 66 | 72 6f 6d 0a 74 68 65 20 |ulting f|rom.the |
|000013b0| 75 73 65 20 6f 66 20 74 | 68 69 73 20 73 6f 66 74 |use of t|his soft|
|000013c0| 77 61 72 65 2e 0a 40 65 | 6e 64 20 69 66 69 6e 66 |ware..@e|nd ifinf|
|000013d0| 6f 0a 0a 0a 0a 40 6e 6f | 64 65 20 53 75 72 76 65 |o....@no|de Surve|
|000013e0| 79 0a 40 63 68 61 70 74 | 65 72 20 53 75 72 76 65 |y.@chapt|er Surve|
|000013f0| 79 0a 40 63 69 6e 64 65 | 78 20 53 75 72 76 65 79 |y.@cinde|x Survey|
|00001400| 0a 53 69 6e 63 65 20 57 | 6f 72 6b 62 65 6e 63 68 |.Since W|orkbench|
|00001410| 20 32 2e 31 20 74 68 65 | 20 41 6d 69 67 61 20 6f | 2.1 the| Amiga o|
|00001420| 66 66 65 72 73 20 61 20 | 72 61 74 68 65 72 20 70 |ffers a |rather p|
|00001430| 6c 65 61 73 61 6e 74 20 | 73 79 73 74 65 6d 20 6f |leasant |system o|
|00001440| 66 20 75 73 69 6e 67 0a | 70 72 6f 67 72 61 6d 73 |f using.|programs|
|00001450| 20 69 6e 20 64 69 66 66 | 65 72 65 6e 74 20 6c 61 | in diff|erent la|
|00001460| 6e 67 75 61 67 65 73 3a | 20 54 68 65 20 40 63 6f |nguages:| The @co|
|00001470| 64 65 7b 6c 6f 63 61 6c | 65 2e 6c 69 62 72 61 72 |de{local|e.librar|
|00001480| 79 7d 2e 20 28 54 68 69 | 73 20 69 73 0a 63 61 6c |y}. (Thi|s is.cal|
|00001490| 6c 65 64 20 6c 6f 63 61 | 6c 69 7a 69 6e 67 2c 20 |led loca|lizing, |
|000014a0| 74 68 61 74 27 73 20 77 | 68 61 74 20 74 68 65 20 |that's w|hat the |
|000014b0| 6e 61 6d 65 27 73 20 66 | 6f 72 2e 29 0a 0a 54 68 |name's f|or.)..Th|
|000014c0| 65 20 69 64 65 61 20 69 | 73 20 73 69 6d 70 6c 65 |e idea i|s simple|
|000014d0| 3a 20 59 6f 75 20 73 65 | 6c 65 63 74 20 61 20 6c |: You se|lect a l|
|000014e0| 61 6e 67 75 61 67 65 2c | 20 74 68 65 20 65 6e 67 |anguage,| the eng|
|000014f0| 6c 69 73 68 20 69 6e 20 | 6d 6f 73 74 20 63 61 73 |lish in |most cas|
|00001500| 65 73 20 61 6e 64 0a 77 | 72 69 74 65 20 79 6f 75 |es and.w|rite you|
|00001510| 72 20 70 72 6f 67 72 61 | 6d 20 69 6e 20 74 68 65 |r progra|m in the|
|00001520| 20 73 61 6d 65 20 6d 61 | 6e 6e 65 72 20 61 73 20 | same ma|nner as |
|00001530| 79 6f 75 20 64 69 64 20 | 77 69 74 68 6f 75 74 20 |you did |without |
|00001540| 6c 6f 63 61 6c 69 7a 69 | 6e 67 2c 20 65 78 63 65 |localizi|ng, exce|
|00001550| 70 74 0a 74 68 61 74 20 | 63 6f 6e 73 74 61 6e 74 |pt.that |constant|
|00001560| 20 73 74 72 69 6e 67 73 | 20 61 72 65 20 72 65 70 | strings| are rep|
|00001570| 6c 61 63 65 64 20 62 79 | 20 63 65 72 74 61 69 6e |laced by| certain|
|00001580| 20 66 75 6e 63 74 69 6f | 6e 20 63 61 6c 6c 73 2e | functio|n calls.|
|00001590| 20 41 6e 6f 74 68 65 72 | 0a 66 75 6e 63 74 69 6f | Another|.functio|
|000015a0| 6e 20 63 61 6c 6c 20 6d | 61 6b 65 73 20 69 74 20 |n call m|akes it |
|000015b0| 70 6f 73 73 69 62 6c 65 | 20 74 68 61 74 20 74 68 |possible| that th|
|000015c0| 65 20 75 73 65 72 20 73 | 65 6c 65 63 74 73 20 61 |e user s|elects a|
|000015d0| 6e 6f 74 68 65 72 20 6c | 61 6e 67 75 61 67 65 0a |nother l|anguage.|
|000015e0| 77 68 65 6e 20 74 68 65 | 20 70 72 6f 67 72 61 6d |when the| program|
|000015f0| 20 73 74 61 72 74 73 2e | 20 28 54 68 65 20 6c 61 | starts.| (The la|
|00001600| 74 74 65 72 20 66 75 6e | 63 74 69 6f 6e 20 63 61 |tter fun|ction ca|
|00001610| 6c 6c 20 6c 6f 61 64 73 | 20 61 6e 20 65 78 74 65 |ll loads| an exte|
|00001620| 72 6e 61 6c 20 66 69 6c | 65 2c 0a 74 68 65 20 73 |rnal fil|e,.the s|
|00001630| 6f 20 63 61 6c 6c 65 64 | 20 40 63 6f 64 65 7b 63 |o called| @code{c|
|00001640| 61 74 61 6c 6f 67 7d 20 | 61 6e 64 20 6d 61 6b 65 |atalog} |and make|
|00001650| 73 20 74 68 65 20 66 6f | 72 6d 65 72 20 74 6f 20 |s the fo|rmer to |
|00001660| 72 65 61 64 20 74 68 65 | 20 73 74 72 69 6e 67 73 |read the| strings|
|00001670| 20 66 72 6f 6d 0a 74 68 | 65 20 63 61 74 61 6c 6f | from.th|e catalo|
|00001680| 67 20 69 6e 73 74 65 61 | 64 20 6f 66 20 75 73 69 |g instea|d of usi|
|00001690| 6e 67 20 74 68 65 20 70 | 72 65 64 65 66 69 6e 65 |ng the p|redefine|
|000016a0| 64 20 73 74 72 69 6e 67 | 73 2e 29 0a 0a 54 68 65 |d string|s.)..The|
|000016b0| 73 65 20 63 61 74 61 6c | 6f 67 73 20 61 72 65 20 |se catal|ogs are |
|000016c0| 69 6e 64 65 70 65 6e 64 | 65 6e 74 20 66 72 6f 6d |independ|ent from|
|000016d0| 20 74 68 65 20 70 72 6f | 67 72 61 6d 2e 20 41 6c | the pro|gram. Al|
|000016e0| 6c 20 79 6f 75 20 6e 65 | 65 64 20 74 6f 20 64 6f |l you ne|ed to do|
|000016f0| 20 66 6f 72 0a 61 64 64 | 69 6e 67 20 61 6e 6f 74 | for.add|ing anot|
|00001700| 68 65 72 20 6c 61 6e 67 | 75 61 67 65 20 69 73 20 |her lang|uage is |
|00001710| 74 6f 20 63 72 65 61 74 | 65 20 61 20 6e 65 77 20 |to creat|e a new |
|00001720| 63 61 74 61 6c 6f 67 20 | 66 69 6c 65 20 61 6e 64 |catalog |file and|
|00001730| 20 74 68 69 73 20 69 73 | 0a 70 6f 73 73 69 62 6c | this is|.possibl|
|00001740| 65 20 61 74 20 61 6e 79 | 20 74 69 6d 65 20 77 69 |e at any| time wi|
|00001750| 74 68 6f 75 74 20 63 68 | 61 6e 67 69 6e 67 20 74 |thout ch|anging t|
|00001760| 68 65 20 70 72 6f 67 72 | 61 6d 2e 0a 0a 42 75 74 |he progr|am...But|
|00001770| 20 74 68 65 72 65 20 61 | 72 65 20 61 64 64 69 74 | there a|re addit|
|00001780| 69 6f 6e 61 6c 20 74 61 | 73 6b 73 20 66 6f 72 20 |ional ta|sks for |
|00001790| 74 68 65 20 70 72 6f 67 | 72 61 6d 6d 65 72 3a 20 |the prog|rammer: |
|000017a0| 48 65 20 6e 65 65 64 73 | 20 74 6f 20 63 72 65 61 |He needs| to crea|
|000017b0| 74 65 20 74 68 65 0a 63 | 61 74 61 6c 6f 67 73 2c |te the.c|atalogs,|
|000017c0| 20 74 68 65 20 70 72 65 | 64 65 66 69 6e 65 64 20 | the pre|defined |
|000017d0| 73 74 72 69 6e 67 73 20 | 61 6e 64 20 73 6f 6d 65 |strings |and some|
|000017e0| 20 73 6f 75 72 63 65 20 | 74 6f 20 68 61 6e 64 6c | source |to handl|
|000017f0| 65 20 74 68 65 6d 20 61 | 6c 6c 2e 20 28 54 68 65 |e them a|ll. (The|
|00001800| 0a 66 75 6e 63 74 69 6f | 6e 73 20 74 68 61 74 20 |.functio|ns that |
|00001810| 61 72 65 20 6d 65 6e 74 | 69 6f 6e 65 64 20 61 62 |are ment|ioned ab|
|00001820| 6f 76 65 2e 29 20 46 6c | 65 78 43 61 74 20 69 73 |ove.) Fl|exCat is|
|00001830| 20 64 65 73 69 67 6e 65 | 64 20 74 6f 20 6d 61 6b | designe|d to mak|
|00001840| 65 20 74 68 69 73 20 69 | 6e 0a 61 6e 20 65 61 73 |e this i|n.an eas|
|00001850| 79 20 61 6e 64 20 6e 65 | 61 72 6c 79 20 61 75 74 |y and ne|arly aut|
|00001860| 6f 6d 61 74 69 63 20 6d | 61 6e 6e 65 72 20 77 69 |omatic m|anner wi|
|00001870| 74 68 6f 75 74 20 6c 6f | 73 69 6e 67 20 66 6c 65 |thout lo|sing fle|
|00001880| 78 69 62 69 6c 69 74 79 | 20 65 73 70 65 63 69 61 |xibility| especia|
|00001890| 6c 6c 79 0a 69 6e 20 63 | 72 65 61 74 69 6e 67 20 |lly.in c|reating |
|000018a0| 74 68 65 20 73 6f 75 72 | 63 65 2e 20 41 6e 20 65 |the sour|ce. An e|
|000018b0| 78 61 6d 70 6c 65 20 73 | 68 6f 75 6c 64 20 6d 61 |xample s|hould ma|
|000018c0| 6b 65 20 74 68 69 73 20 | 63 6c 65 61 72 3a 0a 0a |ke this |clear:..|
|000018d0| 4c 65 74 73 20 61 73 73 | 75 6d 65 20 74 68 61 74 |Lets ass|ume that|
|000018e0| 20 77 65 20 77 61 6e 74 | 20 74 6f 20 77 72 69 74 | we want| to writ|
|000018f0| 65 20 61 20 40 66 69 6c | 65 7b 48 65 6c 6c 6f 4c |e a @fil|e{HelloL|
|00001900| 6f 63 61 6c 57 6f 72 6c | 64 2e 63 7d 2e 20 4f 75 |ocalWorl|d.c}. Ou|
|00001910| 72 20 66 69 6e 61 6c 0a | 70 72 6f 67 72 61 6d 20 |r final.|program |
|00001920| 77 69 6c 6c 20 6c 6f 6f | 6b 20 6c 69 6b 65 20 74 |will loo|k like t|
|00001930| 68 69 73 3a 0a 40 65 78 | 61 6d 70 6c 65 0a 20 20 |his:.@ex|ample. |
|00001940| 20 20 23 69 6e 63 6c 75 | 64 65 20 3c 73 74 64 69 | #inclu|de <stdi|
|00001950| 6f 2e 68 3e 0a 20 20 20 | 20 23 69 6e 63 6c 75 64 |o.h>. | #includ|
|00001960| 65 20 3c 73 74 64 6c 69 | 62 2e 68 3e 0a 20 20 20 |e <stdli|b.h>. |
|00001970| 20 23 69 6e 63 6c 75 64 | 65 20 3c 48 65 6c 6c 6f | #includ|e <Hello|
|00001980| 4c 6f 63 61 6c 57 6f 72 | 6c 64 5f 43 61 74 2e 68 |LocalWor|ld_Cat.h|
|00001990| 3e 20 20 2f 2a 20 20 59 | 6f 75 20 40 73 74 72 6f |> /* Y|ou @stro|
|000019a0| 6e 67 7b 6d 75 73 74 7d | 20 69 6e 63 6c 75 64 65 |ng{must}| include|
|000019b0| 20 74 68 69 73 21 20 2a | 2f 0a 0a 20 20 20 20 76 | this! *|/.. v|
|000019c0| 6f 69 64 20 6d 61 69 6e | 28 69 6e 74 20 61 72 67 |oid main|(int arg|
|000019d0| 63 2c 20 63 68 61 72 20 | 2a 61 72 67 76 5b 5d 29 |c, char |*argv[])|
|000019e0| 0a 20 20 20 20 40 7b 0a | 20 20 20 20 20 20 70 72 |. @{.| pr|
|000019f0| 69 6e 74 66 28 22 25 73 | 5c 6e 22 2c 20 47 65 74 |intf("%s|\n", Get|
|00001a00| 53 74 72 69 6e 67 28 6d | 73 67 48 65 6c 6c 6f 29 |String(m|sgHello)|
|00001a10| 29 3b 0a 20 20 20 20 40 | 7d 0a 40 65 6e 64 20 65 |);. @|}.@end e|
|00001a20| 78 61 6d 70 6c 65 0a 40 | 6e 6f 69 6e 64 65 6e 74 |xample.@|noindent|
|00001a30| 0a 4e 6f 74 65 20 74 68 | 61 74 20 74 68 69 73 20 |.Note th|at this |
|00001a40| 69 73 20 71 75 69 74 65 | 20 74 68 65 20 73 61 6d |is quite| the sam|
|00001a50| 65 20 61 73 20 74 68 65 | 20 6f 72 69 67 69 6e 61 |e as the| origina|
|00001a60| 6c 20 40 66 69 6c 65 7b | 48 65 6c 6c 6f 57 6f 72 |l @file{|HelloWor|
|00001a70| 6c 64 2e 63 7d 20 65 78 | 63 65 70 74 0a 66 6f 72 |ld.c} ex|cept.for|
|00001a80| 20 72 65 70 6c 61 63 69 | 6e 67 20 74 68 65 20 73 | replaci|ng the s|
|00001a90| 74 72 69 6e 67 20 22 48 | 65 6c 6c 6f 2c 20 77 6f |tring "H|ello, wo|
|00001aa0| 72 6c 64 21 22 20 62 79 | 20 61 20 66 75 6e 63 74 |rld!" by| a funct|
|00001ab0| 69 6f 6e 20 63 61 6c 6c | 2e 0a 0a 54 68 65 20 61 |ion call|...The a|
|00001ac0| 62 6f 76 65 20 70 72 6f | 67 72 61 6d 20 75 73 65 |bove pro|gram use|
|00001ad0| 73 20 61 20 63 6f 6e 73 | 74 61 6e 74 20 40 73 61 |s a cons|tant @sa|
|00001ae0| 6d 70 7b 6d 73 67 48 65 | 6c 6c 6f 7d 2e 20 41 20 |mp{msgHe|llo}. A |
|00001af0| 63 61 6c 6c 20 74 6f 20 | 74 68 65 20 66 75 6e 63 |call to |the func|
|00001b00| 74 6f 6e 0a 40 63 6f 64 | 65 7b 47 65 74 53 74 72 |ton.@cod|e{GetStr|
|00001b10| 69 6e 67 7d 20 72 65 70 | 6c 61 63 65 73 20 74 68 |ing} rep|laces th|
|00001b20| 69 73 20 62 79 20 74 68 | 65 20 72 65 73 70 65 63 |is by th|e respec|
|00001b30| 74 69 76 65 20 73 74 72 | 69 6e 67 2e 0a 54 68 65 |tive str|ing..The|
|00001b40| 73 65 20 63 6f 6e 73 74 | 61 6e 74 73 20 61 6e 64 |se const|ants and|
|00001b50| 20 73 74 72 69 6e 67 73 | 20 61 72 65 20 64 65 66 | strings| are def|
|00001b60| 69 6e 65 64 20 69 6e 20 | 61 20 73 6f 20 63 61 6c |ined in |a so cal|
|00001b70| 6c 65 64 20 40 63 6f 64 | 65 7b 43 61 74 61 6c 6f |led @cod|e{Catalo|
|00001b80| 67 0a 64 65 73 63 72 69 | 70 74 69 6f 6e 7d 20 66 |g.descri|ption} f|
|00001b90| 69 6c 65 2e 20 28 40 70 | 78 72 65 66 7b 43 61 74 |ile. (@p|xref{Cat|
|00001ba0| 61 6c 6f 67 20 64 65 73 | 63 72 69 70 74 69 6f 6e |alog des|cription|
|00001bb0| 7d 2e 20 59 6f 75 20 61 | 6c 77 61 79 73 20 73 74 |}. You a|lways st|
|00001bc0| 61 72 74 20 62 79 20 63 | 72 65 61 74 69 6e 67 0a |art by c|reating.|
|00001bd0| 73 75 63 68 20 61 20 66 | 69 6c 65 20 63 61 6c 6c |such a f|ile call|
|00001be0| 65 64 20 40 66 69 6c 65 | 7b 48 65 6c 6c 6f 4c 6f |ed @file|{HelloLo|
|00001bf0| 63 61 6c 57 6f 72 6c 64 | 2e 63 64 7d 2c 20 77 68 |calWorld|.cd}, wh|
|00001c00| 69 63 68 20 63 6f 75 6c | 64 20 6c 6f 6f 6b 20 6c |ich coul|d look l|
|00001c10| 69 6b 65 20 74 68 69 73 | 3a 0a 40 65 78 61 6d 70 |ike this|:.@examp|
|00001c20| 6c 65 0a 20 20 20 20 3b | 09 43 6f 6d 6d 65 6e 74 |le. ;|.Comment|
|00001c30| 73 20 61 72 20 65 61 6c | 6c 6f 77 65 64 2c 20 6f |s ar eal|lowed, o|
|00001c40| 66 20 63 6f 75 72 73 65 | 21 20 45 61 63 68 20 6c |f course|! Each l|
|00001c50| 69 6e 65 20 62 65 67 69 | 6e 6e 69 6e 67 20 77 69 |ine begi|nning wi|
|00001c60| 74 68 20 61 0a 20 20 20 | 20 3b 09 73 65 6d 69 63 |th a. | ;.semic|
|00001c70| 6f 6c 6f 6e 20 69 73 20 | 61 73 73 75 6d 65 64 20 |olon is |assumed |
|00001c80| 74 6f 20 62 65 20 61 20 | 63 6f 6d 6d 65 6e 74 0a |to be a |comment.|
|00001c90| 20 20 20 20 3b 0a 20 20 | 20 20 3b 09 54 68 65 20 | ;. | ;.The |
|00001ca0| 6c 61 6e 67 75 61 67 65 | 20 6f 66 20 74 68 65 20 |language| of the |
|00001cb0| 62 75 69 6c 74 69 6e 20 | 73 74 72 69 6e 67 73 3a |builtin |strings:|
|00001cc0| 0a 20 20 20 20 23 6c 61 | 6e 67 75 61 67 65 20 65 |. #la|nguage e|
|00001cd0| 6e 67 6c 69 73 68 0a 20 | 20 20 20 3b 0a 20 20 20 |nglish. | ;. |
|00001ce0| 20 3b 09 54 68 65 20 63 | 61 74 61 6c 6f 67 20 76 | ;.The c|atalog v|
|00001cf0| 65 72 73 69 6f 6e 2c 20 | 75 73 65 64 20 66 6f 72 |ersion, |used for|
|00001d00| 20 61 20 63 61 6c 6c 20 | 74 6f 20 4c 6f 63 61 6c | a call |to Local|
|00001d10| 65 2f 4f 70 65 6e 43 61 | 74 61 6c 6f 67 28 29 2e |e/OpenCa|talog().|
|00001d20| 0a 20 20 20 20 3b 09 54 | 68 69 73 20 69 73 20 64 |. ;.T|his is d|
|00001d30| 69 66 66 65 72 65 6e 74 | 20 74 6f 20 45 78 65 63 |ifferent| to Exec|
|00001d40| 2f 4f 70 65 6e 4c 69 62 | 72 61 72 79 28 29 3a 20 |/OpenLib|rary(): |
|00001d50| 30 20 6d 65 61 6e 73 20 | 61 6e 79 20 63 61 74 61 |0 means |any cata|
|00001d60| 6c 6f 67 0a 20 20 20 20 | 3b 09 76 65 72 73 69 6f |log. |;.versio|
|00001d70| 6e 2c 20 6f 74 68 65 72 | 20 6e 75 6d 62 65 72 73 |n, other| numbers|
|00001d80| 20 6d 75 73 74 20 6d 61 | 74 63 68 20 65 78 61 63 | must ma|tch exac|
|00001d90| 74 6c 79 21 0a 20 20 20 | 20 23 76 65 72 73 69 6f |tly!. | #versio|
|00001da0| 6e 20 30 0a 20 20 20 20 | 3b 0a 20 20 20 20 3b 09 |n 0. |;. ;.|
|00001db0| 54 68 69 73 20 64 65 66 | 69 6e 65 73 20 61 20 73 |This def|ines a s|
|00001dc0| 74 72 69 6e 67 20 61 6e | 64 20 74 68 65 20 49 44 |tring an|d the ID|
|00001dd0| 20 77 68 69 63 68 20 61 | 6c 6c 6f 77 73 20 74 6f | which a|llows to|
|00001de0| 20 75 73 65 20 69 74 2e | 0a 20 20 20 20 3b 09 54 | use it.|. ;.T|
|00001df0| 68 65 20 6e 75 6d 62 65 | 72 20 34 20 73 61 79 73 |he numbe|r 4 says|
|00001e00| 2c 20 74 68 61 74 20 74 | 68 69 73 20 73 74 72 69 |, that t|his stri|
|00001e10| 6e 67 20 6d 75 73 74 20 | 6e 6f 74 20 62 65 20 73 |ng must |not be s|
|00001e20| 68 6f 72 74 65 72 20 74 | 68 61 6e 0a 20 20 20 20 |horter t|han. |
|00001e30| 3b 09 34 20 63 68 61 72 | 61 63 74 65 72 73 2e 0a |;.4 char|acters..|
|00001e40| 20 20 20 20 6d 73 67 48 | 65 6c 6c 6f 20 28 2f 34 | msgH|ello (/4|
|00001e50| 2f 29 0a 20 20 20 20 48 | 65 6c 6c 6f 2c 20 77 6f |/). H|ello, wo|
|00001e60| 72 6c 64 21 0a 40 65 6e | 64 20 65 78 61 6d 70 6c |rld!.@en|d exampl|
|00001e70| 65 0a 0a 42 79 20 75 73 | 69 6e 67 20 46 6c 65 78 |e..By us|ing Flex|
|00001e80| 43 61 74 20 79 6f 75 20 | 63 72 65 61 74 65 20 61 |Cat you |create a|
|00001e90| 6e 6f 74 68 65 72 20 74 | 77 6f 20 66 69 6c 65 73 |nother t|wo files|
|00001ea0| 20 66 72 6f 6d 20 74 68 | 65 20 63 61 74 61 6c 6f | from th|e catalo|
|00001eb0| 67 20 64 65 73 63 72 69 | 70 74 69 6f 6e 3a 0a 54 |g descri|ption:.T|
|00001ec0| 68 65 20 69 6e 63 6c 75 | 64 65 20 66 69 6c 65 20 |he inclu|de file |
|00001ed0| 40 66 69 6c 65 7b 48 65 | 6c 6c 6f 4c 6f 63 61 6c |@file{He|lloLocal|
|00001ee0| 57 6f 72 6c 64 5f 43 61 | 74 2e 68 7d 20 64 65 66 |World_Ca|t.h} def|
|00001ef0| 69 6e 65 73 20 74 68 65 | 20 63 6f 6e 73 74 61 6e |ines the| constan|
|00001f00| 74 73 20 61 6e 64 0a 74 | 68 65 20 40 66 69 6c 65 |ts and.t|he @file|
|00001f10| 7b 48 65 6c 6c 6f 4c 6f | 63 61 6c 57 6f 72 6c 64 |{HelloLo|calWorld|
|00001f20| 5f 43 61 74 2e 63 7d 20 | 63 6f 6e 74 61 69 6e 73 |_Cat.c} |contains|
|00001f30| 20 61 6e 20 61 72 72 61 | 79 20 6f 66 20 73 74 72 | an arra|y of str|
|00001f40| 69 6e 67 73 20 61 6e 64 | 20 74 68 65 0a 40 63 6f |ings and| the.@co|
|00001f50| 64 65 7b 47 65 74 53 74 | 72 69 6e 67 7d 20 66 75 |de{GetSt|ring} fu|
|00001f60| 6e 63 74 69 6f 6e 2e 0a | 59 6f 75 20 64 6f 6e 27 |nction..|You don'|
|00001f70| 74 20 6e 65 65 64 20 74 | 6f 20 6b 6e 6f 77 20 68 |t need t|o know h|
|00001f80| 6f 77 20 74 68 69 73 20 | 6c 6f 6f 6b 2c 20 6a 75 |ow this |look, ju|
|00001f90| 73 74 20 75 73 65 20 74 | 68 65 6d 2e 20 45 73 70 |st use t|hem. Esp|
|00001fa0| 65 63 69 61 6c 6c 79 20 | 79 6f 75 20 64 6f 6e 27 |ecially |you don'|
|00001fb0| 74 0a 6e 65 65 64 20 74 | 6f 20 6b 6e 6f 77 20 61 |t.need t|o know a|
|00001fc0| 6e 79 74 68 69 6e 67 20 | 61 62 6f 75 74 20 74 68 |nything |about th|
|00001fd0| 65 20 40 63 6f 64 65 7b | 6c 6f 63 61 6c 65 2e 6c |e @code{|locale.l|
|00001fe0| 69 62 72 61 72 79 7d 21 | 0a 0a 48 6f 77 65 76 65 |ibrary}!|..Howeve|
|00001ff0| 72 2c 20 79 6f 75 20 6d | 69 67 68 74 20 62 65 20 |r, you m|ight be |
|00002000| 69 6e 74 65 72 65 73 74 | 65 64 2c 20 68 6f 77 20 |interest|ed, how |
|00002010| 74 68 65 73 65 20 66 69 | 6c 65 73 20 6c 6f 6f 6b |these fi|les look|
|00002020| 20 6f 72 20 65 76 65 6e | 20 6d 6f 72 65 2c 20 79 | or even| more, y|
|00002030| 6f 75 0a 6d 69 67 68 74 | 20 77 61 6e 74 20 74 68 |ou.might| want th|
|00002040| 65 6d 20 63 68 61 6e 67 | 65 64 2e 20 54 68 69 73 |em chang|ed. This|
|00002050| 20 69 73 20 74 68 65 20 | 64 69 66 66 65 72 65 6e | is the |differen|
|00002060| 63 65 20 62 65 74 77 65 | 65 6e 20 46 6c 65 78 43 |ce betwe|en FlexC|
|00002070| 61 74 20 61 6e 64 20 6f | 74 68 65 72 0a 63 61 74 |at and o|ther.cat|
|00002080| 61 6c 6f 67 20 67 65 6e | 65 72 61 74 6f 72 73 3a |alog gen|erators:|
|00002090| 20 46 6c 65 78 43 61 74 | 20 69 73 20 6e 6f 74 20 | FlexCat| is not |
|000020a0| 66 6f 72 63 65 64 20 74 | 6f 20 75 73 65 20 61 20 |forced t|o use a |
|000020b0| 73 70 65 63 69 61 6c 20 | 62 75 69 6c 74 69 6e 20 |special |builtin |
|000020c0| 66 6f 72 6d 61 74 0a 66 | 6f 72 20 63 72 65 61 74 |format.f|or creat|
|000020d0| 69 6e 67 20 74 68 65 73 | 65 20 66 69 6c 65 73 2e |ing thes|e files.|
|000020e0| 20 49 6e 73 74 65 61 64 | 20 69 74 20 75 73 65 73 | Instead| it uses|
|000020f0| 20 65 78 74 65 72 6e 61 | 6c 20 74 65 6d 70 6c 61 | externa|l templa|
|00002100| 74 65 20 66 69 6c 65 73 | 2c 20 73 6f 0a 63 61 6c |te files|, so.cal|
|00002110| 6c 65 64 20 40 63 6f 64 | 65 7b 53 6f 75 72 63 65 |led @cod|e{Source|
|00002120| 20 64 65 73 63 72 69 70 | 74 69 6f 6e 73 7d 2e 20 | descrip|tions}. |
|00002130| 54 68 69 73 20 6d 61 6b | 65 73 20 69 74 20 70 6f |This mak|es it po|
|00002140| 73 73 69 62 6c 65 2c 20 | 66 6f 72 20 65 78 61 6d |ssible, |for exam|
|00002150| 70 6c 65 2c 0a 74 6f 20 | 61 6c 6c 6f 77 20 75 73 |ple,.to |allow us|
|00002160| 69 6e 67 20 63 61 74 61 | 6c 6f 67 73 20 77 69 74 |ing cata|logs wit|
|00002170| 68 20 41 6d 69 67 61 44 | 4f 53 20 32 2e 30 2e 20 |h AmigaD|OS 2.0. |
|00002180| 40 70 78 72 65 66 7b 53 | 6f 75 72 63 65 20 64 65 |@pxref{S|ource de|
|00002190| 73 63 72 69 70 74 69 6f | 6e 7d 2e 0a 49 66 20 79 |scriptio|n}..If y|
|000021a0| 6f 75 20 75 73 65 20 74 | 68 65 20 73 6f 75 72 63 |ou use t|he sourc|
|000021b0| 65 20 64 65 73 63 72 69 | 70 74 69 6f 6e 73 20 66 |e descri|ptions f|
|000021c0| 72 6f 6d 20 74 68 65 20 | 46 6c 65 78 43 61 74 20 |rom the |FlexCat |
|000021d0| 64 69 73 74 72 69 62 75 | 74 69 6f 6e 20 79 6f 75 |distribu|tion you|
|000021e0| 0a 63 61 6e 20 63 72 65 | 61 74 65 20 74 68 65 20 |.can cre|ate the |
|000021f0| 73 6f 75 72 63 65 20 66 | 69 6c 65 73 20 77 69 74 |source f|iles wit|
|00002200| 68 20 74 68 65 20 66 6f | 6c 6c 6f 77 69 6e 67 20 |h the fo|llowing |
|00002210| 63 6f 6d 6d 61 6e 64 73 | 3a 0a 40 65 78 61 6d 70 |commands|:.@examp|
|00002220| 6c 65 0a 20 20 20 20 40 | 73 61 6d 70 7b 46 6c 65 |le. @|samp{Fle|
|00002230| 78 43 61 74 20 48 65 6c | 6c 6f 4c 6f 63 61 6c 57 |xCat Hel|loLocalW|
|00002240| 6f 72 6c 64 2e 63 64 20 | 48 65 6c 6c 6f 4c 6f 63 |orld.cd |HelloLoc|
|00002250| 61 6c 57 6f 72 6c 64 5f | 43 61 74 2e 63 3d 41 75 |alWorld_|Cat.c=Au|
|00002260| 74 6f 43 5f 63 2e 73 64 | 7d 0a 20 20 20 20 40 73 |toC_c.sd|}. @s|
|00002270| 61 6d 70 7b 46 6c 65 78 | 43 61 74 20 48 65 6c 6c |amp{Flex|Cat Hell|
|00002280| 6f 4c 6f 63 61 6c 57 6f | 72 6c 64 2e 63 64 20 48 |oLocalWo|rld.cd H|
|00002290| 65 6c 6c 6f 4c 6f 63 61 | 6c 57 6f 72 6c 64 5f 43 |elloLoca|lWorld_C|
|000022a0| 61 74 2e 68 3d 41 75 74 | 6f 43 5f 68 2e 73 64 7d |at.h=Aut|oC_h.sd}|
|000022b0| 0a 40 65 6e 64 20 65 78 | 61 6d 70 6c 65 0a 0a 57 |.@end ex|ample..W|
|000022c0| 68 65 6e 20 79 6f 75 72 | 20 70 72 6f 67 72 61 6d |hen your| program|
|000022d0| 20 69 73 20 72 65 61 64 | 79 20 79 6f 75 20 75 73 | is read|y you us|
|000022e0| 65 20 46 6c 65 78 43 61 | 74 20 61 67 61 69 6e 20 |e FlexCa|t again |
|000022f0| 74 6f 20 63 72 65 61 74 | 65 20 73 6f 20 63 61 6c |to creat|e so cal|
|00002300| 6c 65 64 0a 40 63 6f 64 | 65 7b 43 61 74 61 6c 6f |led.@cod|e{Catalo|
|00002310| 67 20 74 72 61 6e 73 6c | 61 74 69 6f 6e 7d 20 66 |g transl|ation} f|
|00002320| 69 6c 65 73 2c 20 6f 6e | 65 20 66 6f 72 20 65 61 |iles, on|e for ea|
|00002330| 63 68 20 6c 61 6e 67 75 | 61 67 65 20 79 6f 75 20 |ch langu|age you |
|00002340| 77 6f 75 6c 64 20 6c 69 | 6b 65 20 74 6f 0a 73 75 |would li|ke to.su|
|00002350| 70 70 6f 72 74 2e 20 28 | 45 78 63 65 70 74 20 65 |pport. (|Except e|
|00002360| 6e 67 6c 69 73 68 2c 20 | 77 68 69 63 68 20 69 73 |nglish, |which is|
|00002370| 20 62 75 69 6c 74 69 6e | 2e 29 20 40 78 72 65 66 | builtin|.) @xref|
|00002380| 7b 43 61 74 61 6c 6f 67 | 20 74 72 61 6e 73 6c 61 |{Catalog| transla|
|00002390| 74 69 6f 6e 7d 2e 0a 4c | 65 74 73 20 63 72 65 61 |tion}..L|ets crea|
|000023a0| 74 65 20 61 20 67 65 72 | 6d 61 6e 20 63 61 74 61 |te a ger|man cata|
|000023b0| 6c 6f 67 20 74 72 61 6e | 73 6c 61 74 69 6f 6e 3a |log tran|slation:|
|000023c0| 0a 40 65 78 61 6d 70 6c | 65 0a 20 20 20 20 40 73 |.@exampl|e. @s|
|000023d0| 61 6d 70 7b 46 6c 65 78 | 43 61 74 20 48 65 6c 6c |amp{Flex|Cat Hell|
|000023e0| 6f 4c 6f 63 61 6c 57 6f | 72 6c 64 2e 63 64 20 4e |oLocalWo|rld.cd N|
|000023f0| 45 57 43 54 46 49 4c 45 | 20 44 65 75 74 73 63 68 |EWCTFILE| Deutsch|
|00002400| 2e 63 74 7d 0a 40 65 6e | 64 20 65 78 61 6d 70 6c |.ct}.@en|d exampl|
|00002410| 65 0a 40 6e 6f 69 6e 64 | 65 6e 74 0a 54 68 69 73 |e.@noind|ent.This|
|00002420| 20 66 69 6c 65 20 77 6f | 75 6c 64 20 6e 6f 20 6c | file wo|uld no l|
|00002430| 6f 6f 6b 20 61 73 20 66 | 6f 6c 6c 6f 77 73 3a 0a |ook as f|ollows:.|
|00002440| 40 65 78 61 6d 70 6c 65 | 0a 20 20 20 20 23 23 20 |@example|. ## |
|00002450| 76 65 72 73 69 6f 6e 0a | 20 20 20 20 23 23 20 6c |version.| ## l|
|00002460| 61 6e 67 75 61 67 65 0a | 20 20 20 20 23 23 20 63 |anguage.| ## c|
|00002470| 6f 64 65 73 65 74 20 30 | 0a 20 20 20 20 3b 09 43 |odeset 0|. ;.C|
|00002480| 6f 6d 6d 65 6e 74 73 20 | 61 72 20 65 61 6c 6c 6f |omments |ar eallo|
|00002490| 77 65 64 2c 20 6f 66 20 | 63 6f 75 72 73 65 21 20 |wed, of |course! |
|000024a0| 45 61 63 68 20 6c 69 6e | 65 20 62 65 67 69 6e 6e |Each lin|e beginn|
|000024b0| 69 6e 67 20 77 69 74 68 | 20 61 0a 20 20 20 20 3b |ing with| a. ;|
|000024c0| 09 73 65 6d 69 63 6f 6c | 6f 6e 20 69 73 20 61 73 |.semicol|on is as|
|000024d0| 73 75 6d 65 64 20 74 6f | 20 62 65 20 61 20 63 6f |sumed to| be a co|
|000024e0| 6d 6d 65 6e 74 0a 20 20 | 20 20 3b 0a 20 20 20 20 |mment. | ;. |
|000024f0| 3b 09 54 68 65 20 6c 61 | 6e 67 75 61 67 65 20 6f |;.The la|nguage o|
|00002500| 66 20 74 68 65 20 62 75 | 69 6c 74 69 6e 20 73 74 |f the bu|iltin st|
|00002510| 72 69 6e 67 73 3a 0a 20 | 20 20 20 3b 0a 20 20 20 |rings:. | ;. |
|00002520| 20 3b 09 54 68 65 20 63 | 61 74 61 6c 6f 67 20 76 | ;.The c|atalog v|
|00002530| 65 72 73 69 6f 6e 2c 20 | 75 73 65 64 20 66 6f 72 |ersion, |used for|
|00002540| 20 61 20 63 61 6c 6c 20 | 74 6f 20 4c 6f 63 61 6c | a call |to Local|
|00002550| 65 2f 4f 70 65 6e 43 61 | 74 61 6c 6f 67 28 29 2e |e/OpenCa|talog().|
|00002560| 0a 20 20 20 20 3b 09 54 | 68 69 73 20 69 73 20 64 |. ;.T|his is d|
|00002570| 69 66 66 65 72 65 6e 74 | 20 74 6f 20 45 78 65 63 |ifferent| to Exec|
|00002580| 2f 4f 70 65 6e 4c 69 62 | 72 61 72 79 28 29 3a 20 |/OpenLib|rary(): |
|00002590| 30 20 6d 65 61 6e 73 20 | 61 6e 79 20 63 61 74 61 |0 means |any cata|
|000025a0| 6c 6f 67 0a 20 20 20 20 | 3b 09 76 65 72 73 69 6f |log. |;.versio|
|000025b0| 6e 2c 20 6f 74 68 65 72 | 20 6e 75 6d 62 65 72 73 |n, other| numbers|
|000025c0| 20 6d 75 73 74 20 6d 61 | 74 63 68 20 65 78 61 63 | must ma|tch exac|
|000025d0| 74 6c 79 21 0a 20 20 20 | 20 3b 0a 20 20 20 20 3b |tly!. | ;. ;|
|000025e0| 09 54 68 69 73 20 64 65 | 66 69 6e 65 73 20 61 20 |.This de|fines a |
|000025f0| 73 74 72 69 6e 67 20 61 | 6e 64 20 74 68 65 20 49 |string a|nd the I|
|00002600| 44 20 77 68 69 63 68 20 | 61 6c 6c 6f 77 73 20 74 |D which |allows t|
|00002610| 6f 20 75 73 65 20 69 74 | 2e 0a 20 20 20 20 3b 09 |o use it|.. ;.|
|00002620| 54 68 65 20 6e 75 6d 62 | 65 72 20 34 20 73 61 79 |The numb|er 4 say|
|00002630| 73 2c 20 74 68 61 74 20 | 74 68 69 73 20 73 74 72 |s, that |this str|
|00002640| 69 6e 67 20 6d 75 73 74 | 20 6e 6f 74 20 62 65 20 |ing must| not be |
|00002650| 73 68 6f 72 74 65 72 20 | 74 68 61 6e 0a 20 20 20 |shorter |than. |
|00002660| 20 3b 09 34 20 63 68 61 | 72 61 63 74 65 72 73 2e | ;.4 cha|racters.|
|00002670| 0a 20 20 20 20 6d 73 67 | 48 65 6c 6c 6f 0a 0a 20 |. msg|Hello.. |
|00002680| 20 20 20 3b 48 65 6c 6c | 6f 2c 20 77 6f 72 6c 64 | ;Hell|o, world|
|00002690| 21 0a 40 65 6e 64 20 65 | 78 61 6d 70 6c 65 0a 40 |!.@end e|xample.@|
|000026a0| 6e 6f 69 6e 64 65 6e 74 | 0a 59 6f 75 20 73 65 65 |noindent|.You see|
|000026b0| 2c 20 69 74 20 6c 6f 6f | 6b 73 20 6d 75 63 68 20 |, it loo|ks much |
|000026c0| 6c 69 6b 65 20 74 68 65 | 20 63 61 74 61 6c 6f 67 |like the| catalog|
|000026d0| 20 64 65 73 63 72 69 70 | 74 69 6f 6e 73 2e 20 46 | descrip|tions. F|
|000026e0| 6c 65 78 43 61 74 20 69 | 6e 63 6c 75 64 65 73 20 |lexCat i|ncludes |
|000026f0| 74 68 65 0a 63 6f 6d 6d | 65 6e 74 73 20 66 72 6f |the.comm|ents fro|
|00002700| 6d 20 74 68 65 20 63 61 | 74 61 6c 6f 67 20 64 65 |m the ca|talog de|
|00002710| 73 63 72 69 70 74 69 6f | 6e 2c 20 65 76 65 6e 20 |scriptio|n, even |
|00002720| 77 68 65 72 65 20 69 74 | 20 69 73 20 6d 65 61 6e |where it| is mean|
|00002730| 69 6e 67 6c 65 73 73 3a | 20 4e 6f 74 65 0a 74 68 |ingless:| Note.th|
|00002740| 65 20 63 6f 6d 6d 65 6e | 74 20 6f 6e 20 74 68 65 |e commen|t on the|
|00002750| 20 73 74 72 69 6e 67 20 | 6c 65 6e 67 74 68 20 77 | string |length w|
|00002760| 68 69 63 68 20 73 68 6f | 75 6c 64 6e 27 74 20 61 |hich sho|uldn't a|
|00002770| 70 70 65 61 72 20 68 65 | 72 65 20 61 73 20 74 68 |ppear he|re as th|
|00002780| 65 73 65 0a 69 6e 66 6f | 72 6d 61 74 69 6f 6e 73 |ese.info|rmations|
|00002790| 20 6d 75 73 74 20 62 65 | 20 69 6e 20 74 68 65 20 | must be| in the |
|000027a0| 63 61 74 61 6c 6f 67 20 | 64 65 73 63 72 69 70 74 |catalog |descript|
|000027b0| 69 6f 6e 20 6f 6e 6c 79 | 2e 20 41 6c 6c 20 79 6f |ion only|. All yo|
|000027c0| 75 20 68 61 76 65 20 74 | 6f 20 64 6f 0a 6e 6f 77 |u have t|o do.now|
|000027d0| 20 69 73 20 74 6f 20 66 | 69 6c 6c 20 69 6e 20 74 | is to f|ill in t|
|000027e0| 68 65 20 69 6e 66 6f 72 | 6d 61 74 69 6f 6e 73 20 |he infor|mations |
|000027f0| 6f 6e 20 74 68 65 20 76 | 65 72 73 69 6f 6e 20 28 |on the v|ersion (|
|00002800| 61 20 74 79 70 69 63 61 | 6c 20 76 65 72 73 69 6f |a typica|l versio|
|00002810| 6e 20 73 74 72 69 6e 67 | 0a 6c 69 6b 65 20 40 73 |n string|.like @s|
|00002820| 61 6d 70 7b 24 56 45 52 | 3a 20 44 65 75 74 73 63 |amp{$VER|: Deutsc|
|00002830| 68 2e 63 61 74 61 6c 6f | 67 20 31 2e 30 20 28 31 |h.catalo|g 1.0 (1|
|00002840| 31 2e 30 33 2e 39 34 29 | 7d 20 69 73 20 65 78 70 |1.03.94)|} is exp|
|00002850| 65 63 74 65 64 29 2c 20 | 74 68 65 20 6c 61 6e 67 |ected), |the lang|
|00002860| 75 61 67 65 0a 6f 66 20 | 74 68 65 20 63 61 74 61 |uage.of |the cata|
|00002870| 6c 6f 67 20 74 72 61 6e | 73 6c 61 74 69 6f 6e 20 |log tran|slation |
|00002880| 28 40 73 61 6d 70 7b 44 | 65 75 74 73 63 68 7d 20 |(@samp{D|eutsch} |
|00002890| 66 6f 72 20 67 65 72 6d | 61 6e 20 68 65 72 65 29 |for germ|an here)|
|000028a0| 2c 20 74 68 65 20 63 6f | 64 65 73 65 74 0a 28 77 |, the co|deset.(w|
|000028b0| 68 69 63 68 20 73 68 6f | 75 6c 64 20 61 6c 77 61 |hich sho|uld alwa|
|000028c0| 79 73 20 62 65 20 30 20 | 66 6f 72 20 6e 6f 77 2c |ys be 0 |for now,|
|000028d0| 20 73 65 65 20 4c 6f 63 | 61 6c 65 2f 4f 70 65 6e | see Loc|ale/Open|
|000028e0| 43 61 74 61 6c 6f 67 28 | 29 20 66 6f 72 20 64 65 |Catalog(|) for de|
|000028f0| 74 61 69 6c 73 29 0a 61 | 6e 64 20 6f 66 20 63 6f |tails).a|nd of co|
|00002900| 75 72 73 65 20 74 68 65 | 20 73 74 72 69 6e 67 73 |urse the| strings|
|00002910| 20 69 74 73 65 6c 66 2e | 20 46 6c 65 78 43 61 74 | itself.| FlexCat|
|00002920| 20 69 6e 63 6c 75 64 65 | 73 20 74 68 65 20 6f 72 | include|s the or|
|00002930| 69 67 69 6e 61 6c 20 73 | 74 72 69 6e 67 73 0a 61 |iginal s|trings.a|
|00002940| 73 20 63 6f 6d 6d 65 6e | 74 73 2c 20 73 6f 20 79 |s commen|ts, so y|
|00002950| 6f 75 20 61 6c 77 61 79 | 73 20 6b 6e 6f 77 20 77 |ou alway|s know w|
|00002960| 68 61 74 20 74 6f 20 66 | 69 6c 6c 20 69 6e 2e 0a |hat to f|ill in..|
|00002970| 46 69 6e 61 6c 6c 79 20 | 79 6f 75 20 63 72 65 61 |Finally |you crea|
|00002980| 74 65 20 74 68 65 20 63 | 61 74 61 6c 6f 67 73 20 |te the c|atalogs |
|00002990| 77 69 74 68 20 63 6f 6d | 6d 61 6e 64 73 20 6c 69 |with com|mands li|
|000029a0| 6b 65 0a 40 65 78 61 6d | 70 6c 65 0a 20 20 20 20 |ke.@exam|ple. |
|000029b0| 40 73 61 6d 70 7b 46 6c | 65 78 43 61 74 20 48 65 |@samp{Fl|exCat He|
|000029c0| 6c 6c 6f 4c 6f 63 61 6c | 57 6f 72 6c 64 2e 63 64 |lloLocal|World.cd|
|000029d0| 20 44 65 75 74 73 63 68 | 2e 63 74 20 43 41 54 41 | Deutsch|.ct CATA|
|000029e0| 4c 4f 47 20 44 65 75 74 | 73 63 68 2e 63 61 74 61 |LOG Deut|sch.cata|
|000029f0| 6c 6f 67 7d 0a 40 65 6e | 64 20 65 78 61 6d 70 6c |log}.@en|d exampl|
|00002a00| 65 0a 40 6e 6f 69 6e 64 | 65 6e 74 0a 4e 6f 74 65 |e.@noind|ent.Note|
|00002a10| 2c 20 74 68 61 74 20 79 | 6f 75 20 64 6f 6e 27 74 |, that y|ou don't|
|00002a20| 20 6e 65 65 64 20 74 68 | 65 20 70 72 6f 67 72 61 | need th|e progra|
|00002a30| 6d 20 69 74 73 65 6c 66 | 20 6f 72 20 74 68 65 20 |m itself| or the |
|00002a40| 73 6f 75 72 63 65 20 66 | 69 6c 65 73 20 63 72 65 |source f|iles cre|
|00002a50| 61 74 65 64 0a 77 69 74 | 68 20 46 6c 65 78 43 61 |ated.wit|h FlexCa|
|00002a60| 74 20 66 6f 72 20 74 68 | 65 20 63 61 74 61 6c 6f |t for th|e catalo|
|00002a70| 67 73 21 20 59 6f 75 20 | 63 61 6e 20 63 72 65 61 |gs! You |can crea|
|00002a80| 74 65 20 6e 65 77 20 63 | 61 74 61 6c 6f 67 73 20 |te new c|atalogs |
|00002a90| 61 74 20 61 6e 79 20 74 | 69 6d 65 2e 0a 49 74 20 |at any t|ime..It |
|00002aa0| 69 73 20 75 73 75 61 6c | 20 74 6f 20 73 75 70 70 |is usual| to supp|
|00002ab0| 6c 79 20 64 69 73 74 72 | 69 62 75 74 69 6f 6e 73 |ly distr|ibutions|
|00002ac0| 20 77 69 74 68 20 61 20 | 66 69 6c 65 20 4e 65 77 | with a |file New|
|00002ad0| 43 61 74 61 6c 6f 67 2e | 63 74 2c 20 73 6f 20 75 |Catalog.|ct, so u|
|00002ae0| 73 65 72 73 0a 63 61 6e | 20 63 72 65 61 74 65 20 |sers.can| create |
|00002af0| 6f 77 6e 20 63 61 74 61 | 6c 6f 67 73 2e 0a 0a 42 |own cata|logs...B|
|00002b00| 75 74 20 77 68 61 74 20 | 68 61 70 70 65 6e 73 20 |ut what |happens |
|00002b10| 69 66 20 79 6f 75 20 63 | 68 61 6e 67 65 20 74 68 |if you c|hange th|
|00002b20| 65 20 70 72 6f 67 72 61 | 6d 20 6c 61 74 65 72 3f |e progra|m later?|
|00002b30| 20 4a 75 73 74 20 65 64 | 69 74 20 74 68 65 20 63 | Just ed|it the c|
|00002b40| 61 74 61 6c 6f 67 0a 64 | 65 73 63 72 69 70 74 69 |atalog.d|escripti|
|00002b50| 6f 6e 20 61 6e 64 20 75 | 73 65 20 46 6c 65 78 43 |on and u|se FlexC|
|00002b60| 61 74 20 74 6f 20 75 70 | 64 61 74 65 20 74 68 65 |at to up|date the|
|00002b70| 20 63 61 74 61 6c 6f 67 | 20 74 72 61 6e 73 6c 61 | catalog| transla|
|00002b80| 74 69 6f 6e 73 3a 0a 40 | 65 78 61 6d 70 6c 65 0a |tions:.@|example.|
|00002b90| 20 20 20 20 40 73 61 6d | 70 7b 46 6c 65 78 43 61 | @sam|p{FlexCa|
|00002ba0| 74 20 48 65 6c 6c 6f 4c | 6f 63 61 6c 57 6f 72 6c |t HelloL|ocalWorl|
|00002bb0| 64 2e 63 64 20 44 65 75 | 74 73 63 68 2e 63 74 20 |d.cd Deu|tsch.ct |
|00002bc0| 4e 45 57 43 54 46 49 4c | 45 20 44 65 75 74 73 63 |NEWCTFIL|E Deutsc|
|00002bd0| 68 2e 63 74 7d 0a 40 65 | 6e 64 20 65 78 61 6d 70 |h.ct}.@e|nd examp|
|00002be0| 6c 65 0a 40 6e 6f 69 6e | 64 65 6e 74 0a 41 6c 6c |le.@noin|dent.All|
|00002bf0| 20 79 6f 75 20 6e 65 65 | 64 20 74 6f 20 64 6f 20 | you nee|d to do |
|00002c00| 6e 6f 77 20 69 73 20 74 | 6f 20 65 6e 74 65 72 20 |now is t|o enter |
|00002c10| 6e 65 77 20 73 74 72 69 | 6e 67 73 20 69 66 20 6e |new stri|ngs if n|
|00002c20| 65 65 64 65 64 2e 0a 0a | 0a 0a 40 6e 6f 64 65 20 |eeded...|..@node |
|00002c30| 49 6e 73 74 61 6c 6c 61 | 74 69 6f 6e 0a 40 63 68 |Installa|tion.@ch|
|00002c40| 61 70 74 65 72 20 49 6e | 73 74 61 6c 6c 61 74 69 |apter In|stallati|
|00002c50| 6f 6e 0a 40 63 69 6e 64 | 65 78 20 49 6e 73 74 61 |on.@cind|ex Insta|
|00002c60| 6c 6c 61 74 69 6f 6e 0a | 40 63 69 6e 64 65 78 20 |llation.|@cindex |
|00002c70| 52 65 71 75 69 72 65 6d | 65 6e 74 73 0a 46 6c 65 |Requirem|ents.Fle|
|00002c80| 78 43 61 74 20 69 73 20 | 77 72 69 74 74 65 6e 20 |xCat is |written |
|00002c90| 69 6e 20 70 75 72 65 20 | 41 6e 73 69 2d 43 20 28 |in pure |Ansi-C (|
|00002ca0| 65 78 63 65 70 74 20 66 | 6f 72 20 74 68 65 20 6c |except f|or the l|
|00002cb0| 6f 63 61 6c 69 7a 61 74 | 69 6f 6e 29 2c 20 68 65 |ocalizat|ion), he|
|00002cc0| 6e 63 65 20 69 74 0a 73 | 68 6f 75 6c 64 20 72 75 |nce it.s|hould ru|
|00002cd0| 6e 20 6f 6e 20 61 6e 79 | 20 41 6d 69 67 61 20 61 |n on any| Amiga a|
|00002ce0| 6e 64 20 68 6f 70 65 66 | 75 6c 6c 79 20 6f 6e 20 |nd hopef|ully on |
|00002cf0| 6f 74 68 65 72 20 6d 61 | 63 68 69 6e 65 73 20 61 |other ma|chines a|
|00002d00| 66 74 65 72 20 72 65 63 | 6f 6d 70 69 6c 69 6e 67 |fter rec|ompiling|
|00002d10| 2e 0a 28 54 68 65 20 6c | 6f 63 61 6c 69 7a 69 6e |..(The l|ocalizin|
|00002d20| 67 20 69 73 20 63 6f 6d | 6d 65 6e 74 65 64 20 6f |g is com|mented o|
|00002d30| 75 74 20 69 6e 20 74 68 | 61 74 20 63 61 73 65 2e |ut in th|at case.|
|00002d40| 29 20 54 68 69 73 20 68 | 6f 6c 64 73 20 66 6f 72 |) This h|olds for|
|00002d50| 20 74 68 65 20 63 72 65 | 61 74 65 64 0a 70 72 6f | the cre|ated.pro|
|00002d60| 67 72 61 6d 73 20 74 6f | 6f 3a 20 46 6c 65 78 43 |grams to|o: FlexC|
|00002d70| 61 74 20 69 73 20 77 72 | 69 74 74 65 6e 20 75 73 |at is wr|itten us|
|00002d80| 69 6e 67 20 69 74 73 65 | 6c 66 2e 20 41 6c 6c 20 |ing itse|lf. All |
|00002d90| 64 69 73 74 72 69 62 75 | 74 65 64 20 73 6f 75 72 |distribu|ted sour|
|00002da0| 63 65 0a 64 65 73 63 72 | 69 70 74 69 6f 6e 73 20 |ce.descr|iptions |
|00002db0| 73 68 6f 75 6c 64 20 63 | 72 65 61 74 65 20 70 72 |should c|reate pr|
|00002dc0| 6f 67 72 61 6d 73 20 72 | 75 6e 6e 69 6e 67 20 6f |ograms r|unning o|
|00002dd0| 6e 20 61 6e 79 20 41 6d | 69 67 61 20 61 6e 64 20 |n any Am|iga and |
|00002de0| 65 76 65 6e 20 61 6e 79 | 0a 6d 61 63 68 69 6e 65 |even any|.machine|
|00002df0| 2e 20 28 4f 66 20 63 6f | 75 72 73 65 20 79 6f 75 |. (Of co|urse you|
|00002e00| 20 6d 75 73 74 20 65 6e | 73 75 72 65 20 74 68 61 | must en|sure tha|
|00002e10| 74 20 74 68 65 20 76 61 | 72 69 61 62 6c 65 20 4c |t the va|riable L|
|00002e20| 6f 63 61 6c 65 42 61 73 | 65 20 68 61 73 20 74 68 |ocaleBas|e has th|
|00002e30| 65 0a 76 61 6c 75 65 20 | 40 73 61 6d 70 7b 4e 55 |e.value |@samp{NU|
|00002e40| 4c 4c 7d 20 69 6e 20 74 | 68 65 20 6c 61 74 74 65 |LL} in t|he latte|
|00002e50| 72 20 63 61 73 65 2e 29 | 20 4c 6f 63 61 6c 69 7a |r case.)| Localiz|
|00002e60| 69 6e 67 2c 20 68 6f 77 | 65 76 65 72 2c 20 69 73 |ing, how|ever, is|
|00002e70| 20 70 6f 73 73 69 62 6c | 65 0a 62 65 67 69 6e 6e | possibl|e.beginn|
|00002e80| 69 6e 67 20 77 69 74 68 | 20 57 6f 72 6b 62 65 6e |ing with| Workben|
|00002e90| 63 68 20 32 2e 31 20 62 | 65 63 61 75 73 65 20 74 |ch 2.1 b|ecause t|
|00002ea0| 68 65 20 40 63 6f 64 65 | 7b 6c 6f 63 61 6c 65 2e |he @code|{locale.|
|00002eb0| 6c 69 62 72 61 72 79 7d | 20 69 73 6e 27 74 0a 61 |library}| isn't.a|
|00002ec0| 76 61 69 6c 61 62 6c 65 | 20 62 65 6c 6f 77 2e 0a |vailable| below..|
|00002ed0| 0a 49 74 20 69 73 20 6e | 6f 74 20 69 6d 70 6f 73 |.It is n|ot impos|
|00002ee0| 73 69 62 6c 65 20 74 6f | 20 6f 66 66 65 72 20 6c |sible to| offer l|
|00002ef0| 6f 63 61 6c 69 7a 69 6e | 67 20 77 69 74 68 6f 75 |ocalizin|g withou|
|00002f00| 74 20 74 68 65 20 40 63 | 6f 64 65 7b 6c 6f 63 61 |t the @c|ode{loca|
|00002f10| 6c 65 2e 6c 69 62 72 61 | 72 79 7d 3a 0a 54 68 65 |le.libra|ry}:.The|
|00002f20| 20 73 6f 75 72 63 65 20 | 64 65 73 63 72 69 70 74 | source |descript|
|00002f30| 69 6f 6e 20 66 69 6c 65 | 73 20 40 66 69 6c 65 7b |ion file|s @file{|
|00002f40| 43 5f 63 5f 56 32 30 2e | 73 64 7d 20 61 6e 64 20 |C_c_V20.|sd} and |
|00002f50| 40 66 69 6c 65 7b 43 5f | 68 5f 56 32 30 2e 73 64 |@file{C_|h_V20.sd|
|00002f60| 7d 20 67 69 76 65 0a 61 | 6e 20 65 78 61 6d 70 6c |} give.a|n exampl|
|00002f70| 65 2c 20 77 68 65 72 65 | 20 74 68 65 20 40 63 6f |e, where| the @co|
|00002f80| 64 65 7b 69 66 66 70 61 | 72 73 65 2e 6c 69 62 72 |de{iffpa|rse.libr|
|00002f90| 61 72 79 7d 20 69 73 20 | 75 73 65 64 20 74 6f 20 |ary} is |used to |
|00002fa0| 72 65 70 6c 61 63 65 20 | 74 68 65 0a 40 63 6f 64 |replace |the.@cod|
|00002fb0| 65 7b 6c 6f 63 61 6c 65 | 2e 6c 69 62 72 61 72 79 |e{locale|.library|
|00002fc0| 7d 2c 20 69 66 20 69 74 | 20 69 73 20 6e 6f 74 20 |}, if it| is not |
|00002fd0| 61 76 61 69 6c 61 62 6c | 65 2e 20 54 68 69 73 20 |availabl|e. This |
|00002fe0| 67 69 76 65 73 20 4c 6f | 63 61 6c 69 7a 69 6e 67 |gives Lo|calizing|
|00002ff0| 20 66 6f 72 0a 57 6f 72 | 6b 62 65 6e 63 68 20 32 | for.Wor|kbench 2|
|00003000| 2e 30 2e 20 40 78 72 65 | 66 7b 43 7d 2e 0a 0a 49 |.0. @xre|f{C}...I|
|00003010| 6e 73 74 61 6c 6c 69 6e | 67 20 46 6c 65 78 43 61 |nstallin|g FlexCa|
|00003020| 74 20 69 73 20 73 69 6d | 70 6c 65 3a 20 4a 75 73 |t is sim|ple: Jus|
|00003030| 74 20 63 6f 70 79 20 74 | 68 65 20 70 72 6f 67 72 |t copy t|he progr|
|00003040| 61 6d 20 74 6f 20 61 20 | 64 69 72 65 63 74 6f 72 |am to a |director|
|00003050| 79 20 69 6e 20 79 6f 75 | 72 0a 73 65 61 72 63 68 |y in you|r.search|
|00003060| 20 70 61 74 68 20 61 6e | 64 20 73 65 6c 65 63 74 | path an|d select|
|00003070| 20 61 20 70 6c 61 63 65 | 20 66 6f 72 20 74 68 65 | a place| for the|
|00003080| 20 73 6f 75 72 63 65 20 | 64 65 73 63 72 69 70 74 | source |descript|
|00003090| 69 6f 6e 73 20 79 6f 75 | 20 6e 65 65 64 2e 0a 28 |ions you| need..(|
|000030a0| 54 68 65 73 65 20 61 72 | 65 20 74 68 65 20 66 69 |These ar|e the fi|
|000030b0| 6c 65 73 20 63 61 6c 6c | 65 64 20 73 6f 6d 65 74 |les call|ed somet|
|000030c0| 68 69 6e 67 20 6c 69 6b | 65 20 40 66 69 6c 65 7b |hing lik|e @file{|
|000030d0| 78 78 5f 79 79 2e 73 64 | 7d 2c 20 77 68 65 72 65 |xx_yy.sd|}, where|
|000030e0| 20 40 66 69 6c 65 7b 78 | 78 7d 0a 69 73 20 74 68 | @file{x|x}.is th|
|000030f0| 65 20 70 72 6f 67 72 61 | 6d 6d 69 6e 67 20 6c 61 |e progra|mming la|
|00003100| 6e 67 75 61 67 65 2e 29 | 20 50 72 6f 62 61 62 6c |nguage.)| Probabl|
|00003110| 79 20 79 6f 75 20 77 61 | 6e 74 20 74 6f 20 73 65 |y you wa|nt to se|
|00003120| 74 20 74 68 65 0a 65 6e | 76 69 72 6f 6e 6d 65 6e |t the.en|vironmen|
|00003130| 74 20 76 61 72 69 61 62 | 6c 65 20 40 76 61 72 7b |t variab|le @var{|
|00003140| 46 4c 45 58 43 41 54 5f | 53 44 44 49 52 7d 2e 20 |FLEXCAT_|SDDIR}. |
|00003150| 40 78 72 65 66 7b 50 72 | 6f 67 72 61 6d 20 73 74 |@xref{Pr|ogram st|
|00003160| 61 72 74 7d 2e 0a 0a 49 | 66 20 79 6f 75 20 77 61 |art}...I|f you wa|
|00003170| 6e 74 20 74 6f 20 75 73 | 65 20 46 6c 65 78 43 61 |nt to us|e FlexCa|
|00003180| 74 20 69 6e 20 61 6e 6f | 74 68 65 72 20 6c 61 6e |t in ano|ther lan|
|00003190| 67 75 61 67 65 0a 74 68 | 61 6e 20 74 68 65 20 65 |guage.th|an the e|
|000031a0| 6e 67 6c 69 73 68 20 79 | 6f 75 20 6e 65 65 64 20 |nglish y|ou need |
|000031b0| 74 6f 20 63 6f 70 79 20 | 74 68 65 20 72 65 73 70 |to copy |the resp|
|000031c0| 65 63 74 69 76 65 20 63 | 61 74 61 6c 6f 67 20 66 |ective c|atalog f|
|000031d0| 69 6c 65 73 20 74 6f 6f | 2e 20 45 2e 67 2e 20 66 |iles too|. E.g. f|
|000031e0| 6f 72 0a 74 68 65 20 67 | 65 72 6d 61 6e 20 6c 61 |or.the g|erman la|
|000031f0| 6e 67 75 61 67 65 0a 63 | 6f 70 79 20 74 68 65 20 |nguage.c|opy the |
|00003200| 66 69 6c 65 20 40 66 69 | 6c 65 7b 43 61 74 61 6c |file @fi|le{Catal|
|00003210| 6f 67 73 2f 44 65 75 74 | 73 63 68 2f 46 6c 65 78 |ogs/Deut|sch/Flex|
|00003220| 43 61 74 2e 63 61 74 61 | 6c 6f 67 7d 20 74 6f 0a |Cat.cata|log} to.|
|00003230| 40 66 69 6c 65 7b 4c 6f | 63 61 6c 65 3a 43 61 74 |@file{Lo|cale:Cat|
|00003240| 61 6c 6f 67 73 2f 44 65 | 75 74 73 63 68 2f 46 6c |alogs/De|utsch/Fl|
|00003250| 65 78 43 61 74 2e 63 61 | 74 61 6c 6f 67 7d 20 6f |exCat.ca|talog} o|
|00003260| 72 20 74 6f 0a 40 66 69 | 6c 65 7b 50 52 4f 47 44 |r to.@fi|le{PROGD|
|00003270| 49 52 3a 43 61 74 61 6c | 6f 67 73 2f 44 65 75 74 |IR:Catal|ogs/Deut|
|00003280| 73 63 68 2f 46 6c 65 78 | 43 61 74 2e 63 61 74 61 |sch/Flex|Cat.cata|
|00003290| 6c 6f 67 7d 2c 20 77 68 | 65 72 65 20 40 66 69 6c |log}, wh|ere @fil|
|000032a0| 65 7b 50 52 4f 47 44 49 | 52 3a 7d 0a 69 73 20 46 |e{PROGDI|R:}.is F|
|000032b0| 6c 65 78 43 61 74 27 73 | 20 70 72 6f 67 72 61 6d |lexCat's| program|
|000032c0| 20 64 69 72 65 63 74 6f | 72 79 2e 20 40 78 72 65 | directo|ry. @xre|
|000032d0| 66 7b 55 73 69 6e 67 20 | 46 6c 65 78 43 61 74 20 |f{Using |FlexCat |
|000032e0| 73 6f 75 72 63 65 7d 2e | 0a 0a 0a 0a 40 6e 6f 64 |source}.|....@nod|
|000032f0| 65 20 50 72 6f 67 72 61 | 6d 20 73 74 61 72 74 0a |e Progra|m start.|
|00003300| 40 63 68 61 70 74 65 72 | 20 43 61 6c 6c 69 6e 67 |@chapter| Calling|
|00003310| 20 46 6c 65 78 43 61 74 | 20 66 72 6f 6d 20 74 68 | FlexCat| from th|
|00003320| 65 20 43 4c 49 0a 40 63 | 69 6e 64 65 78 20 43 4c |e CLI.@c|index CL|
|00003330| 49 0a 40 63 69 6e 64 65 | 78 20 57 6f 72 6b 62 65 |I.@cinde|x Workbe|
|00003340| 6e 63 68 0a 46 6c 65 78 | 43 61 74 20 69 73 20 61 |nch.Flex|Cat is a|
|00003350| 20 43 4c 49 20 62 61 73 | 65 64 20 70 72 6f 67 72 | CLI bas|ed progr|
|00003360| 61 6d 20 61 6e 64 20 64 | 6f 65 73 6e 27 74 20 6f |am and d|oesn't o|
|00003370| 70 65 72 61 74 65 20 66 | 72 6f 6d 20 74 68 65 20 |perate f|rom the |
|00003380| 77 6f 72 6b 62 65 6e 63 | 68 2e 0a 49 74 27 73 20 |workbenc|h..It's |
|00003390| 63 61 6c 6c 69 6e 67 20 | 73 79 6e 74 61 78 20 69 |calling |syntax i|
|000033a0| 73 0a 40 65 78 61 6d 70 | 6c 65 0a 20 20 20 20 46 |s.@examp|le. F|
|000033b0| 6c 65 78 43 61 74 20 43 | 44 46 49 4c 45 2f 61 2c |lexCat C|DFILE/a,|
|000033c0| 43 54 46 49 4c 45 2c 43 | 41 54 41 4c 4f 47 2f 6b |CTFILE,C|ATALOG/k|
|000033d0| 2c 4e 45 57 43 54 46 49 | 4c 45 2f 6b 2c 53 4f 55 |,NEWCTFI|LE/k,SOU|
|000033e0| 52 43 45 53 2f 6d 0a 40 | 65 6e 64 20 65 78 61 6d |RCES/m.@|end exam|
|000033f0| 70 6c 65 0a 40 6e 6f 69 | 6e 64 65 6e 74 0a 77 68 |ple.@noi|ndent.wh|
|00003400| 65 72 65 20 74 68 65 20 | 61 72 67 75 6d 65 6e 74 |ere the |argument|
|00003410| 73 20 6d 65 61 6e 0a 40 | 74 61 62 6c 65 20 40 73 |s mean.@|table @s|
|00003420| 74 72 6f 6e 67 0a 40 69 | 74 65 6d 20 43 44 46 49 |trong.@i|tem CDFI|
|00003430| 4c 45 0a 69 73 20 74 68 | 65 20 6e 61 6d 65 20 6f |LE.is th|e name o|
|00003440| 66 20 61 20 63 61 74 61 | 6c 6f 67 20 64 65 73 63 |f a cata|log desc|
|00003450| 72 69 70 74 69 6f 6e 20 | 74 6f 20 62 65 20 72 65 |ription |to be re|
|00003460| 61 64 2e 20 54 68 69 73 | 20 69 73 20 61 6c 77 61 |ad. This| is alwa|
|00003470| 79 73 20 6e 65 65 64 65 | 64 2e 0a 50 6c 65 61 73 |ys neede|d..Pleas|
|00003480| 65 20 6e 6f 74 65 2c 20 | 74 68 61 74 20 74 68 65 |e note, |that the|
|00003490| 20 62 61 73 65 20 6e 61 | 6d 65 20 6f 66 20 74 68 | base na|me of th|
|000034a0| 65 20 73 6f 75 72 63 65 | 20 64 65 73 63 72 69 70 |e source| descrip|
|000034b0| 74 69 6f 6e 20 69 73 20 | 63 72 65 61 74 65 64 20 |tion is |created |
|000034c0| 66 72 6f 6d 0a 69 74 20 | 6d 61 6b 69 6e 67 20 74 |from.it |making t|
|000034d0| 68 69 73 20 63 61 73 65 | 20 73 69 67 6e 69 66 69 |his case| signifi|
|000034e0| 63 61 6e 74 2e 20 40 78 | 72 65 66 7b 53 6f 75 72 |cant. @x|ref{Sour|
|000034f0| 63 65 20 64 65 73 63 72 | 69 70 74 69 6f 6e 7d 2e |ce descr|iption}.|
|00003500| 0a 40 69 74 65 6d 20 43 | 54 46 49 4c 45 0a 69 73 |.@item C|TFILE.is|
|00003510| 20 74 68 65 20 6e 61 6d | 65 20 6f 66 20 61 20 63 | the nam|e of a c|
|00003520| 61 74 61 6c 6f 67 20 74 | 72 61 6e 73 6c 61 74 69 |atalog t|ranslati|
|00003530| 6f 6e 20 66 69 6c 65 20 | 74 6f 20 62 65 20 72 65 |on file |to be re|
|00003540| 61 64 2e 20 54 68 69 73 | 20 69 73 20 6e 65 65 64 |ad. This| is need|
|00003550| 65 64 20 66 6f 72 0a 63 | 72 65 61 74 69 6e 67 20 |ed for.c|reating |
|00003560| 63 61 74 61 6c 6f 67 73 | 20 6f 72 20 66 6f 72 20 |catalogs| or for |
|00003570| 75 70 64 61 74 69 6e 67 | 20 61 6e 20 6f 6c 64 20 |updating| an old |
|00003580| 63 61 74 61 6c 6f 67 20 | 74 72 61 6e 73 6c 61 74 |catalog |translat|
|00003590| 69 6f 6e 20 66 69 6c 65 | 20 75 73 69 6e 67 0a 74 |ion file| using.t|
|000035a0| 68 65 20 4e 45 57 43 54 | 46 49 4c 45 20 61 72 67 |he NEWCT|FILE arg|
|000035b0| 75 6d 65 6e 74 3a 20 46 | 6c 65 78 43 61 74 20 72 |ument: F|lexCat r|
|000035c0| 65 61 64 73 20 74 68 65 | 20 6f 6c 64 20 66 69 6c |eads the| old fil|
|000035d0| 65 20 61 6e 64 20 74 68 | 65 20 63 61 74 61 6c 6f |e and th|e catalo|
|000035e0| 67 0a 64 65 73 63 72 69 | 70 74 69 6f 6e 20 61 6e |g.descri|ption an|
|000035f0| 64 20 63 72 65 61 74 65 | 73 20 61 20 6e 65 77 20 |d create|s a new |
|00003600| 63 61 74 61 6c 6f 67 20 | 74 72 61 6e 73 6c 61 74 |catalog |translat|
|00003610| 69 6f 6e 20 66 69 6c 65 | 20 63 6f 6e 74 61 69 6e |ion file| contain|
|00003620| 69 6e 67 20 74 68 65 0a | 6f 6c 64 20 73 74 72 69 |ing the.|old stri|
|00003630| 6e 67 73 20 61 6e 64 20 | 70 6f 73 73 69 62 6c 79 |ngs and |possibly|
|00003640| 20 73 6f 6d 65 20 65 6d | 70 74 79 20 6c 69 6e 65 | some em|pty line|
|00003650| 73 20 66 6f 72 20 6e 65 | 77 20 73 74 72 69 6e 67 |s for ne|w string|
|00003660| 73 2e 0a 40 69 74 65 6d | 20 43 41 54 41 4c 4f 47 |s..@item| CATALOG|
|00003670| 0a 69 73 20 74 68 65 20 | 6e 61 6d 65 20 6f 66 20 |.is the |name of |
|00003680| 61 20 63 61 74 61 6c 6f | 67 20 66 69 6c 65 20 74 |a catalo|g file t|
|00003690| 6f 20 62 65 20 63 72 65 | 61 74 65 64 2e 20 54 68 |o be cre|ated. Th|
|000036a0| 69 73 20 61 72 67 75 6d | 65 6e 74 20 72 65 71 75 |is argum|ent requ|
|000036b0| 69 72 65 73 20 67 69 76 | 69 6e 67 0a 43 44 46 49 |ires giv|ing.CDFI|
|000036c0| 4c 45 20 61 73 20 77 65 | 6c 6c 2e 0a 40 69 74 65 |LE as we|ll..@ite|
|000036d0| 6d 20 4e 45 57 43 54 46 | 49 4c 45 0a 69 73 20 74 |m NEWCTF|ILE.is t|
|000036e0| 68 65 20 6e 61 6d 65 20 | 6f 66 20 61 20 63 61 74 |he name |of a cat|
|000036f0| 61 6c 6f 67 20 74 72 61 | 6e 73 6c 61 74 69 6f 6e |alog tra|nslation|
|00003700| 20 66 69 6c 65 20 74 6f | 20 63 72 65 61 74 65 2e | file to| create.|
|00003710| 20 46 6c 65 78 43 61 74 | 20 72 65 61 64 73 20 73 | FlexCat| reads s|
|00003720| 74 72 69 6e 67 73 0a 66 | 72 6f 6d 20 43 54 46 49 |trings.f|rom CTFI|
|00003730| 4c 45 2c 20 69 66 20 74 | 68 69 73 20 69 73 20 67 |LE, if t|his is g|
|00003740| 69 76 65 6e 2c 20 73 74 | 72 69 6e 67 73 20 6d 69 |iven, st|rings mi|
|00003750| 73 73 69 6e 67 20 69 6e | 20 74 68 65 20 63 61 74 |ssing in| the cat|
|00003760| 61 6c 6f 67 20 74 72 61 | 6e 73 6c 61 74 69 6f 6e |alog tra|nslation|
|00003770| 0a 61 72 65 20 72 65 70 | 6c 61 63 65 64 20 62 79 |.are rep|laced by|
|00003780| 20 65 6d 70 74 79 20 6c | 69 6e 65 73 2e 20 28 54 | empty l|ines. (T|
|00003790| 68 65 20 6e 65 77 20 63 | 61 74 61 6c 6f 67 20 74 |he new c|atalog t|
|000037a0| 72 61 6e 73 6c 61 74 69 | 6f 6e 20 77 69 6c 6c 20 |ranslati|on will |
|000037b0| 63 6f 6e 74 61 69 6e 0a | 6f 6e 6c 79 20 65 6d 70 |contain.|only emp|
|000037c0| 74 79 20 6c 69 6e 65 73 | 20 61 73 20 73 74 72 69 |ty lines| as stri|
|000037d0| 6e 67 73 2c 20 69 66 20 | 43 54 46 49 4c 45 20 69 |ngs, if |CTFILE i|
|000037e0| 73 20 6f 6d 69 74 74 65 | 64 2e 29 0a 40 69 74 65 |s omitte|d.).@ite|
|000037f0| 6d 20 53 4f 55 52 43 45 | 53 0a 61 72 65 20 74 68 |m SOURCE|S.are th|
|00003800| 65 20 6e 61 6d 65 73 20 | 6f 66 20 73 6f 75 72 63 |e names |of sourc|
|00003810| 65 20 66 69 6c 65 73 20 | 74 6f 20 62 65 20 63 72 |e files |to be cr|
|00003820| 65 61 74 65 64 2e 20 54 | 68 65 73 65 20 73 68 6f |eated. T|hese sho|
|00003830| 75 64 20 62 65 20 67 69 | 76 65 6e 20 69 6e 20 74 |ud be gi|ven in t|
|00003840| 68 65 0a 66 6f 72 6d 20 | 40 73 61 6d 70 7b 73 6f |he.form |@samp{so|
|00003850| 75 72 63 65 3d 74 65 6d | 70 6c 61 74 65 7d 20 77 |urce=tem|plate} w|
|00003860| 68 65 72 65 20 40 66 69 | 6c 65 7b 73 6f 75 72 63 |here @fi|le{sourc|
|00003870| 65 7d 20 69 73 20 74 68 | 65 20 66 69 6c 65 20 74 |e} is th|e file t|
|00003880| 6f 20 63 72 65 61 74 65 | 20 61 6e 64 0a 40 73 61 |o create| and.@sa|
|00003890| 6d 70 7b 74 65 6d 70 6c | 61 74 65 7d 20 69 73 20 |mp{templ|ate} is |
|000038a0| 74 68 65 20 6e 61 6d 65 | 20 6f 66 20 61 20 73 6f |the name| of a so|
|000038b0| 75 72 63 65 20 64 65 73 | 63 72 69 70 74 69 6f 6e |urce des|cription|
|000038c0| 20 66 69 6c 65 20 74 6f | 20 62 65 20 73 63 61 6e | file to| be scan|
|000038d0| 6e 65 64 2e 0a 0a 49 66 | 20 74 68 65 20 73 6f 75 |ned...If| the sou|
|000038e0| 72 63 65 20 64 65 73 63 | 72 69 70 74 69 6f 6e 20 |rce desc|ription |
|000038f0| 69 73 6e 27 74 20 66 6f | 75 6e 64 2c 20 46 6c 65 |isn't fo|und, Fle|
|00003900| 78 43 61 74 20 74 72 69 | 65 73 20 74 6f 20 6f 70 |xCat tri|es to op|
|00003910| 65 6e 20 61 20 66 69 6c | 65 20 77 69 74 68 0a 74 |en a fil|e with.t|
|00003920| 68 65 20 73 61 6d 65 20 | 6e 61 6d 65 20 69 6e 20 |he same |name in |
|00003930| 74 68 65 20 64 69 72 65 | 63 74 6f 72 79 20 40 66 |the dire|ctory @f|
|00003940| 69 6c 65 7b 50 52 4f 47 | 44 49 52 3a 6c 69 62 7d |ile{PROG|DIR:lib}|
|00003950| 2e 20 28 54 68 65 20 73 | 75 62 64 69 72 65 63 74 |. (The s|ubdirect|
|00003960| 6f 72 79 0a 40 66 69 6c | 65 7b 6c 69 62 7d 20 6f |ory.@fil|e{lib} o|
|00003970| 66 20 74 68 65 20 64 69 | 72 65 63 74 6f 72 79 20 |f the di|rectory |
|00003980| 77 68 65 72 65 20 74 68 | 65 20 62 69 6e 61 72 79 |where th|e binary|
|00003990| 20 46 6c 65 78 43 61 74 | 20 69 74 73 65 6c 66 20 | FlexCat| itself |
|000039a0| 6c 69 76 65 73 2e 29 0a | 59 6f 75 20 63 61 6e 20 |lives.).|You can |
|000039b0| 6f 76 65 72 77 72 69 74 | 65 20 74 68 69 73 20 64 |overwrit|e this d|
|000039c0| 65 66 61 75 6c 74 20 77 | 69 74 68 20 74 68 65 20 |efault w|ith the |
|000039d0| 65 6e 76 69 72 6f 6e 6d | 65 6e 74 20 76 61 72 69 |environm|ent vari|
|000039e0| 61 62 6c 65 0a 40 76 61 | 72 7b 46 4c 45 58 43 41 |able.@va|r{FLEXCA|
|000039f0| 54 5f 53 44 44 49 52 7d | 2e 20 45 78 61 6d 70 6c |T_SDDIR}|. Exampl|
|00003a00| 65 3a 0a 40 65 78 61 6d | 70 6c 65 0a 20 20 20 20 |e:.@exam|ple. |
|00003a10| 40 73 61 6d 70 7b 46 6c | 65 78 43 61 74 20 46 6c |@samp{Fl|exCat Fl|
|00003a20| 65 78 43 61 74 2e 63 64 | 20 46 6c 65 78 43 61 74 |exCat.cd| FlexCat|
|00003a30| 5f 43 61 74 2e 63 3d 54 | 65 6d 70 6c 61 74 65 73 |_Cat.c=T|emplates|
|00003a40| 2f 43 5f 63 5f 56 32 30 | 2e 73 64 7d 0a 40 65 6e |/C_c_V20|.sd}.@en|
|00003a50| 64 20 65 78 61 6d 70 6c | 65 0a 40 6e 6f 69 6e 64 |d exampl|e.@noind|
|00003a60| 65 6e 74 0a 77 6f 75 6c | 64 20 6c 6f 6f 6b 20 66 |ent.woul|d look f|
|00003a70| 6f 72 20 61 20 66 69 6c | 65 20 40 66 69 6c 65 7b |or a fil|e @file{|
|00003a80| 54 65 6d 70 6c 61 74 65 | 73 2f 43 5f 63 5f 56 32 |Template|s/C_c_V2|
|00003a90| 30 2e 73 64 7d 20 69 6e | 20 74 68 65 20 63 75 72 |0.sd} in| the cur|
|00003aa0| 72 65 6e 74 0a 64 69 72 | 65 63 74 6f 72 79 20 66 |rent.dir|ectory f|
|00003ab0| 69 72 73 74 2e 20 49 66 | 20 74 68 69 73 20 77 6f |irst. If| this wo|
|00003ac0| 75 6c 64 6e 27 74 20 62 | 65 20 66 6f 75 6e 64 20 |uldn't b|e found |
|00003ad0| 61 6e 64 20 6e 6f 20 76 | 61 72 69 61 62 6c 65 0a |and no v|ariable.|
|00003ae0| 40 76 61 72 7b 46 4c 45 | 58 43 41 54 5f 53 44 44 |@var{FLE|XCAT_SDD|
|00003af0| 49 52 7d 20 77 6f 75 6c | 64 20 62 65 20 70 72 65 |IR} woul|d be pre|
|00003b00| 73 65 6e 74 2c 20 46 6c | 65 78 43 61 74 20 77 6f |sent, Fl|exCat wo|
|00003b10| 75 6c 64 20 6c 6f 6f 6b | 20 66 6f 72 0a 40 66 69 |uld look| for.@fi|
|00003b20| 6c 65 7b 50 52 4f 47 44 | 49 52 3a 6c 69 62 2f 54 |le{PROGD|IR:lib/T|
|00003b30| 65 6d 70 6c 61 74 65 73 | 2f 43 5f 63 5f 56 32 30 |emplates|/C_c_V20|
|00003b40| 2e 73 64 7d 2e 20 42 75 | 74 20 69 66 20 40 76 61 |.sd}. Bu|t if @va|
|00003b50| 72 7b 46 4c 45 58 43 41 | 54 5f 53 44 44 49 52 7d |r{FLEXCA|T_SDDIR}|
|00003b60| 0a 77 6f 75 6c 64 20 65 | 78 69 73 74 20 61 6e 64 |.would e|xist and|
|00003b70| 20 68 61 76 65 20 74 68 | 65 20 76 61 6c 75 65 20 | have th|e value |
|00003b80| 40 73 61 6d 70 7b 57 6f | 72 6b 3a 46 6c 65 78 63 |@samp{Wo|rk:Flexc|
|00003b90| 61 74 7d 2c 20 66 6f 72 | 20 65 78 61 6d 70 6c 65 |at}, for| example|
|00003ba0| 2c 0a 74 68 65 6e 20 74 | 68 65 20 65 78 69 73 74 |,.then t|he exist|
|00003bb0| 65 6e 63 65 20 6f 66 20 | 40 66 69 6c 65 7b 57 6f |ence of |@file{Wo|
|00003bc0| 72 6b 3a 46 6c 65 78 43 | 61 74 2f 54 65 6d 70 6c |rk:FlexC|at/Templ|
|00003bd0| 61 74 65 73 2f 43 5f 63 | 5f 56 32 30 2e 73 64 7d |ates/C_c|_V20.sd}|
|00003be0| 0a 77 6f 75 6c 64 20 62 | 65 20 63 68 65 63 6b 65 |.would b|e checke|
|00003bf0| 64 2e 0a 40 65 6e 64 20 | 74 61 62 6c 65 0a 0a 46 |d..@end |table..F|
|00003c00| 6f 72 20 66 75 72 74 68 | 65 72 20 65 78 61 6d 70 |or furth|er examp|
|00003c10| 6c 65 73 20 6f 66 20 63 | 6f 6d 6d 61 6e 64 20 6c |les of c|ommand l|
|00003c20| 69 6e 65 73 20 73 65 65 | 20 40 72 65 66 7b 53 75 |ines see| @ref{Su|
|00003c30| 72 76 65 79 7d 2e 0a 0a | 0a 0a 0a 40 6e 6f 64 65 |rvey}...|...@node|
|00003c40| 20 43 61 74 61 6c 6f 67 | 20 64 65 73 63 72 69 70 | Catalog| descrip|
|00003c50| 74 69 6f 6e 0a 40 63 68 | 61 70 74 65 72 20 43 61 |tion.@ch|apter Ca|
|00003c60| 74 61 6c 6f 67 20 64 65 | 73 63 72 69 70 74 69 6f |talog de|scriptio|
|00003c70| 6e 20 66 69 6c 65 73 0a | 40 63 69 6e 64 65 78 20 |n files.|@cindex |
|00003c80| 43 61 74 61 6c 6f 67 20 | 64 65 73 63 72 69 70 74 |Catalog |descript|
|00003c90| 69 6f 6e 0a 40 63 69 6e | 64 65 78 20 2e 63 64 0a |ion.@cin|dex .cd.|
|00003ca0| 41 20 63 61 74 61 6c 6f | 67 20 64 65 73 63 72 69 |A catalo|g descri|
|00003cb0| 70 74 69 6f 6e 20 66 69 | 6c 65 20 63 6f 6e 74 61 |ption fi|le conta|
|00003cc0| 69 6e 73 20 66 6f 75 72 | 20 6b 69 6e 64 73 20 6f |ins four| kinds o|
|00003cd0| 66 20 6c 69 6e 65 73 2e | 0a 0a 40 74 61 62 6c 65 |f lines.|..@table|
|00003ce0| 20 40 73 74 72 6f 6e 67 | 0a 40 69 74 65 6d 20 43 | @strong|.@item C|
|00003cf0| 6f 6d 6d 65 6e 74 20 6c | 69 6e 65 73 0a 41 6e 79 |omment l|ines.Any|
|00003d00| 20 6c 69 6e 65 20 62 65 | 67 69 6e 6e 69 6e 67 20 | line be|ginning |
|00003d10| 77 69 74 68 20 61 20 73 | 65 6d 69 63 6f 6c 6f 6e |with a s|emicolon|
|00003d20| 20 69 73 20 61 73 73 75 | 6d 65 64 20 74 6f 20 62 | is assu|med to b|
|00003d30| 65 20 61 20 63 6f 6d 6d | 65 6e 74 20 6c 69 6e 65 |e a comm|ent line|
|00003d40| 2c 0a 68 65 6e 63 65 20 | 69 67 6e 6f 72 65 64 2e |,.hence |ignored.|
|00003d50| 20 28 54 68 65 20 73 74 | 72 69 6e 67 20 6c 69 6e | (The st|ring lin|
|00003d60| 65 73 20 62 65 6c 6f 77 | 20 61 72 65 20 61 6e 20 |es below| are an |
|00003d70| 65 78 63 65 70 74 69 6f | 6e 2e 20 54 68 65 73 65 |exceptio|n. These|
|00003d80| 20 6d 61 79 20 62 65 67 | 69 6e 0a 77 69 74 68 20 | may beg|in.with |
|00003d90| 61 20 73 65 6d 69 63 6f | 6c 6f 6e 2e 29 0a 0a 40 |a semico|lon.)..@|
|00003da0| 69 74 65 6d 20 43 6f 6d | 6d 61 6e 64 20 6c 69 6e |item Com|mand lin|
|00003db0| 65 73 0a 41 6e 79 20 6c | 69 6e 65 20 62 65 67 69 |es.Any l|ine begi|
|00003dc0| 6e 6e 69 6e 67 20 77 69 | 74 68 20 61 20 27 23 27 |nning wi|th a '#'|
|00003dd0| 20 28 77 69 74 68 20 74 | 68 65 20 73 61 6d 65 20 | (with t|he same |
|00003de0| 65 78 63 65 70 74 69 6f | 6e 20 61 73 20 61 62 6f |exceptio|n as abo|
|00003df0| 76 65 29 20 61 72 65 0a | 61 73 73 75 6d 65 64 20 |ve) are.|assumed |
|00003e00| 74 6f 20 62 65 20 63 6f | 6d 6d 61 6e 64 20 6c 69 |to be co|mmand li|
|00003e10| 6e 65 73 2e 20 50 6f 73 | 73 69 62 6c 65 20 63 6f |nes. Pos|sible co|
|00003e20| 6d 6d 61 6e 64 73 20 61 | 72 65 3a 0a 40 74 61 62 |mmands a|re:.@tab|
|00003e30| 6c 65 20 40 63 6f 64 65 | 0a 40 69 74 65 6d 20 23 |le @code|.@item #|
|00003e40| 6c 61 6e 67 75 61 67 65 | 20 3c 73 74 72 3e 0a 67 |language| <str>.g|
|00003e50| 69 76 65 73 20 74 68 65 | 20 70 72 6f 67 72 61 6d |ives the| program|
|00003e60| 73 20 64 65 66 61 75 6c | 74 20 6c 61 6e 67 75 61 |s defaul|t langua|
|00003e70| 67 65 2c 20 74 68 65 20 | 6c 61 6e 67 75 61 67 65 |ge, the |language|
|00003e80| 20 6f 66 20 74 68 65 20 | 73 74 72 69 6e 67 73 20 | of the |strings |
|00003e90| 69 6e 20 74 68 65 0a 63 | 61 74 61 6c 6f 67 20 64 |in the.c|atalog d|
|00003ea0| 65 73 63 72 69 70 74 69 | 6f 6e 2e 20 44 65 66 61 |escripti|on. Defa|
|00003eb0| 75 6c 74 20 69 73 20 40 | 73 61 6d 70 7b 23 6c 61 |ult is @|samp{#la|
|00003ec0| 6e 67 75 61 67 65 20 65 | 6e 67 6c 69 73 68 7d 2e |nguage e|nglish}.|
|00003ed0| 0a 40 69 74 65 6d 20 23 | 76 65 72 73 69 6f 6e 20 |.@item #|version |
|00003ee0| 3c 6e 75 6d 3e 0a 67 69 | 76 65 73 20 74 68 65 20 |<num>.gi|ves the |
|00003ef0| 76 65 72 73 69 6f 6e 20 | 6e 75 6d 62 65 72 20 6f |version |number o|
|00003f00| 66 20 63 61 74 61 6c 6f | 67 73 20 74 6f 20 62 65 |f catalo|gs to be|
|00003f10| 20 6f 70 65 6e 65 64 2e | 20 4e 6f 74 65 20 74 68 | opened.| Note th|
|00003f20| 61 74 20 74 68 69 73 20 | 6e 75 6d 62 65 72 0a 6d |at this |number.m|
|00003f30| 75 73 74 20 6d 61 74 63 | 68 20 65 78 61 63 74 20 |ust matc|h exact |
|00003f40| 61 6e 64 20 6e 6f 74 20 | 62 65 20 73 61 6d 65 20 |and not |be same |
|00003f50| 6f 72 20 68 69 67 68 65 | 72 20 61 73 20 69 6e 20 |or highe|r as in |
|00003f60| 40 63 69 74 65 7b 45 78 | 65 63 2f 4f 70 65 6e 4c |@cite{Ex|ec/OpenL|
|00003f70| 69 62 72 61 72 79 7d 2e | 0a 41 6e 20 65 78 63 65 |ibrary}.|.An exce|
|00003f80| 70 74 69 6f 6e 20 69 73 | 20 74 68 65 20 6e 75 6d |ption is| the num|
|00003f90| 62 65 72 20 30 2c 20 77 | 68 69 63 68 20 61 63 63 |ber 0, w|hich acc|
|00003fa0| 65 70 74 73 20 61 6e 79 | 20 63 61 74 61 6c 6f 67 |epts any| catalog|
|00003fb0| 2e 20 44 65 66 61 75 6c | 74 20 69 73 0a 40 73 61 |. Defaul|t is.@sa|
|00003fc0| 6d 70 7b 23 76 65 72 73 | 69 6f 6e 20 30 7d 2e 20 |mp{#vers|ion 0}. |
|00003fd0| 53 65 65 20 40 63 6f 64 | 65 7b 4c 6f 63 61 6c 65 |See @cod|e{Locale|
|00003fe0| 2f 4f 70 65 6e 43 61 74 | 61 6c 6f 67 7d 20 66 6f |/OpenCat|alog} fo|
|00003ff0| 72 20 66 75 72 74 68 65 | 72 20 69 6e 66 6f 72 6d |r furthe|r inform|
|00004000| 61 74 69 6f 6e 0a 6f 6e | 20 63 61 74 61 6c 6f 67 |ation.on| catalog|
|00004010| 20 6c 61 6e 67 75 61 67 | 65 20 61 6e 64 20 76 65 | languag|e and ve|
|00004020| 72 73 69 6f 6e 2e 0a 40 | 69 74 65 6d 20 23 6c 65 |rsion..@|item #le|
|00004030| 6e 67 74 68 62 79 74 65 | 73 20 3c 6e 75 6d 3e 0a |ngthbyte|s <num>.|
|00004040| 49 6e 73 74 72 75 63 74 | 73 20 46 6c 65 78 43 61 |Instruct|s FlexCa|
|00004050| 74 20 74 6f 20 70 75 74 | 20 74 68 65 20 67 69 76 |t to put| the giv|
|00004060| 65 6e 20 6e 75 6d 62 65 | 72 20 6f 66 20 62 79 74 |en numbe|r of byt|
|00004070| 65 73 20 62 65 66 6f 72 | 65 20 61 20 73 74 72 69 |es befor|e a stri|
|00004080| 6e 67 20 63 6f 6e 74 61 | 69 6e 69 6e 67 0a 69 74 |ng conta|ining.it|
|00004090| 73 20 6c 65 6e 67 74 68 | 2e 20 54 68 65 20 6c 65 |s length|. The le|
|000040a0| 6e 67 74 68 20 69 73 20 | 74 68 65 20 6e 75 6d 62 |ngth is |the numb|
|000040b0| 65 72 20 6f 66 20 62 79 | 74 65 73 20 69 6e 20 74 |er of by|tes in t|
|000040c0| 68 65 20 73 74 72 69 6e | 67 20 77 69 74 68 6f 75 |he strin|g withou|
|000040d0| 74 20 6c 65 6e 67 74 68 | 0a 62 79 74 65 73 20 61 |t length|.bytes a|
|000040e0| 6e 64 20 61 20 74 72 61 | 69 6c 69 6e 67 20 40 73 |nd a tra|iling @s|
|000040f0| 61 6d 70 7b 4e 55 4c 7d | 20 62 79 74 65 2e 20 28 |amp{NUL}| byte. (|
|00004100| 43 61 74 61 6c 6f 67 20 | 66 69 6c 65 73 20 61 6e |Catalog |files an|
|00004110| 64 20 68 65 6e 63 65 20 | 63 61 74 61 6c 6f 67 0a |d hence |catalog.|
|00004120| 73 74 72 69 6e 67 73 20 | 77 69 6c 6c 20 68 61 76 |strings |will hav|
|00004130| 65 20 61 20 74 72 61 69 | 6c 69 6e 67 20 40 73 61 |e a trai|ling @sa|
|00004140| 6d 70 7b 4e 55 4c 7d 20 | 62 79 74 65 2e 20 54 68 |mp{NUL} |byte. Th|
|00004150| 69 73 20 69 73 20 6e 6f | 74 20 61 6c 77 61 79 73 |is is no|t always|
|00004160| 20 74 72 75 65 20 66 6f | 72 0a 74 68 65 20 64 65 | true fo|r.the de|
|00004170| 66 61 75 6c 74 20 73 74 | 72 69 6e 67 73 2c 20 64 |fault st|rings, d|
|00004180| 65 70 65 6e 64 69 6e 67 | 20 6f 6e 20 74 68 65 20 |epending| on the |
|00004190| 73 6f 75 72 63 65 20 64 | 65 73 63 72 69 70 74 69 |source d|escripti|
|000041a0| 6f 6e 20 66 69 6c 65 2e | 29 0a 40 73 61 6d 70 7b |on file.|).@samp{|
|000041b0| 3c 6e 75 6d 3e 7d 20 6d | 75 73 74 20 62 65 20 62 |<num>} m|ust be b|
|000041c0| 65 74 77 65 65 6e 20 30 | 20 61 6e 64 20 73 69 7a |etween 0| and siz|
|000041d0| 65 6f 66 28 6c 6f 6e 67 | 29 3d 34 2c 20 44 65 66 |eof(long|)=4, Def|
|000041e0| 61 75 6c 74 20 69 73 0a | 40 73 61 6d 70 7b 23 6c |ault is.|@samp{#l|
|000041f0| 65 6e 67 74 68 62 79 74 | 65 73 20 30 7d 2e 0a 40 |engthbyt|es 0}..@|
|00004200| 69 74 65 6d 20 23 62 61 | 73 65 6e 61 6d 65 20 3c |item #ba|sename <|
|00004210| 73 74 72 3e 0a 53 65 74 | 73 20 74 68 65 20 62 61 |str>.Set|s the ba|
|00004220| 73 65 6e 61 6d 65 20 6f | 66 20 74 68 65 20 73 6f |sename o|f the so|
|00004230| 75 72 63 65 20 64 65 73 | 63 72 69 70 74 69 6f 6e |urce des|cription|
|00004240| 2e 20 40 78 72 65 66 7b | 53 6f 75 72 63 65 20 64 |. @xref{|Source d|
|00004250| 65 73 63 72 69 70 74 69 | 6f 6e 7d 2e 0a 54 68 69 |escripti|on}..Thi|
|00004260| 73 20 6f 76 65 72 77 72 | 69 74 65 73 20 74 68 65 |s overwr|ites the|
|00004270| 20 62 61 73 65 6e 61 6d | 65 20 66 72 6f 6d 20 74 | basenam|e from t|
|00004280| 68 65 20 63 6f 6d 6d 61 | 6e 64 20 6c 69 6e 65 20 |he comma|nd line |
|00004290| 61 72 67 75 6d 65 6e 74 | 20 43 44 46 49 4c 45 2e |argument| CDFILE.|
|000042a0| 0a 40 78 72 65 66 7b 50 | 72 6f 67 72 61 6d 20 73 |.@xref{P|rogram s|
|000042b0| 74 61 72 74 7d 2e 0a 40 | 65 6e 64 20 74 61 62 6c |tart}..@|end tabl|
|000042c0| 65 0a 43 6f 6d 6d 61 6e | 64 73 20 61 72 65 20 63 |e.Comman|ds are c|
|000042d0| 61 73 65 20 69 6e 73 65 | 6e 73 69 74 69 76 65 2e |ase inse|nsitive.|
|000042e0| 0a 40 69 74 65 6d 20 44 | 65 73 63 72 69 70 74 69 |.@item D|escripti|
|000042f0| 6f 6e 20 6c 69 6e 65 73 | 0a 64 65 63 6c 61 72 65 |on lines|.declare|
|00004300| 20 61 20 73 74 72 69 6e | 67 2e 20 54 68 65 79 20 | a strin|g. They |
|00004310| 6c 6f 6f 6b 20 6c 69 6b | 65 20 40 73 61 6d 70 7b |look lik|e @samp{|
|00004320| 49 44 53 54 52 20 28 69 | 64 2f 6d 69 6e 6c 65 6e |IDSTR (i|d/minlen|
|00004330| 2f 6d 61 78 6c 65 6e 29 | 7d 20 77 68 65 72 65 0a |/maxlen)|} where.|
|00004340| 40 73 61 6d 70 7b 49 44 | 53 54 52 7d 20 69 73 20 |@samp{ID|STR} is |
|00004350| 61 20 69 64 65 6e 74 69 | 66 69 65 72 20 28 61 20 |a identi|fier (a |
|00004360| 73 74 72 69 6e 67 20 63 | 6f 6e 73 69 73 74 69 6e |string c|onsistin|
|00004370| 67 20 6f 66 20 74 68 65 | 20 63 68 61 72 61 63 74 |g of the| charact|
|00004380| 65 72 73 0a 61 2d 7a 2c | 41 2d 5a 20 61 6e 64 20 |ers.a-z,|A-Z and |
|00004390| 30 2d 39 29 2c 20 40 73 | 61 6d 70 7b 69 64 7d 20 |0-9), @s|amp{id} |
|000043a0| 69 73 20 61 20 75 6e 69 | 71 75 65 20 6e 75 6d 62 |is a uni|que numb|
|000043b0| 65 72 20 28 66 72 6f 6d | 20 6e 6f 77 20 6f 6e 20 |er (from| now on |
|000043c0| 63 61 6c 6c 65 64 20 49 | 44 29 2c 0a 40 73 61 6d |called I|D),.@sam|
|000043d0| 70 7b 6d 69 6e 6c 65 6e | 7d 20 61 6e 64 20 40 73 |p{minlen|} and @s|
|000043e0| 61 6d 70 7b 6d 61 78 6c | 65 6e 7d 0a 61 72 65 20 |amp{maxl|en}.are |
|000043f0| 74 68 65 20 73 74 72 69 | 6e 67 73 20 6d 69 6e 69 |the stri|ngs mini|
|00004400| 6d 75 6d 20 61 6e 64 20 | 6d 61 78 69 6d 75 6d 20 |mum and |maximum |
|00004410| 6c 65 6e 67 74 68 2c 20 | 72 65 73 70 65 63 74 69 |length, |respecti|
|00004420| 76 65 6c 79 2e 20 54 68 | 65 20 6c 61 74 74 65 72 |vely. Th|e latter|
|00004430| 20 74 68 72 65 65 0a 6d | 61 79 20 62 65 20 6d 69 | three.m|ay be mi|
|00004440| 73 73 69 6e 67 20 28 62 | 75 74 20 6e 6f 74 20 74 |ssing (b|ut not t|
|00004450| 68 65 20 63 68 61 72 61 | 63 74 65 72 73 20 40 73 |he chara|cters @s|
|00004460| 61 6d 70 7b 28 2f 2f 29 | 7d 21 29 20 69 6e 20 77 |amp{(//)|}!) in w|
|00004470| 68 69 63 68 20 63 61 73 | 65 20 46 6c 65 78 43 61 |hich cas|e FlexCa|
|00004480| 74 0a 63 68 6f 6f 73 65 | 73 20 61 20 6e 75 6d 62 |t.choose|s a numb|
|00004490| 65 72 20 61 6e 64 20 6d | 61 6b 65 73 20 6e 6f 20 |er and m|akes no |
|000044a0| 72 65 73 74 72 69 63 74 | 69 6f 6e 73 20 6f 6e 20 |restrict|ions on |
|000044b0| 74 68 65 20 73 74 72 69 | 6e 67 20 6c 65 6e 67 74 |the stri|ng lengt|
|000044c0| 68 2e 0a 42 65 74 74 65 | 72 20 64 6f 6e 27 74 20 |h..Bette|r don't |
|000044d0| 75 73 65 20 74 68 65 20 | 49 44 27 73 2c 20 69 66 |use the |ID's, if|
|000044e0| 20 79 6f 75 20 64 6f 6e | 27 74 20 6e 65 65 64 2e | you don|'t need.|
|000044f0| 20 54 68 65 20 6c 69 6e | 65 73 20 66 6f 6c 6c 6f | The lin|es follo|
|00004500| 77 69 6e 67 20 61 72 65 | 20 74 68 65 0a 40 69 74 |wing are| the.@it|
|00004510| 65 6d 20 53 74 72 69 6e | 67 20 6c 69 6e 65 73 0a |em Strin|g lines.|
|00004520| 40 63 69 6e 64 65 78 20 | 43 6f 6e 74 72 6f 6c 20 |@cindex |Control |
|00004530| 63 68 61 72 61 63 74 65 | 72 73 0a 40 63 69 6e 64 |characte|rs.@cind|
|00004540| 65 78 20 41 73 63 69 69 | 2d 43 6f 64 65 0a 63 6f |ex Ascii|-Code.co|
|00004550| 6e 74 61 69 6e 69 6e 67 | 20 74 68 65 20 73 74 72 |ntaining| the str|
|00004560| 69 6e 67 20 69 74 73 65 | 6c 66 20 61 6e 64 20 6e |ing itse|lf and n|
|00004570| 6f 74 68 69 6e 67 20 65 | 6c 73 65 2e 20 54 68 65 |othing e|lse. The|
|00004580| 73 65 20 6d 61 79 20 63 | 6f 6e 74 61 69 6e 20 63 |se may c|ontain c|
|00004590| 65 72 74 61 69 6e 0a 63 | 6f 6e 74 72 6f 6c 20 63 |ertain.c|ontrol c|
|000045a0| 68 61 72 61 63 74 65 72 | 73 20 62 65 67 69 6e 6e |haracter|s beginn|
|000045b0| 69 6e 67 20 77 69 74 68 | 20 61 20 62 61 63 6b 73 |ing with| a backs|
|000045c0| 6c 61 73 68 3a 0a 40 74 | 61 62 6c 65 20 40 73 61 |lash:.@t|able @sa|
|000045d0| 6d 70 0a 40 69 74 65 6d | 20 5c 62 0a 42 61 63 6b |mp.@item| \b.Back|
|000045e0| 73 70 61 63 65 20 28 41 | 73 63 69 69 20 38 29 0a |space (A|scii 8).|
|000045f0| 40 69 74 65 6d 20 5c 63 | 0a 43 6f 6e 74 72 6f 6c |@item \c|.Control|
|00004600| 20 53 65 71 75 65 6e 63 | 65 20 49 6e 74 72 6f 64 | Sequenc|e Introd|
|00004610| 75 63 65 72 20 28 41 73 | 63 69 69 20 31 35 35 29 |ucer (As|cii 155)|
|00004620| 0a 40 69 74 65 6d 20 5c | 65 0a 45 73 63 61 70 65 |.@item \|e.Escape|
|00004630| 20 28 41 73 63 69 69 20 | 32 37 29 0a 40 69 74 65 | (Ascii |27).@ite|
|00004640| 6d 20 5c 66 0a 46 6f 72 | 6d 20 46 65 65 64 20 28 |m \f.For|m Feed (|
|00004650| 41 73 63 69 69 20 31 32 | 29 0a 40 69 74 65 6d 20 |Ascii 12|).@item |
|00004660| 5c 67 0a 44 69 73 70 6c | 61 79 20 62 65 65 70 20 |\g.Displ|ay beep |
|00004670| 28 41 73 63 69 69 20 37 | 29 0a 40 69 74 65 6d 20 |(Ascii 7|).@item |
|00004680| 5c 6e 0a 4c 69 6e 65 20 | 46 65 65 64 2c 20 6e 65 |\n.Line |Feed, ne|
|00004690| 77 6c 69 6e 65 20 28 41 | 73 63 69 69 20 31 30 29 |wline (A|scii 10)|
|000046a0| 0a 40 69 74 65 6d 20 5c | 72 0a 43 61 72 72 69 61 |.@item \|r.Carria|
|000046b0| 67 65 20 52 65 74 75 72 | 6e 20 28 41 73 63 69 69 |ge Retur|n (Ascii|
|000046c0| 20 31 33 29 0a 40 69 74 | 65 6d 20 5c 74 0a 54 61 | 13).@it|em \t.Ta|
|000046d0| 62 20 28 41 73 63 69 69 | 20 39 29 0a 40 69 74 65 |b (Ascii| 9).@ite|
|000046e0| 6d 20 5c 76 0a 56 65 72 | 74 69 63 61 6c 20 74 61 |m \v.Ver|tical ta|
|000046f0| 62 20 28 41 73 63 69 69 | 20 31 31 29 0a 40 69 74 |b (Ascii| 11).@it|
|00004700| 65 6d 20 5c 29 0a 54 68 | 65 20 74 72 61 69 6c 69 |em \).Th|e traili|
|00004710| 6e 67 20 62 72 61 63 6b | 65 74 20 77 68 69 63 68 |ng brack|et which|
|00004720| 20 69 73 20 70 6f 73 73 | 69 62 6c 79 20 6e 65 65 | is poss|ibly nee|
|00004730| 64 65 64 20 61 73 20 70 | 61 72 74 20 6f 66 20 61 |ded as p|art of a|
|00004740| 20 40 73 61 6d 70 7b 28 | 2e 2e 29 7d 0a 73 65 71 | @samp{(|..)}.seq|
|00004750| 75 65 6e 63 65 2c 20 73 | 65 65 20 40 72 65 66 7b |uence, s|ee @ref{|
|00004760| 53 6f 75 72 63 65 20 64 | 65 73 63 72 69 70 74 69 |Source d|escripti|
|00004770| 6f 6e 7d 2e 0a 40 69 74 | 65 6d 20 5c 5c 0a 54 68 |on}..@it|em \\.Th|
|00004780| 65 20 62 61 63 6b 73 6c | 61 73 68 20 69 74 73 65 |e backsl|ash itse|
|00004790| 6c 66 0a 40 69 74 65 6d | 20 5c 78 48 48 0a 54 68 |lf.@item| \xHH.Th|
|000047a0| 65 20 63 68 61 72 61 63 | 74 65 72 20 67 69 76 65 |e charac|ter give|
|000047b0| 6e 20 62 79 20 74 68 65 | 20 61 73 63 69 69 20 63 |n by the| ascii c|
|000047c0| 6f 64 65 20 40 73 61 6d | 70 7b 48 48 7d 2c 20 77 |ode @sam|p{HH}, w|
|000047d0| 68 65 72 65 20 40 73 61 | 6d 70 7b 48 48 7d 20 61 |here @sa|mp{HH} a|
|000047e0| 72 65 20 68 65 78 0a 64 | 69 67 69 74 73 2e 0a 40 |re hex.d|igits..@|
|000047f0| 69 74 65 6d 20 5c 4f 4f | 4f 0a 54 68 65 20 63 68 |item \OO|O.The ch|
|00004800| 61 72 61 63 74 65 72 20 | 67 69 76 65 6e 20 62 79 |aracter |given by|
|00004810| 20 74 68 65 20 61 73 63 | 69 69 20 63 6f 64 65 20 | the asc|ii code |
|00004820| 40 73 61 6d 70 7b 4f 4f | 4f 7d 2c 20 77 68 65 72 |@samp{OO|O}, wher|
|00004830| 65 20 40 73 61 6d 70 7b | 4f 4f 4f 7d 20 61 72 65 |e @samp{|OOO} are|
|00004840| 20 6f 63 74 61 6c 0a 64 | 69 67 69 74 73 2e 0a 40 | octal.d|igits..@|
|00004850| 65 6e 64 20 74 61 62 6c | 65 0a 46 69 6e 61 6c 6c |end tabl|e.Finall|
|00004860| 79 20 61 20 73 69 6e 67 | 6c 65 20 62 61 63 6b 73 |y a sing|le backs|
|00004870| 6c 61 73 68 20 61 74 20 | 74 68 65 20 65 6e 64 20 |lash at |the end |
|00004880| 6f 66 20 74 68 65 20 6c | 69 6e 65 20 63 61 75 73 |of the l|ine caus|
|00004890| 65 73 20 63 6f 6e 63 61 | 74 65 6e 69 6e 67 20 74 |es conca|tening t|
|000048a0| 68 65 0a 66 6f 6c 6c 6f | 77 69 6e 67 20 6c 69 6e |he.follo|wing lin|
|000048b0| 65 2e 20 54 68 69 73 20 | 6d 61 6b 65 73 20 69 74 |e. This |makes it|
|000048c0| 20 70 6f 73 73 69 62 6c | 65 20 74 6f 20 75 73 65 | possibl|e to use|
|000048d0| 20 73 74 72 69 6e 67 73 | 20 6f 66 20 61 6e 79 20 | strings| of any |
|000048e0| 6c 65 6e 67 74 68 2c 20 | 46 6c 65 78 43 61 74 0a |length, |FlexCat.|
|000048f0| 6d 61 6b 65 73 20 6e 6f | 20 61 73 73 75 6d 70 74 |makes no| assumpt|
|00004900| 69 6f 6e 73 20 6f 6e 20 | 73 74 72 69 6e 67 20 6c |ions on |string l|
|00004910| 65 6e 67 74 68 2e 0a 40 | 65 6e 64 20 74 61 62 6c |ength..@|end tabl|
|00004920| 65 0a 0a 41 20 73 74 72 | 69 6e 67 20 69 73 20 68 |e..A str|ing is h|
|00004930| 65 6e 63 65 20 67 69 76 | 65 6e 20 62 79 20 61 20 |ence giv|en by a |
|00004940| 64 65 73 63 72 69 70 74 | 69 6f 6e 20 6c 69 6e 65 |descript|ion line|
|00004950| 20 61 6e 64 20 74 68 65 | 20 66 6f 6c 6c 6f 77 69 | and the| followi|
|00004960| 6e 67 20 73 74 72 69 6e | 67 20 6c 69 6e 65 2e 0a |ng strin|g line..|
|00004970| 4c 65 74 27 73 20 73 65 | 65 20 61 6e 20 65 78 61 |Let's se|e an exa|
|00004980| 6d 70 6c 65 3a 0a 40 65 | 78 61 6d 70 6c 65 0a 20 |mple:.@e|xample. |
|00004990| 20 20 20 6d 73 67 48 65 | 6c 6c 6f 20 28 2f 34 2f | msgHe|llo (/4/|
|000049a0| 29 0a 20 20 20 20 48 65 | 6c 6c 6f 2c 20 74 68 69 |). He|llo, thi|
|000049b0| 73 20 69 73 20 65 6e 67 | 6c 69 73 68 21 5c 6e 0a |s is eng|lish!\n.|
|000049c0| 40 65 6e 64 20 65 78 61 | 6d 70 6c 65 0a 40 6e 6f |@end exa|mple.@no|
|000049d0| 69 6e 64 65 6e 74 0a 40 | 63 69 6e 64 65 78 20 46 |indent.@|cindex F|
|000049e0| 6c 65 78 43 61 74 2e 63 | 64 0a 54 68 65 20 49 44 |lexCat.c|d.The ID|
|000049f0| 20 69 73 20 6d 69 73 73 | 69 6e 67 20 68 65 72 65 | is miss|ing here|
|00004a00| 2c 20 73 6f 20 46 6c 65 | 78 43 61 74 20 63 68 6f |, so Fle|xCat cho|
|00004a10| 6f 73 65 73 20 61 20 73 | 75 69 74 61 62 6c 65 20 |oses a s|uitable |
|00004a20| 6e 75 6d 62 65 72 2e 20 | 54 68 65 20 6e 75 6d 62 |number. |The numb|
|00004a30| 65 72 20 34 0a 69 6e 73 | 74 72 75 63 74 73 20 46 |er 4.ins|tructs F|
|00004a40| 6c 65 78 43 61 74 2c 20 | 74 68 61 74 20 74 68 65 |lexCat, |that the|
|00004a50| 20 66 6f 6c 6c 6f 77 69 | 6e 67 20 73 74 72 69 6e | followi|ng strin|
|00004a60| 67 20 6d 75 73 74 20 6e | 6f 74 20 68 61 76 65 20 |g must n|ot have |
|00004a70| 6c 65 73 73 20 74 68 61 | 6e 20 66 6f 75 72 0a 63 |less tha|n four.c|
|00004a80| 68 61 72 61 63 74 65 72 | 73 20 61 6e 64 20 69 74 |haracter|s and it|
|00004a90| 20 6d 61 79 20 62 65 20 | 6f 66 20 61 6e 79 20 6c | may be |of any l|
|00004aa0| 65 6e 67 74 68 2e 20 53 | 65 65 20 74 68 65 20 66 |ength. S|ee the f|
|00004ab0| 69 6c 65 20 40 66 69 6c | 65 7b 46 6c 65 78 43 61 |ile @fil|e{FlexCa|
|00004ac0| 74 2e 63 64 7d 20 66 6f | 72 0a 61 20 66 75 72 74 |t.cd} fo|r.a furt|
|00004ad0| 68 65 72 20 65 78 61 6d | 70 6c 65 2e 0a 0a 0a 0a |her exam|ple.....|
|00004ae0| 40 6e 6f 64 65 20 43 61 | 74 61 6c 6f 67 20 74 72 |@node Ca|talog tr|
|00004af0| 61 6e 73 6c 61 74 69 6f | 6e 0a 40 63 68 61 70 74 |anslatio|n.@chapt|
|00004b00| 65 72 20 43 61 74 61 6c | 6f 67 20 74 72 61 6e 73 |er Catal|og trans|
|00004b10| 6c 61 74 69 6f 6e 20 66 | 69 6c 65 73 0a 40 63 69 |lation f|iles.@ci|
|00004b20| 6e 64 65 78 20 43 61 74 | 61 6c 6f 67 20 74 72 61 |ndex Cat|alog tra|
|00004b30| 6e 73 6c 61 74 69 6f 6e | 0a 40 63 69 6e 64 65 78 |nslation|.@cindex|
|00004b40| 20 2e 63 74 0a 43 61 74 | 61 6c 6f 67 20 74 72 61 | .ct.Cat|alog tra|
|00004b50| 6e 73 6c 61 74 69 6f 6e | 20 66 69 6c 65 73 20 61 |nslation| files a|
|00004b60| 72 65 20 76 65 72 79 20 | 73 69 6d 69 6c 61 72 20 |re very |similar |
|00004b70| 74 6f 20 63 61 74 61 6c | 6f 67 20 64 65 73 63 72 |to catal|og descr|
|00004b80| 69 70 74 69 6f 6e 73 2c | 20 65 78 63 65 70 74 0a |iptions,| except.|
|00004b90| 66 6f 72 20 6f 74 68 65 | 72 20 63 6f 6d 6d 61 6e |for othe|r comman|
|00004ba0| 64 73 20 61 6e 64 20 68 | 61 76 69 6e 67 20 6e 6f |ds and h|aving no|
|00004bb0| 20 69 6e 66 6f 72 6d 61 | 74 69 6f 6e 73 20 6f 6e | informa|tions on|
|00004bc0| 20 73 74 72 69 6e 67 20 | 49 44 20 61 6e 64 20 6c | string |ID and l|
|00004bd0| 65 6e 67 74 68 2e 0a 28 | 54 68 65 73 65 20 61 72 |ength..(|These ar|
|00004be0| 65 20 74 61 6b 65 6e 20 | 66 72 6f 6d 20 74 68 65 |e taken |from the|
|00004bf0| 20 63 61 74 61 6c 6f 67 | 20 64 65 73 63 72 69 70 | catalog| descrip|
|00004c00| 74 69 6f 6e 2e 29 20 41 | 6e 79 20 73 74 72 69 6e |tion.) A|ny strin|
|00004c10| 67 20 66 72 6f 6d 20 74 | 68 65 0a 63 61 74 61 6c |g from t|he.catal|
|00004c20| 6f 67 20 64 65 73 63 72 | 69 70 74 69 6f 6e 20 6d |og descr|iption m|
|00004c30| 75 73 74 20 62 65 20 70 | 72 65 73 65 6e 74 20 28 |ust be p|resent (|
|00004c40| 48 6f 77 65 76 65 72 2c | 20 46 6c 65 78 43 61 74 |However,| FlexCat|
|00004c50| 20 6f 6d 69 74 73 20 77 | 72 69 74 69 6e 67 0a 73 | omits w|riting.s|
|00004c60| 74 72 69 6e 67 73 20 69 | 6e 74 6f 20 74 68 65 20 |trings i|nto the |
|00004c70| 63 61 74 61 6c 6f 67 20 | 77 68 69 63 68 20 61 72 |catalog |which ar|
|00004c80| 65 20 69 64 65 6e 74 69 | 63 61 6c 20 74 6f 20 74 |e identi|cal to t|
|00004c90| 68 65 20 64 65 66 61 75 | 6c 74 20 73 74 72 69 6e |he defau|lt strin|
|00004ca0| 67 2e 29 0a 61 6e 64 20 | 6e 6f 20 61 64 64 69 74 |g.).and |no addit|
|00004cb0| 69 6f 6e 61 6c 20 69 64 | 65 6e 74 69 66 69 65 72 |ional id|entifier|
|00004cc0| 73 20 6d 61 79 20 6f 63 | 63 75 72 2e 20 54 68 69 |s may oc|cur. Thi|
|00004cd0| 73 20 69 73 20 65 61 73 | 79 20 61 73 73 75 72 65 |s is eas|y assure|
|00004ce0| 64 20 62 79 20 75 73 69 | 6e 67 0a 46 6c 65 78 43 |d by usi|ng.FlexC|
|00004cf0| 61 74 20 74 6f 20 63 72 | 65 61 74 65 20 6e 65 77 |at to cr|eate new|
|00004d00| 20 63 61 74 61 6c 6f 67 | 20 74 72 61 6e 73 6c 61 | catalog| transla|
|00004d10| 74 69 6f 6e 20 66 69 6c | 65 73 2e 20 40 78 72 65 |tion fil|es. @xre|
|00004d20| 66 7b 53 75 72 76 65 79 | 7d 2e 0a 0a 54 68 65 20 |f{Survey|}...The |
|00004d30| 63 6f 6d 6d 61 6e 64 73 | 20 61 6c 6c 6f 77 65 64 |commands| allowed|
|00004d40| 20 69 6e 20 63 61 74 61 | 6c 6f 67 20 74 72 61 6e | in cata|log tran|
|00004d50| 73 6c 61 74 69 6f 6e 73 | 20 61 72 65 3a 0a 40 74 |slations| are:.@t|
|00004d60| 61 62 6c 65 20 40 63 6f | 64 65 0a 40 69 74 65 6d |able @co|de.@item|
|00004d70| 20 23 23 76 65 72 73 69 | 6f 6e 20 3c 73 74 72 3e | ##versi|on <str>|
|00004d80| 0a 47 69 76 65 73 20 74 | 68 65 20 63 61 74 61 6c |.Gives t|he catal|
|00004d90| 6f 67 20 76 65 72 73 69 | 6f 6e 20 61 73 20 41 6d |og versi|on as Am|
|00004da0| 69 67 61 44 4f 53 20 76 | 65 72 73 69 6f 6e 20 73 |igaDOS v|ersion s|
|00004db0| 74 72 69 6e 67 2e 20 45 | 78 61 6d 70 6c 65 3a 0a |tring. E|xample:.|
|00004dc0| 40 65 78 61 6d 70 6c 65 | 0a 20 20 20 20 40 73 61 |@example|. @sa|
|00004dd0| 6d 70 7b 23 23 76 65 72 | 73 69 6f 6e 20 24 56 45 |mp{##ver|sion $VE|
|00004de0| 52 3a 20 44 65 75 74 73 | 63 68 2e 63 74 20 38 2e |R: Deuts|ch.ct 8.|
|00004df0| 31 20 28 32 37 2e 30 39 | 2e 39 33 29 7d 0a 40 65 |1 (27.09|.93)}.@e|
|00004e00| 6e 64 20 65 78 61 6d 70 | 6c 65 0a 54 68 65 20 76 |nd examp|le.The v|
|00004e10| 65 72 73 69 6f 6e 20 6e | 75 6d 62 65 72 20 6f 66 |ersion n|umber of|
|00004e20| 20 74 68 69 73 20 63 61 | 74 61 6c 6f 67 20 69 73 | this ca|talog is|
|00004e30| 20 38 2e 20 48 65 6e 63 | 65 20 74 68 65 20 63 61 | 8. Henc|e the ca|
|00004e40| 74 61 6c 6f 67 20 64 65 | 73 63 72 69 70 74 69 6f |talog de|scriptio|
|00004e50| 6e 73 0a 76 65 72 73 69 | 6f 6e 20 6e 75 6d 62 65 |ns.versi|on numbe|
|00004e60| 72 20 6d 75 73 74 20 62 | 65 20 30 20 6f 72 20 38 |r must b|e 0 or 8|
|00004e70| 2e 0a 40 69 74 65 6d 20 | 23 23 6c 61 6e 67 75 61 |..@item |##langua|
|00004e80| 67 65 20 3c 73 74 72 3e | 0a 54 68 65 20 63 61 74 |ge <str>|.The cat|
|00004e90| 61 6c 6f 67 73 20 6c 61 | 6e 67 75 61 67 65 2e 20 |alogs la|nguage. |
|00004ea0| 4f 66 20 63 6f 75 72 73 | 65 20 74 68 69 73 20 73 |Of cours|e this s|
|00004eb0| 68 6f 75 6c 64 20 62 65 | 20 61 6e 6f 74 68 65 72 |hould be| another|
|00004ec0| 20 6c 61 6e 67 75 61 67 | 65 20 74 68 61 6e 20 74 | languag|e than t|
|00004ed0| 68 65 0a 63 61 74 61 6c | 6f 67 20 64 65 73 63 72 |he.catal|og descr|
|00004ee0| 69 70 74 69 6f 6e 73 20 | 6c 61 6e 67 75 61 67 65 |iptions |language|
|00004ef0| 2e 20 54 68 65 20 40 73 | 61 6d 70 7b 23 23 6c 61 |. The @s|amp{##la|
|00004f00| 6e 67 75 61 67 65 7d 20 | 61 6e 64 20 40 73 61 6d |nguage} |and @sam|
|00004f10| 70 7b 23 23 76 65 72 73 | 69 6f 6e 7d 0a 63 6f 6d |p{##vers|ion}.com|
|00004f20| 6d 61 6e 64 73 20 6d 75 | 73 74 20 62 65 20 70 72 |mands mu|st be pr|
|00004f30| 65 73 65 6e 74 20 69 6e | 20 61 20 63 61 74 61 6c |esent in| a catal|
|00004f40| 6f 67 20 74 72 61 6e 73 | 6c 61 74 69 6f 6e 2e 0a |og trans|lation..|
|00004f50| 40 69 74 65 6d 20 23 23 | 63 6f 64 65 73 65 74 20 |@item ##|codeset |
|00004f60| 3c 6e 75 6d 3e 0a 43 75 | 72 72 65 6e 74 6c 79 20 |<num>.Cu|rrently |
|00004f70| 6e 6f 74 20 75 73 65 64 | 2c 20 6d 75 73 74 20 62 |not used|, must b|
|00004f80| 65 20 30 2e 20 54 68 69 | 73 20 69 73 20 74 68 65 |e 0. Thi|s is the|
|00004f90| 20 64 65 66 61 75 6c 74 | 20 76 61 6c 75 65 2e 0a | default| value..|
|00004fa0| 40 65 6e 64 20 74 61 62 | 6c 65 0a 0a 40 63 69 6e |@end tab|le..@cin|
|00004fb0| 64 65 78 20 44 65 75 74 | 73 63 68 2e 63 74 0a 54 |dex Deut|sch.ct.T|
|00004fc0| 68 65 20 73 74 72 69 6e | 67 20 66 72 6f 6d 20 61 |he strin|g from a|
|00004fd0| 62 6f 76 65 20 6c 6f 6f | 6b 73 20 6c 69 6b 65 20 |bove loo|ks like |
|00004fe0| 74 68 69 73 20 69 6e 20 | 74 68 65 20 63 61 74 61 |this in |the cata|
|00004ff0| 6c 6f 67 20 74 72 61 6e | 73 6c 61 74 69 6f 6e 3a |log tran|slation:|
|00005000| 0a 40 65 78 61 6d 70 6c | 65 0a 20 20 20 20 6d 73 |.@exampl|e. ms|
|00005010| 67 48 65 6c 6c 6f 0a 20 | 20 20 20 48 61 6c 6c 6f |gHello. | Hallo|
|00005020| 2c 20 64 69 65 73 20 69 | 73 74 20 64 65 75 74 73 |, dies i|st deuts|
|00005030| 63 68 21 5c 6e 0a 40 65 | 6e 64 20 65 78 61 6d 70 |ch!\n.@e|nd examp|
|00005040| 6c 65 0a 40 6e 6f 69 6e | 64 65 6e 74 0a 53 65 65 |le.@noin|dent.See|
|00005050| 20 40 66 69 6c 65 7b 44 | 65 75 74 73 63 68 2e 63 | @file{D|eutsch.c|
|00005060| 74 7d 20 61 73 20 66 75 | 72 74 68 65 72 20 65 78 |t} as fu|rther ex|
|00005070| 61 6d 70 6c 65 20 6f 66 | 20 61 20 63 61 74 61 6c |ample of| a catal|
|00005080| 6f 67 20 74 72 61 6e 73 | 6c 61 74 69 6f 6e 2e 0a |og trans|lation..|
|00005090| 0a 0a 0a 40 6e 6f 64 65 | 20 53 6f 75 72 63 65 20 |...@node| Source |
|000050a0| 64 65 73 63 72 69 70 74 | 69 6f 6e 0a 40 63 68 61 |descript|ion.@cha|
|000050b0| 70 74 65 72 20 53 6f 75 | 72 63 65 20 64 65 73 63 |pter Sou|rce desc|
|000050c0| 72 69 70 74 69 6f 6e 20 | 66 69 6c 65 73 0a 40 63 |ription |files.@c|
|000050d0| 69 6e 64 65 78 20 53 6f | 75 72 63 65 20 64 65 73 |index So|urce des|
|000050e0| 63 72 69 70 74 69 6f 6e | 0a 40 63 69 6e 64 65 78 |cription|.@cindex|
|000050f0| 20 2e 73 64 0a 54 68 69 | 73 20 69 73 20 74 68 65 | .sd.Thi|s is the|
|00005100| 20 73 70 65 63 69 61 6c | 20 70 61 72 74 20 6f 66 | special| part of|
|00005110| 20 46 6c 65 78 43 61 74 | 2e 20 55 6e 74 69 6c 20 | FlexCat|. Until |
|00005120| 6e 6f 77 20 74 68 65 72 | 65 20 69 73 20 6e 6f 74 |now ther|e is not|
|00005130| 68 69 6e 67 20 74 68 61 | 74 0a 43 61 74 43 6f 6d |hing tha|t.CatCom|
|00005140| 70 2c 20 4b 69 74 43 61 | 74 20 61 6e 64 20 6f 74 |p, KitCa|t and ot|
|00005150| 68 65 72 73 20 64 6f 6e | 27 74 20 6f 66 66 65 72 |hers don|'t offer|
|00005160| 20 74 6f 6f 2e 20 54 68 | 65 20 63 72 65 61 74 65 | too. Th|e create|
|00005170| 64 20 73 6f 75 72 63 65 | 20 73 68 6f 75 6c 64 20 |d source| should |
|00005180| 6d 61 6b 65 0a 69 74 20 | 65 61 73 79 2c 20 74 6f |make.it |easy, to|
|00005190| 20 75 73 65 20 74 68 65 | 20 63 61 74 61 6c 6f 67 | use the| catalog|
|000051a0| 73 20 77 69 74 68 6f 75 | 74 20 6c 6f 73 69 6e 67 |s withou|t losing|
|000051b0| 20 66 6c 65 78 69 62 69 | 6c 69 74 79 2e 20 41 6e | flexibi|lity. An|
|000051c0| 79 20 70 72 6f 67 72 61 | 6d 6d 69 6e 67 0a 6c 61 |y progra|mming.la|
|000051d0| 6e 67 75 61 67 65 20 73 | 68 6f 75 6c 64 20 62 65 |nguage s|hould be|
|000051e0| 20 70 6f 73 73 69 62 6c | 65 20 61 6e 64 20 61 6e | possibl|e and an|
|000051f0| 79 20 72 65 71 75 69 72 | 65 6d 65 6e 74 73 20 73 |y requir|ements s|
|00005200| 68 6f 75 6c 64 20 62 65 | 20 73 61 74 69 73 66 79 |hould be| satisfy|
|00005210| 61 62 6c 65 2e 0a 54 68 | 69 73 20 73 65 65 6d 73 |able..Th|is seems|
|00005220| 20 6c 69 6b 65 20 61 20 | 63 6f 6e 74 72 61 64 69 | like a |contradi|
|00005230| 63 74 69 6f 6e 2c 20 62 | 75 74 20 46 6c 65 78 43 |ction, b|ut FlexC|
|00005240| 61 74 27 73 20 73 6f 6c | 75 74 69 6f 6e 20 61 72 |at's sol|ution ar|
|00005250| 65 20 74 68 65 20 73 6f | 75 72 63 65 0a 64 65 73 |e the so|urce.des|
|00005260| 63 72 69 70 74 69 6f 6e | 20 66 69 6c 65 73 20 63 |cription| files c|
|00005270| 6f 6e 74 61 69 6e 69 6e | 67 20 61 20 74 65 6d 70 |ontainin|g a temp|
|00005280| 6c 61 74 65 20 6f 66 20 | 74 68 65 20 73 6f 75 72 |late of |the sour|
|00005290| 63 65 20 74 6f 20 62 65 | 20 63 72 65 61 74 65 64 |ce to be| created|
|000052a0| 2e 20 54 68 65 73 65 0a | 61 72 65 20 65 64 69 74 |. These.|are edit|
|000052b0| 61 62 6c 65 20 61 73 20 | 74 68 65 20 63 61 74 61 |able as |the cata|
|000052c0| 6c 6f 67 20 64 65 73 63 | 72 69 70 74 69 6f 6e 20 |log desc|ription |
|000052d0| 61 6e 64 20 74 72 61 6e | 73 6c 61 74 69 6f 6e 20 |and tran|slation |
|000052e0| 66 69 6c 65 73 20 61 72 | 65 2c 0a 68 65 6e 63 65 |files ar|e,.hence|
|000052f0| 20 46 6c 65 78 43 61 74 | 20 63 61 6e 20 63 72 65 | FlexCat| can cre|
|00005300| 61 74 65 20 61 6e 79 20 | 63 6f 64 65 2e 0a 0a 54 |ate any |code...T|
|00005310| 68 65 20 73 6f 75 72 63 | 65 20 64 65 73 63 72 69 |he sourc|e descri|
|00005320| 70 74 69 6f 6e 73 20 61 | 72 65 20 73 65 61 72 63 |ptions a|re searc|
|00005330| 68 65 64 20 66 6f 72 20 | 63 65 72 74 61 69 6e 20 |hed for |certain |
|00005340| 73 79 6d 62 6f 6c 73 20 | 77 68 69 63 68 20 61 72 |symbols |which ar|
|00005350| 65 20 72 65 70 6c 61 63 | 65 64 0a 62 79 20 63 65 |e replac|ed.by ce|
|00005360| 72 74 61 69 6e 20 76 61 | 6c 75 65 73 2e 20 50 6f |rtain va|lues. Po|
|00005370| 73 73 69 62 6c 65 20 73 | 79 6d 62 6f 6c 73 20 61 |ssible s|ymbols a|
|00005380| 72 65 20 74 68 65 20 62 | 61 63 6b 73 6c 61 73 68 |re the b|ackslash|
|00005390| 20 63 68 61 72 61 63 74 | 65 72 73 20 66 72 6f 6d | charact|ers from|
|000053a0| 0a 61 62 6f 76 65 20 61 | 6e 64 20 61 64 64 69 74 |.above a|nd addit|
|000053b0| 69 6f 6e 61 6c 6c 79 20 | 73 65 71 75 65 6e 63 65 |ionally |sequence|
|000053c0| 73 20 62 65 67 69 6e 6e | 69 6e 67 20 77 69 74 68 |s beginn|ing with|
|000053d0| 20 61 20 40 73 61 6d 70 | 7b 25 7d 2e 20 28 54 68 | a @samp|{%}. (Th|
|000053e0| 69 73 20 69 73 20 77 65 | 6c 6c 0a 6b 6e 6f 77 6e |is is we|ll.known|
|000053f0| 20 66 6f 72 20 43 20 70 | 72 6f 67 72 61 6d 6d 65 | for C p|rogramme|
|00005400| 72 73 2e 29 0a 40 74 61 | 62 6c 65 20 40 73 61 6d |rs.).@ta|ble @sam|
|00005410| 70 0a 40 69 74 65 6d 20 | 25 62 0a 69 73 20 74 68 |p.@item |%b.is th|
|00005420| 65 20 62 61 73 65 20 6e | 61 6d 65 20 6f 66 20 74 |e base n|ame of t|
|00005430| 68 65 20 63 61 74 61 6c | 6f 67 20 64 65 73 63 72 |he catal|og descr|
|00005440| 69 70 74 69 6f 6e 2e 20 | 40 78 72 65 66 7b 50 72 |iption. |@xref{Pr|
|00005450| 6f 67 72 61 6d 20 73 74 | 61 72 74 7d 2e 0a 40 69 |ogram st|art}..@i|
|00005460| 74 65 6d 20 25 76 0a 69 | 73 20 74 68 65 20 76 65 |tem %v.i|s the ve|
|00005470| 72 73 69 6f 6e 20 6e 75 | 6d 62 65 72 20 6f 66 20 |rsion nu|mber of |
|00005480| 74 68 65 20 63 61 74 61 | 6c 6f 67 20 64 65 73 63 |the cata|log desc|
|00005490| 72 69 70 74 69 6f 6e 2e | 20 44 6f 6e 27 74 20 6d |ription.| Don't m|
|000054a0| 69 78 20 74 68 69 73 20 | 75 70 20 77 69 74 68 0a |ix this |up with.|
|000054b0| 74 68 65 20 63 61 74 61 | 6c 6f 67 20 76 65 72 73 |the cata|log vers|
|000054c0| 69 6f 6e 20 73 74 72 69 | 6e 67 20 66 72 6f 6d 20 |ion stri|ng from |
|000054d0| 74 68 65 20 63 61 74 61 | 6c 6f 67 20 74 72 61 6e |the cata|log tran|
|000054e0| 73 6c 61 74 69 6f 6e 2e | 0a 40 69 74 65 6d 20 25 |slation.|.@item %|
|000054f0| 6c 0a 69 73 20 74 68 65 | 20 63 61 74 61 6c 6f 67 |l.is the| catalog|
|00005500| 20 64 65 73 63 72 69 70 | 74 69 6f 6e 73 20 6c 61 | descrip|tions la|
|00005510| 6e 67 75 61 67 65 2e 20 | 50 6c 65 61 73 65 20 6e |nguage. |Please n|
|00005520| 6f 74 65 2c 20 74 68 61 | 74 20 74 68 69 73 20 69 |ote, tha|t this i|
|00005530| 73 20 69 6e 73 65 72 74 | 65 64 0a 61 73 20 61 20 |s insert|ed.as a |
|00005540| 73 74 72 69 6e 67 2e 20 | 53 65 65 20 40 73 61 6d |string. |See @sam|
|00005550| 70 7b 25 73 7d 20 62 65 | 6c 6f 77 2e 0a 62 65 6c |p{%s} be|low..bel|
|00005560| 6f 77 2e 0a 40 69 74 65 | 6d 20 25 6e 0a 69 73 20 |ow..@ite|m %n.is |
|00005570| 74 68 65 20 6e 75 6d 62 | 65 72 20 6f 66 20 73 74 |the numb|er of st|
|00005580| 72 69 6e 67 73 20 69 6e | 20 74 68 65 20 63 61 74 |rings in| the cat|
|00005590| 61 6c 6f 67 20 64 65 73 | 63 72 69 70 74 69 6f 6e |alog des|cription|
|000055a0| 2e 0a 40 69 74 65 6d 20 | 25 25 0a 69 73 20 74 68 |..@item |%%.is th|
|000055b0| 65 20 63 68 61 72 61 63 | 74 65 72 20 40 73 61 6d |e charac|ter @sam|
|000055c0| 70 7b 25 7d 20 69 74 73 | 65 6c 66 2e 0a 40 65 6e |p{%} its|elf..@en|
|000055d0| 64 20 74 61 62 6c 65 0a | 0a 42 75 74 20 74 68 65 |d table.|.But the|
|000055e0| 20 6d 6f 73 74 20 69 6d | 70 6f 72 74 61 6e 74 20 | most im|portant |
|000055f0| 74 68 69 6e 67 20 61 72 | 65 20 74 68 65 20 66 6f |thing ar|e the fo|
|00005600| 6c 6c 6f 77 69 6e 67 20 | 73 65 71 65 6e 63 65 73 |llowing |seqences|
|00005610| 2e 20 54 68 65 73 65 20 | 72 65 70 72 65 73 65 6e |. These |represen|
|00005620| 74 0a 74 68 65 20 63 61 | 74 61 6c 6f 67 20 73 74 |t.the ca|talog st|
|00005630| 72 69 6e 67 73 20 69 6e | 20 64 69 66 66 65 72 65 |rings in| differe|
|00005640| 6e 74 20 77 61 79 73 2e | 20 4c 69 6e 65 73 20 63 |nt ways.| Lines c|
|00005650| 6f 6e 74 61 69 6e 69 6e | 67 20 6f 6e 65 20 6f 72 |ontainin|g one or|
|00005660| 20 6d 6f 72 65 20 6f 66 | 20 74 68 65 73 65 0a 73 | more of| these.s|
|00005670| 79 6d 62 6f 6c 73 20 61 | 72 65 20 72 65 70 65 61 |ymbols a|re repea|
|00005680| 74 65 64 20 66 6f 72 20 | 61 6e 79 20 53 74 72 69 |ted for |any Stri|
|00005690| 6e 67 2e 0a 0a 40 74 61 | 62 6c 65 20 40 73 61 6d |ng...@ta|ble @sam|
|000056a0| 70 0a 40 69 74 65 6d 20 | 25 69 0a 69 73 20 74 68 |p.@item |%i.is th|
|000056b0| 65 20 69 64 65 6e 74 69 | 66 69 65 72 20 66 72 6f |e identi|fier fro|
|000056c0| 6d 20 74 68 65 20 63 61 | 74 61 6c 6f 67 20 64 65 |m the ca|talog de|
|000056d0| 73 63 72 69 70 74 69 6f | 6e 2e 0a 40 69 74 65 6d |scriptio|n..@item|
|000056e0| 20 25 64 0a 69 73 20 74 | 68 65 20 73 74 72 69 6e | %d.is t|he strin|
|000056f0| 67 73 20 49 44 2e 0a 40 | 69 74 65 6d 20 25 65 0a |gs ID..@|item %e.|
|00005700| 69 73 20 74 68 65 20 6e | 75 6d 62 65 72 20 6f 66 |is the n|umber of|
|00005710| 20 74 68 69 73 20 73 74 | 72 69 6e 67 2e 20 43 6f | this st|ring. Co|
|00005720| 75 6e 74 69 6e 67 20 62 | 65 67 69 6e 73 20 77 69 |unting b|egins wi|
|00005730| 74 68 20 30 2e 0a 40 69 | 74 65 6d 20 25 73 0a 69 |th 0..@i|tem %s.i|
|00005740| 73 20 74 68 65 20 73 74 | 72 69 6e 67 20 69 74 73 |s the st|ring its|
|00005750| 65 6c 66 3b 20 74 68 69 | 73 20 77 69 6c 6c 20 62 |elf; thi|s will b|
|00005760| 65 20 69 6e 73 65 72 74 | 65 64 20 69 6e 20 61 20 |e insert|ed in a |
|00005770| 77 61 79 20 64 65 70 65 | 6e 64 69 6e 67 20 6f 6e |way depe|nding on|
|00005780| 20 74 68 65 0a 70 72 6f | 67 72 61 6d 6d 69 6e 67 | the.pro|gramming|
|00005790| 20 6c 61 6e 67 75 61 67 | 65 20 61 6e 64 20 63 61 | languag|e and ca|
|000057a0| 6e 20 62 65 20 63 6f 6e | 74 72 6f 6c 6c 65 64 20 |n be con|trolled |
|000057b0| 75 73 69 6e 67 20 74 68 | 65 20 63 6f 6d 6d 61 6e |using th|e comman|
|000057c0| 64 73 0a 40 73 61 6d 70 | 7b 23 23 73 74 72 69 6e |ds.@samp|{##strin|
|000057d0| 67 74 79 70 65 7d 20 61 | 6e 64 20 40 73 61 6d 70 |gtype} a|nd @samp|
|000057e0| 7b 23 23 73 68 6f 72 74 | 73 74 72 69 6e 67 73 7d |{##short|strings}|
|000057f0| 2e 0a 40 69 74 65 6d 20 | 25 28 2e 2e 2e 29 0a 69 |..@item |%(...).i|
|00005800| 6e 73 65 72 74 73 20 74 | 68 65 20 74 65 78 74 20 |nserts t|he text |
|00005810| 62 65 74 77 65 65 6e 20 | 74 68 65 20 62 72 61 63 |between |the brac|
|00005820| 6b 65 74 73 20 66 6f 72 | 20 61 6e 79 20 73 74 72 |kets for| any str|
|00005830| 69 6e 67 20 65 78 63 65 | 70 74 20 74 68 65 20 6c |ing exce|pt the l|
|00005840| 61 73 74 2e 0a 54 68 69 | 73 20 69 73 20 70 72 6f |ast..Thi|s is pro|
|00005850| 62 61 62 6c 79 20 6e 65 | 65 64 65 64 20 69 6e 20 |bably ne|eded in |
|00005860| 41 72 72 61 79 73 2c 20 | 69 66 20 74 68 65 20 61 |Arrays, |if the a|
|00005870| 72 72 61 79 20 65 6e 74 | 72 69 65 73 20 73 68 6f |rray ent|ries sho|
|00005880| 75 6c 64 20 62 65 20 73 | 65 70 61 72 61 74 65 64 |uld be s|eparated|
|00005890| 0a 62 79 20 63 6f 6d 6d | 61 73 2c 20 62 75 74 20 |.by comm|as, but |
|000058a0| 74 68 65 20 6c 61 73 74 | 20 65 6e 74 72 79 20 6d |the last| entry m|
|000058b0| 75 73 74 20 6e 6f 74 20 | 62 65 20 66 6f 6c 6c 6f |ust not |be follo|
|000058c0| 77 65 64 20 62 79 20 61 | 20 63 6f 6d 6d 61 2e 20 |wed by a| comma. |
|000058d0| 59 6f 75 20 63 61 6e 0a | 75 73 65 20 40 73 61 6d |You can.|use @sam|
|000058e0| 70 7b 25 28 2c 29 7d 20 | 69 6e 20 74 68 61 74 20 |p{%(,)} |in that |
|000058f0| 63 61 73 65 2e 20 4e 6f | 74 65 20 74 68 61 74 20 |case. No|te that |
|00005900| 77 69 74 68 69 6e 20 74 | 68 65 20 62 72 61 63 6b |within t|he brack|
|00005910| 65 74 73 20 74 68 65 72 | 65 20 69 73 20 6e 6f 0a |ets ther|e is no.|
|00005920| 72 65 70 6c 61 63 69 6e | 67 20 6f 66 20 40 73 61 |replacin|g of @sa|
|00005930| 6d 70 7b 25 7d 20 73 65 | 71 75 65 6e 63 65 73 2e |mp{%} se|quences.|
|00005940| 20 42 61 63 6b 73 6c 61 | 73 68 20 73 65 71 75 65 | Backsla|sh seque|
|00005950| 6e 63 65 73 2c 20 68 6f | 77 65 76 65 72 2c 20 61 |nces, ho|wever, a|
|00005960| 72 65 20 73 74 69 6c 6c | 0a 61 6c 6c 6f 77 65 64 |re still|.allowed|
|00005970| 2e 0a 40 65 6e 64 20 74 | 61 62 6c 65 0a 0a 54 68 |..@end t|able..Th|
|00005980| 65 20 63 6f 6e 74 72 6f | 6c 20 73 65 71 75 65 6e |e contro|l sequen|
|00005990| 63 65 73 20 40 73 61 6d | 70 7b 25 6c 7d 20 61 6e |ces @sam|p{%l} an|
|000059a0| 64 20 40 73 61 6d 70 7b | 25 73 7d 20 63 72 65 61 |d @samp{|%s} crea|
|000059b0| 74 65 20 73 74 72 69 6e | 67 73 2e 20 42 75 74 20 |te strin|gs. But |
|000059c0| 68 6f 77 20 73 74 72 69 | 6e 67 73 0a 6c 6f 6f 6b |how stri|ngs.look|
|000059d0| 20 64 65 70 65 6e 64 73 | 20 6f 6e 20 74 68 65 20 | depends| on the |
|000059e0| 70 72 6f 67 72 61 6d 20 | 6c 61 6e 67 75 61 67 65 |program |language|
|000059f0| 2e 20 54 68 61 74 27 73 | 20 77 68 79 20 74 68 65 |. That's| why the|
|00005a00| 20 73 6f 75 72 63 65 20 | 64 65 73 63 72 69 70 74 | source |descript|
|00005a10| 69 6f 6e 0a 61 6c 6c 6f | 77 73 20 63 6f 6d 6d 61 |ion.allo|ws comma|
|00005a20| 6e 64 20 6c 69 6e 65 73 | 20 73 69 6d 69 6c 61 72 |nd lines| similar|
|00005a30| 20 74 6f 20 74 68 65 20 | 63 61 74 61 6c 6f 67 20 | to the |catalog |
|00005a40| 74 72 61 6e 73 6c 61 74 | 69 6f 6e 2e 20 54 68 65 |translat|ion. The|
|00005a50| 73 65 20 6d 75 73 74 20 | 62 65 67 69 6e 0a 77 69 |se must |begin.wi|
|00005a60| 74 68 20 74 68 65 20 66 | 69 72 73 74 20 63 68 61 |th the f|irst cha|
|00005a70| 72 61 63 74 65 72 20 6f | 66 20 74 68 65 20 6c 69 |racter o|f the li|
|00005a80| 6e 65 20 61 6e 64 20 61 | 6e 79 20 63 6f 6d 6d 61 |ne and a|ny comma|
|00005a90| 6e 64 20 6d 75 73 74 20 | 68 61 76 65 20 69 74 73 |nd must |have its|
|00005aa0| 20 6f 77 6e 20 6c 69 6e | 65 2e 0a 50 6f 73 73 69 | own lin|e..Possi|
|00005ab0| 62 6c 65 20 63 6f 6d 6d | 61 6e 64 73 20 61 72 65 |ble comm|ands are|
|00005ac0| 3a 0a 40 74 61 62 6c 65 | 20 40 63 6f 64 65 0a 40 |:.@table| @code.@|
|00005ad0| 69 74 65 6d 20 23 23 73 | 68 6f 72 74 73 74 72 69 |item ##s|hortstri|
|00005ae0| 6e 67 73 0a 6d 61 6b 65 | 73 20 6c 6f 6e 67 65 72 |ngs.make|s longer|
|00005af0| 20 73 74 72 69 6e 67 73 | 20 74 6f 20 62 65 20 73 | strings| to be s|
|00005b00| 70 6c 69 74 74 65 64 20 | 6f 6e 20 64 69 66 66 65 |plitted |on diffe|
|00005b10| 72 65 6e 74 20 6c 69 6e | 65 73 2e 20 54 68 69 73 |rent lin|es. This|
|00005b20| 20 69 73 20 70 72 6f 62 | 61 62 6c 79 0a 6e 6f 74 | is prob|ably.not|
|00005b30| 20 61 6c 77 61 79 73 20 | 70 6f 73 73 69 62 6c 65 | always |possible|
|00005b40| 20 6f 72 20 6e 6f 74 20 | 69 6d 70 6c 65 6d 65 6e | or not |implemen|
|00005b50| 74 65 64 20 69 6e 74 6f | 20 46 6c 65 78 43 61 74 |ted into| FlexCat|
|00005b60| 20 61 6e 64 20 68 65 6e | 63 65 20 74 68 65 20 64 | and hen|ce the d|
|00005b70| 65 66 61 75 6c 74 0a 69 | 73 20 74 6f 20 63 72 65 |efault.i|s to cre|
|00005b80| 61 74 65 20 6f 6e 65 2c | 20 70 72 6f 62 61 62 6c |ate one,| probabl|
|00005b90| 79 20 76 65 72 79 20 6c | 6f 6e 67 20 73 74 72 69 |y very l|ong stri|
|00005ba0| 6e 67 2e 0a 40 69 74 65 | 6d 20 23 23 73 74 72 69 |ng..@ite|m ##stri|
|00005bb0| 6e 67 74 79 70 65 20 3c | 74 79 70 65 3e 0a 54 65 |ngtype <|type>.Te|
|00005bc0| 6c 6c 73 20 46 6c 65 78 | 43 61 74 20 68 6f 77 20 |lls Flex|Cat how |
|00005bd0| 73 74 72 69 6e 67 73 20 | 73 68 6f 75 6c 64 20 6c |strings |should l|
|00005be0| 6f 6f 6b 20 6c 69 6b 65 | 2e 20 50 6f 73 73 69 62 |ook like|. Possib|
|00005bf0| 6c 65 20 74 79 70 65 73 | 20 61 72 65 0a 40 74 61 |le types| are.@ta|
|00005c00| 62 6c 65 20 40 73 74 72 | 6f 6e 67 0a 40 69 74 65 |ble @str|ong.@ite|
|00005c10| 6d 20 4e 6f 6e 65 0a 4e | 6f 20 61 64 64 69 74 69 |m None.N|o additi|
|00005c20| 6f 6e 61 6c 20 63 68 61 | 72 61 63 74 65 72 73 20 |onal cha|racters |
|00005c30| 61 72 65 20 63 72 65 61 | 74 65 64 2e 20 41 6e 20 |are crea|ted. An |
|00005c40| 69 6d 61 67 65 20 6f 66 | 20 74 68 65 20 73 74 72 |image of| the str|
|00005c50| 69 6e 67 20 69 73 20 69 | 6e 73 65 72 74 65 64 0a |ing is i|nserted.|
|00005c60| 61 6e 64 20 6e 6f 74 68 | 69 6e 67 20 65 6c 73 65 |and noth|ing else|
|00005c70| 2e 20 4e 6f 20 6f 75 74 | 70 75 74 20 6f 66 20 62 |. No out|put of b|
|00005c80| 69 6e 61 72 79 20 63 68 | 61 72 61 63 74 65 72 73 |inary ch|aracters|
|00005c90| 20 28 74 68 65 20 62 61 | 63 6b 73 6c 61 73 68 20 | (the ba|ckslash |
|00005ca0| 73 65 71 75 65 6e 63 65 | 73 29 0a 69 73 20 70 6f |sequence|s).is po|
|00005cb0| 73 73 69 62 6c 65 2e 0a | 40 69 74 65 6d 20 43 0a |ssible..|@item C.|
|00005cc0| 63 72 65 61 74 65 73 20 | 73 74 72 69 6e 67 73 20 |creates |strings |
|00005cd0| 61 63 63 6f 72 64 69 6e | 67 20 74 6f 20 43 2e 20 |accordin|g to C. |
|00005ce0| 54 68 65 20 73 74 72 69 | 6e 67 73 20 61 72 65 20 |The stri|ngs are |
|00005cf0| 70 72 65 63 65 64 65 64 | 20 61 6e 64 20 66 6f 6c |preceded| and fol|
|00005d00| 6c 6f 77 65 64 20 62 79 | 0a 74 68 65 20 63 68 61 |lowed by|.the cha|
|00005d10| 72 61 63 74 65 72 20 40 | 73 61 6d 70 7b 22 7d 2e |racter @|samp{"}.|
|00005d20| 20 53 74 72 69 6e 67 73 | 20 61 72 65 20 73 70 6c | Strings| are spl|
|00005d30| 69 74 74 65 64 20 75 73 | 69 6e 67 20 74 68 65 20 |itted us|ing the |
|00005d40| 73 65 71 75 65 6e 63 65 | 73 0a 40 73 61 6d 70 7b |sequence|s.@samp{|
|00005d50| 22 5c 7d 20 61 74 20 74 | 68 65 20 65 6e 64 20 6f |"\} at t|he end o|
|00005d60| 66 20 74 68 65 20 6c 69 | 6e 65 20 61 6e 64 20 40 |f the li|ne and @|
|00005d70| 73 61 6d 70 7b 22 7d 20 | 61 74 20 74 68 65 20 62 |samp{"} |at the b|
|00005d80| 65 67 69 6e 6e 69 6e 67 | 20 6f 66 20 74 68 65 0a |eginning| of the.|
|00005d90| 6e 65 77 20 6c 69 6e 65 | 2e 20 28 54 68 65 20 62 |new line|. (The b|
|00005da0| 61 63 6b 73 6c 61 73 68 | 20 69 73 20 6e 65 65 64 |ackslash| is need|
|00005db0| 65 64 20 69 6e 20 6d 61 | 63 72 6f 73 2e 29 20 42 |ed in ma|cros.) B|
|00005dc0| 69 6e 61 72 79 20 63 68 | 61 72 61 63 74 65 72 73 |inary ch|aracters|
|00005dd0| 20 61 72 65 0a 69 6e 73 | 65 72 74 65 64 20 75 73 | are.ins|erted us|
|00005de0| 69 6e 67 20 40 73 61 6d | 70 7b 5c 4f 4f 4f 7d 2e |ing @sam|p{\OOO}.|
|00005df0| 20 40 78 72 65 66 7b 43 | 7d 2e 0a 40 69 74 65 6d | @xref{C|}..@item|
|00005e00| 20 4f 62 65 72 6f 6e 0a | 69 73 20 6c 69 6b 65 20 | Oberon.|is like |
|00005e10| 73 74 72 69 6e 67 20 74 | 79 70 65 20 43 2c 20 65 |string t|ype C, e|
|00005e20| 78 63 65 70 74 20 66 6f | 72 20 74 68 65 20 74 72 |xcept fo|r the tr|
|00005e30| 61 69 6c 69 6e 67 20 62 | 61 63 6b 73 6c 61 73 68 |ailing b|ackslash|
|00005e40| 20 61 74 20 74 68 65 20 | 65 6e 64 20 6f 66 20 74 | at the |end of t|
|00005e50| 68 65 0a 6c 69 6e 65 2e | 20 40 78 72 65 66 7b 4f |he.line.| @xref{O|
|00005e60| 62 65 72 6f 6e 7d 2e 20 | 54 68 69 73 20 73 74 72 |beron}. |This str|
|00005e70| 69 6e 67 20 74 79 70 65 | 20 69 73 20 72 65 63 6f |ing type| is reco|
|00005e80| 6d 6d 65 6e 64 65 64 20 | 66 6f 72 20 4d 6f 64 75 |mmended |for Modu|
|00005e90| 6c 61 2d 32 2c 20 74 6f | 6f 2e 0a 40 69 74 65 6d |la-2, to|o..@item|
|00005ea0| 20 41 73 73 65 6d 62 6c | 65 72 0a 53 74 72 69 6e | Assembl|er.Strin|
|00005eb0| 67 73 20 61 72 65 20 63 | 72 65 61 74 65 64 20 75 |gs are c|reated u|
|00005ec0| 73 69 6e 67 20 40 73 61 | 6d 70 7b 64 63 2e 62 7d |sing @sa|mp{dc.b}|
|00005ed0| 2e 20 52 65 61 64 61 62 | 6c 65 20 61 73 63 69 69 |. Readab|le ascii|
|00005ee0| 20 63 68 61 72 61 63 74 | 65 72 73 20 61 72 65 20 | charact|ers are |
|00005ef0| 70 72 65 63 65 64 65 64 | 0a 61 6e 64 20 66 6f 6c |preceded|.and fol|
|00005f00| 6c 6f 77 65 64 20 62 79 | 20 74 68 65 20 63 68 61 |lowed by| the cha|
|00005f10| 72 61 63 74 65 72 20 40 | 73 61 6d 70 7b 27 7d 2c |racter @|samp{'},|
|00005f20| 20 62 69 6e 61 72 79 20 | 63 68 61 72 61 63 74 65 | binary |characte|
|00005f30| 72 73 20 61 72 65 20 69 | 6e 73 65 72 74 65 64 20 |rs are i|nserted |
|00005f40| 61 73 0a 40 73 61 6d 70 | 7b 24 58 58 7d 2e 20 40 |as.@samp|{$XX}. @|
|00005f50| 78 72 65 66 7b 41 73 73 | 65 6d 62 6c 65 72 7d 2e |xref{Ass|embler}.|
|00005f60| 0a 40 69 74 65 6d 20 45 | 0a 53 74 72 69 6e 67 73 |.@item E|.Strings|
|00005f70| 20 61 72 65 20 70 72 65 | 63 65 64 65 64 20 61 6e | are pre|ceded an|
|00005f80| 64 20 66 6f 6c 6c 6f 77 | 65 64 20 62 79 20 74 68 |d follow|ed by th|
|00005f90| 65 20 63 68 61 72 61 63 | 74 65 72 20 40 73 61 6d |e charac|ter @sam|
|00005fa0| 70 7b 27 7d 2e 20 41 20 | 40 73 61 6d 70 7b 2b 7d |p{'}. A |@samp{+}|
|00005fb0| 0a 63 6f 6e 63 61 74 65 | 6e 61 74 65 73 20 73 74 |.concate|nates st|
|00005fc0| 72 69 6e 67 73 20 77 68 | 69 63 68 20 61 72 65 20 |rings wh|ich are |
|00005fd0| 73 70 72 65 61 64 20 6f | 6e 20 64 69 66 66 65 72 |spread o|n differ|
|00005fe0| 65 6e 74 20 6c 69 6e 65 | 73 2e 20 42 69 6e 61 72 |ent line|s. Binar|
|00005ff0| 79 20 63 68 61 72 61 63 | 74 65 72 73 0a 61 72 65 |y charac|ters.are|
|00006000| 20 69 6e 73 65 72 74 65 | 64 20 6c 69 6b 65 20 69 | inserte|d like i|
|00006010| 6e 20 43 2e 0a 40 65 6e | 64 20 74 61 62 6c 65 0a |n C..@en|d table.|
|00006020| 40 65 6e 64 20 74 61 62 | 6c 65 0a 0a 4c 65 74 27 |@end tab|le..Let'|
|00006030| 73 20 6c 6f 6f 6b 20 61 | 74 20 61 6e 20 65 78 63 |s look a|t an exc|
|00006040| 65 72 70 74 20 66 72 6f | 6d 20 74 68 65 20 66 69 |erpt fro|m the fi|
|00006050| 6c 65 20 40 66 69 6c 65 | 7b 43 5f 68 2e 73 64 7d |le @file|{C_h.sd}|
|00006060| 20 63 72 65 61 74 69 6e | 67 20 61 6e 20 69 6e 63 | creatin|g an inc|
|00006070| 6c 75 64 65 0a 66 69 6c | 65 20 66 6f 72 20 74 68 |lude.fil|e for th|
|00006080| 65 20 70 72 6f 67 72 61 | 6d 6d 69 6e 67 20 6c 61 |e progra|mming la|
|00006090| 6e 67 75 61 67 65 20 43 | 2e 0a 40 65 78 61 6d 70 |nguage C|..@examp|
|000060a0| 6c 65 0a 23 23 73 74 72 | 69 6e 67 74 79 70 65 20 |le.##str|ingtype |
|000060b0| 43 0a 23 23 73 68 6f 72 | 74 73 74 72 69 6e 67 73 |C.##shor|tstrings|
|000060c0| 0a 0a 23 69 66 6e 64 65 | 66 20 25 62 5f 43 41 54 |..#ifnde|f %b_CAT|
|000060d0| 5f 48 20 20 20 20 2f 2a | 09 41 73 73 75 72 65 20 |_H /*|.Assure |
|000060e0| 74 68 61 74 20 74 68 69 | 73 20 69 73 20 72 65 61 |that thi|s is rea|
|000060f0| 64 20 6f 6e 6c 79 20 6f | 6e 63 65 2e 20 2a 2f 0a |d only o|nce. */.|
|00006100| 23 64 65 66 69 6e 65 20 | 25 62 5f 43 41 54 5f 48 |#define |%b_CAT_H|
|00006110| 0a 0a 0a 2f 2a 20 20 47 | 65 74 20 6f 74 68 65 72 |.../* G|et other|
|00006120| 20 69 6e 63 6c 75 64 65 | 20 66 69 6c 65 73 09 2a | include| files.*|
|00006130| 2f 0a 23 69 6e 63 6c 75 | 64 65 20 3c 65 78 65 63 |/.#inclu|de <exec|
|00006140| 2f 74 79 70 65 73 2e 68 | 3e 0a 23 69 6e 63 6c 75 |/types.h|>.#inclu|
|00006150| 64 65 20 3c 6c 69 62 72 | 61 72 69 65 73 2f 6c 6f |de <libr|aries/lo|
|00006160| 63 61 6c 65 2e 68 3e 0a | 0a 0a 2f 2a 20 20 50 72 |cale.h>.|../* Pr|
|00006170| 6f 74 6f 74 79 70 65 73 | 09 2a 2f 0a 65 78 74 65 |ototypes|.*/.exte|
|00006180| 72 6e 20 76 6f 69 64 20 | 4f 70 65 6e 25 62 43 61 |rn void |Open%bCa|
|00006190| 74 61 6c 6f 67 28 73 74 | 72 75 63 74 20 4c 6f 63 |talog(st|ruct Loc|
|000061a0| 61 6c 65 20 2a 2c 20 53 | 54 52 50 54 52 29 3b 0a |ale *, S|TRPTR);.|
|000061b0| 65 78 74 65 72 6e 20 76 | 6f 69 64 20 43 6c 6f 73 |extern v|oid Clos|
|000061c0| 65 25 62 43 61 74 61 6c | 6f 67 28 76 6f 69 64 29 |e%bCatal|og(void)|
|000061d0| 3b 0a 65 78 74 65 72 6e | 20 53 54 52 50 54 52 20 |;.extern| STRPTR |
|000061e0| 47 65 74 25 62 53 74 72 | 69 6e 67 28 4c 4f 4e 47 |Get%bStr|ing(LONG|
|000061f0| 29 3b 0a 0a 2f 2a 20 20 | 44 65 66 69 6e 69 74 69 |);../* |Definiti|
|00006200| 6f 6e 73 20 6f 66 20 74 | 68 65 20 69 64 65 6e 74 |ons of t|he ident|
|00006210| 69 66 69 65 72 73 20 61 | 6e 64 20 74 68 65 69 72 |ifiers a|nd their|
|00006220| 20 49 44 27 73 20 20 20 | 20 20 20 20 20 20 20 20 | ID's | |
|00006230| 2a 2f 0a 2f 2a 20 20 54 | 68 69 73 20 6c 69 6e 65 |*/./* T|his line|
|00006240| 20 77 69 6c 6c 20 62 65 | 20 72 65 70 65 61 74 65 | will be| repeate|
|00006250| 64 20 66 6f 72 20 61 6e | 79 20 73 74 72 69 6e 67 |d for an|y string|
|00006260| 2e 09 09 20 20 20 20 2a | 2f 0a 23 64 65 66 69 6e |... *|/.#defin|
|00006270| 65 20 25 69 20 25 64 0a | 0a 23 65 6e 64 69 66 0a |e %i %d.|.#endif.|
|00006280| 40 65 6e 64 20 65 78 61 | 6d 70 6c 65 0a 0a 46 6f |@end exa|mple..Fo|
|00006290| 72 20 74 68 65 20 73 65 | 61 72 63 68 20 70 61 74 |r the se|arch pat|
|000062a0| 68 20 74 68 61 74 20 69 | 73 20 75 73 65 64 20 66 |h that i|s used f|
|000062b0| 6f 72 20 73 6f 75 72 63 | 65 20 64 65 73 63 72 69 |or sourc|e descri|
|000062c0| 70 74 69 6f 6e 73 20 73 | 65 65 0a 40 70 78 72 65 |ptions s|ee.@pxre|
|000062d0| 66 7b 50 72 6f 67 72 61 | 6d 20 73 74 61 72 74 7d |f{Progra|m start}|
|000062e0| 2e 0a 0a 0a 0a 0a 40 6e | 6f 64 65 20 55 73 69 6e |......@n|ode Usin|
|000062f0| 67 20 46 6c 65 78 43 61 | 74 20 73 6f 75 72 63 65 |g FlexCa|t source|
|00006300| 0a 40 63 68 61 70 74 65 | 72 20 49 6e 63 6c 75 64 |.@chapte|r Includ|
|00006310| 69 6e 67 20 46 6c 65 78 | 43 61 74 20 73 6f 75 72 |ing Flex|Cat sour|
|00006320| 63 65 20 69 6e 20 6f 77 | 6e 20 70 72 6f 67 72 61 |ce in ow|n progra|
|00006330| 6d 73 0a 40 63 69 6e 64 | 65 78 20 55 73 69 6e 67 |ms.@cind|ex Using|
|00006340| 20 46 6c 65 78 43 61 74 | 20 73 6f 75 72 63 65 0a | FlexCat| source.|
|00006350| 40 63 69 6e 64 65 78 20 | 46 6c 65 78 43 61 74 20 |@cindex |FlexCat |
|00006360| 73 6f 75 72 63 65 0a 4f | 66 20 63 6f 75 72 73 65 |source.O|f course|
|00006370| 20 74 68 69 73 20 64 65 | 70 65 6e 64 73 20 6f 6e | this de|pends on|
|00006380| 20 77 68 61 74 20 73 6f | 75 72 63 65 20 69 73 20 | what so|urce is |
|00006390| 63 72 65 61 74 65 64 20 | 61 6e 64 20 68 65 6e 63 |created |and henc|
|000063a0| 65 20 6f 6e 20 74 68 65 | 0a 73 6f 75 72 63 65 20 |e on the|.source |
|000063b0| 64 65 73 63 72 69 70 74 | 69 6f 6e 2e 20 57 68 61 |descript|ion. Wha|
|000063c0| 74 20 77 65 20 61 72 65 | 20 74 61 6c 6b 69 6e 67 |t we are| talking|
|000063d0| 20 68 65 72 65 20 61 62 | 6f 75 74 20 61 72 65 20 | here ab|out are |
|000063e0| 74 68 65 20 73 6f 75 72 | 63 65 20 64 65 73 63 72 |the sour|ce descr|
|000063f0| 69 70 74 69 6f 6e 0a 66 | 69 6c 65 73 20 64 69 73 |iption.f|iles dis|
+--------+-------------------------+-------------------------+--------+--------+
Only 25.0 KB of data is shown above.
