home *** CD-ROM | disk | FTP | other *** search
/ Amiga Times / AmigaTimes.iso / programme / GoldED / tools / cat / ReadMe < prev   
Encoding:
Text File  |  1998-10-06  |  3.7 KB  |  90 lines
  1. COPYIGHT
  2.  
  3.   ©1996  Dietmar  Eilert  (e-mail:  DIETMAR@TOMATE.TNG.OCHE.DE).  All  Rights
  4.   Reserved. Neither icons, binaries nor code may be reused/reproduced without
  5.   written permission of the author.
  6.  
  7.   Dietmar Eilert
  8.   Mies-v-d-Rohe-Str.31, 52074 Aachen, Germany
  9.   E-Mail: DIETMAR@TOMATE.TNG.OCHE.DE
  10.   Tel: +49-(0)241-81665
  11.        +49-(0)2525-7776
  12.   Fax: +49-(0)241-81665
  13.  
  14.  
  15. INTRODUCTION
  16.  
  17.   This drawer containes the CAT catalog development tool and a multi-language
  18.   catalog  description  file "golded.base". CAT is a shell-based application.
  19.   Using CAT you may reproduce any catalog file distributed with  GoldED  (CAT
  20.   is  not GoldED-specific). Catalog files are required by the AmigaOS to make
  21.   a program use the selected language of  your  workbench  (OS2.1  or  better
  22.   only).  You may change existings catalogs or add new languages/translations
  23.   to GoldED by editing  the  "golded.base"  file.  Once  this  is  done,  run
  24.   "golded.base"  through CAT to create a working standard catalog file. These
  25.   files are usually kept in the "locale:catalogs/language"  drawers.  Have  a
  26.   look  at  the  "golded.base"  file for more information. "golded.base" is a
  27.   standard ASCII file, use GoldED to load and edit  it.  Description  of  CAT
  28.   options:
  29.  
  30.   command    option            description
  31.   ---------------------------------------------------------------------------
  32.   CAT        D=DATABASE/K/A    source: multi-language string file
  33.              C=CATALOG/S       create a standard catalog file
  34.              L=LANGUAGE/K/A    language to use (e.g. deutsch)
  35.              I=IMPORT/K        import strings from this multi-language file
  36.              A=ALL/S           import all strings regardless of creation date
  37.  
  38.   Since CAT is a CatComp frontend, Commodore's development  tool  CatComp  is
  39.   required  to  create  a  usable  catalog  (CatComp  38.16  or  better). The
  40.   advantages of CAT over a stand-alone CatComp usage:
  41.  
  42.   - multi-language definitions within a single file
  43.   - import of old catalogs after version changes
  44.   - database includes date of last change for each string
  45.   - usage of default-language if translated strings are missing
  46.   - pattern matching to ensure correct translations
  47.   - developer may mark strings as 'fixed'
  48.  
  49.  
  50. EXAMPLES
  51.  
  52. (A)
  53.  
  54. Example to create the German catalog using strings found in  the  multi-language
  55. file  "golded.base"  (a file requester will pop up, asking you for a destination
  56. path for the catalog file):
  57.  
  58.        CAT DATABASE=golded.base CATALOG LANGUAGE=D
  59.    or: CAT DATABASE=golded.base CATALOG LANGUAGE=DEUTSCH
  60.  
  61. Please check the database "golded.base"  for  available  languages  -  they  are
  62. listed at the beginning of this file (short and long form).
  63.  
  64. (B)
  65.  
  66. Example to create catalogs for all languages found in  the  multi-language  file
  67. "golded.base"  (a  file requester will pop up, asking you for a destination path
  68. for each catalog file):
  69.  
  70.        CAT DATABASE=golded.base CATALOG LANGUAGE=*
  71.  
  72. (C)
  73.  
  74. Example to import your own German translations from a file called "private.base"
  75. into  the  latest  database  "golded.base"  shipped with GoldED (considering new
  76. strings only, do not overwrite more recent sections of "golded.base"):
  77.  
  78.        CAT DATABASE=golded.base IMPORT=old.base LANGUAGE=D
  79.    or: CAT DATABASE=golded.base IMPORT=old.base LANGUAGE=DEUTSCH
  80.  
  81. (D)
  82.  
  83. Example to import your own German translations from a file called "private.base"
  84. into  the  latest  database  "golded.base"  shipped  with  GoldED, replacing all
  85. strings  of  specified  language  no  matter  wether  there  are   more   recent
  86. translations in "golded.base" (usage of this option is discouraged):
  87.  
  88.        CAT DATABASE=golded.base IMPORT=old.base ALL LANGUAGE=D
  89.    or: CAT DATABASE=golded.base IMPORT=old.base ALL LANGUAGE=DEUTSCH
  90.