home *** CD-ROM | disk | FTP | other *** search
/ Amiga Games 1995 January / amigagames-1995-01.iso / archive / userbox / publicdomain / ged313.lha / Install / data / tools / Cat / ReadMe < prev    next >
Text File  |  1994-12-04  |  4KB  |  76 lines
  1. CAT ©1994 Dietmar Eilert
  2. All Rights Reserved
  3.                               --- INTRODUCTION ---
  4.  
  5. This drawer containes the CAT catalog  development  tool  and  a  multi-language
  6. catalog  description file "golded.base". CAT is a shell-based application. Using
  7. CAT you may reproduce any catalog file  distributed  with  GoldED  (CAT  is  not
  8. GoldED-specific).  Catalog  files  are required by the AmigaOS to make a program
  9. use the selected language of your workbench (OS2.1  or  better  only).  You  may
  10. change existings catalogs or add new languages/translations to GoldED by editing
  11. the "golded.base" file. Once this is done,  run  "golded.base"  through  CAT  to
  12. create  a  working  standard  catalog  file. These files are usually kept in the
  13. "locale:catalogs/language" drawers. Have a look at the  "golded.base"  file  for
  14. more information. "golded.base" is a standard ASCII file, use GoldED to load and
  15. edit it. Description of CAT options:
  16.  
  17. command    option            description
  18. -------------------------------------------------------------------------------
  19. CAT        D=DATABASE/K/A    source: multi-language string file
  20.            C=CATALOG/S       create a standard catalog file
  21.            L=LANGUAGE/K/A    language to use (e.g. deutsch)
  22.            I=IMPORT/K        import strings from this multi-language file
  23.            A=ALL/S           import all strings regardless of creation date
  24.  
  25. Since CAT is  a  CatComp  frontend,  Commodore's  development  tool  CatComp  is
  26. required to create a usable catalog (CatComp 38.16 or better). The advantages of
  27. CAT over a stand-alone CatComp usage:
  28.  
  29.            o multi-language definitions within a single file
  30.            o import of old catalogs after version changes
  31.            o database includes date of last change for each string
  32.            o usage of default-language if translated strings are missing
  33.            o pattern matching to ensure correct translations
  34.            o developer may mark strings as 'fixed'
  35.  
  36.  
  37.                                --- EXAMPLES ---
  38. (A)
  39.  
  40. Example to create the German catalog using strings found in  the  multi-language
  41. file  "golded.base"  (a file requester will pop up, asking you for a destination
  42. path for the catalog file):
  43.  
  44.        CAT DATABASE=golded.base CATALOG LANGUAGE=D
  45.    or: CAT DATABASE=golded.base CATALOG LANGUAGE=DEUTSCH
  46.  
  47. Please check the database "golded.base"  for  available  languages  -  they  are
  48. listed at the beginning of this file (short and long form).
  49.  
  50. (B)
  51.  
  52. Example to create catalogs for all languages found in  the  multi-language  file
  53. "golded.base"  (a  file requester will pop up, asking you for a destination path
  54. for each catalog file):
  55.  
  56.        CAT DATABASE=golded.base CATALOG LANGUAGE=*
  57.  
  58. (C)
  59.  
  60. Example to import your own German translations from a file called "private.base"
  61. into  the  latest  database  "golded.base"  shipped with GoldED (considering new
  62. strings only, do not overwrite more recent sections of "golded.base"):
  63.  
  64.        CAT DATABASE=golded.base IMPORT=old.base LANGUAGE=D
  65.    or: CAT DATABASE=golded.base IMPORT=old.base LANGUAGE=DEUTSCH
  66.  
  67. (D)
  68.  
  69. Example to import your own German translations from a file called "private.base"
  70. into  the  latest  database  "golded.base"  shipped  with  GoldED, replacing all
  71. strings  of  specified  language  no  matter  wether  there  are   more   recent
  72. translations in "golded.base" (usage of this option is discouraged):
  73.  
  74.        CAT DATABASE=golded.base IMPORT=old.base ALL LANGUAGE=D
  75.    or: CAT DATABASE=golded.base IMPORT=old.base ALL LANGUAGE=DEUTSCH
  76.