home *** CD-ROM | disk | FTP | other *** search
/ MACD 8 / MACD8.iso / polminet / flexcat / flexcat.readme < prev    next >
Encoding:
Text File  |  1998-02-24  |  10.2 KB  |  221 lines
  1. Short:    2.0 - Flexible catalogs (C, Asm, Oberon, E, ARexx, Modula...)
  2. Author:   Marcin Orlowski <carlos@amiga.com.pl>
  3. Uploader: Marcin Orlowski <carlos@amiga.com.pl>
  4. Type:     dev/misc
  5. Version:  2.0
  6. WWW:      http://amiga.com.pl/flexcat/
  7.  
  8.  
  9.  
  10.   INFO
  11.   ----------
  12.  
  13.     FlexCat creates catalogs and the source to handle them.  The difference
  14.   between FlexCat and KitCat, CatComp and some others is, that FlexCat is
  15.   designed to produce any source you want:  any programming language, any
  16.   individual needs should be satisfied.  However, FlexCat is not more
  17.   difficult to use.
  18.  
  19.     This sounds like a contradiction.  FlexCat's solution is to use
  20.   template files, the so called "source descriptions".  Ready to use examples
  21.   for Assembler, C, C++, E, Oberon and Modula-2 are distributed, additionally
  22.   an example for supporting catalogs on Workbench 2.0.  Any other examples
  23.   are welcome.
  24.  
  25.  
  26.   Archives
  27.   ----------
  28.  
  29.     Since release 2.0, the FlexCat distribiution is splitted into the
  30.   smaller archives. They are (in order of importance):
  31.  
  32.   FlexCat.lha          - Latest FlexCat, user contribitions, english manual
  33.                          and foreign catalog files
  34.  
  35.   FlexCat_0x0.lha      - patches for 020, 040 and 060 versions of FlexCat
  36.                          (PPC makes no sense here. I checked that).
  37.  
  38.   FlexCat_XtraDocs.lha - FlexCat's guide in non english languages. Currently
  39.                          Svenska, Espanol and Deutsch are provided
  40.  
  41.   FlexCat_CatSrc.lha   - #?.cd and #?.ct files for existing translations and
  42.                          #?.texinfo documents
  43.  
  44.   If you just want to use FlexCat, the 1st archive is all you need.
  45.   If you want to have CPU optimised binaries, take both 1st and 2nd
  46.   and patch the original release.  If you want to read translated manual,
  47.   get the 3rd one.  If you want to make the translation take the 4th one
  48.   (but I suggesto to join the Amiga Translators' Organisation
  49.   <http://ato.vapor.com/ato> first!)
  50.  
  51.  
  52.   Changes since previous release:
  53.   -------------------------------
  54.  
  55.   * v2.0 (25.02.98) - Unfortunately, 2.0 does not meanw break thru
  56.                       technologies implemented here. It is just the next
  57.                       version numer FlexCat should have...
  58.  
  59.                       Added a workaround for problems some people may
  60.                       encounter while creating catalogs for languages
  61.                       with corrupted converstion table (part of #?.language
  62.                       file). FlexCat uses utility.library function to convert
  63.                       ##language name to lowercase, which leads to
  64.                       wrong strings with e.g. czech environment.
  65.                       Use NOLANGTOLOWER (CLI and prefs) to tell FlexCat
  66.                       to not to lowercase the name (but remember to keep
  67.                       it lowercased manually!).
  68.  
  69.                       FlexCat now uses buffered IO operations.
  70.                       That may increase the overall speed of FlexCat,
  71.                       however it's not the must, so you can use
  72.                       NOBUFFEREDIO switch to fall back to previous
  73.                       poll mode. Please test the overall performance,
  74.                       and tell me the results. The IO buffer is now
  75.                       2048 bytes large.
  76.  
  77.                       While creating new #?.ct file FlexCat puts contents
  78.                       of Language system variable if possible as the
  79.                       #langauge argument.
  80.  
  81.                       Fixed bug causing random memory writes under
  82.                       some, but very rare, circumstances.
  83.  
  84.                       ARexx.sd source descriptor added thanks to
  85.                       Kai Norhausen <kn@tribal.line.org>
  86.  
  87.                       Users' stuff added. Look at the contents of
  88.                       the "Contribution" drawer!
  89.  
  90.                       Renumbered the version of catalog files. Most
  91.                       recent catalog version is 2.0. Older and outdated
  92.                       are 1.x.
  93.  
  94.                       French catalog updated. Thanks to Julien `GiZmO' Wilk
  95.                       <wilkj@esiee.fr>
  96.  
  97.                       Finnish translation updated by Mika Lundell
  98.                       <c71829@uwasa.fi>
  99.  
  100.                       Nederlans translation by Leon Woestenberg
  101.                       <leon@stack.nl>
  102.  
  103.                       Norsk translation thanks to Eivind Olsen
  104.                       <eivindo@bgnett.no>
  105.  
  106.                       Italian catalog updated by Luca Nora
  107.                       <ln546991@silab.dsi.unimi.it> and Giovanni
  108.                       Addabbo <gaddabbo@imar.it>
  109.  
  110.                       Portugese translation updated by Frederico
  111.                       Borges <famb@mail.telepac.pt> and
  112.                       Alexandre Gabriel <chryse@mail.telepac.pt>
  113.  
  114.                       The new spanish translation by Marcos Broc
  115.                       <amiga187@arrakis.es> and Samuel Aguilera
  116.                       <slyguy@mx2.redestb.es>
  117.  
  118.                       Croatian translation by Mladen Ili¹inoviæ
  119.                       <milisino@jagor.srce.hr>
  120.  
  121.  
  122.   * V1.9 (01.08.97) - Now you can use special $TODAY attribute
  123.                       in your $VER string. While creating catalog,
  124.                       $TODAY will be replaced by current date (note,
  125.                       only 1st occurance will be processed). If you
  126.                       want your version strings to always be recent
  127.                       dated type: $VER: FlexCat.catalog 3.0 ($TODAY)
  128.                       NOTE: This string is CASESENSITIVE!
  129.  
  130.                       FlexCat preferences added. To define your own
  131.                       defaults, set the environmental variable
  132.                       "flexcat.prefs" with the contents matching
  133.                       following template: "SDDIR/K,MSG_NEW/K,
  134.                       WARNCTGAPS/S,NOOPTIM/S,FILL/S,FLUSH/S,NOBEEP/S,
  135.                       QUIET/S". Note FlexCat is using ReadArgs()
  136.                       to parse the preferences, thus place all the
  137.                       items in one line.
  138.  
  139.                       If you use FlexCat for #?.ct updating, you
  140.                       probably was missing any additional markers
  141.                       to let you easily find the new strings. Now
  142.                       you get them. By default the "***NEW***", 
  143.                       is used, but you may configure it using
  144.                       FlexCat preferences.
  145.  
  146.                       QUIET switch used to suppress error messages.
  147.                       Fixed.
  148.  
  149.                       New C source descriptor Cat2h_?.sd. Read
  150.                       the manual or Lib/Cat2h.readme for more
  151.                       information.
  152.  
  153.                       Version of updated catalogs bumped to 2.5
  154.  
  155.                       Portugese translation of program catalog, thanks
  156.                       to Frederico Borges <famb@mail.telepac.pt> and
  157.                       Alexandre Gabriel <chryse@mail.telepac.pt>
  158.  
  159.                       Swedish translation of FlexCat manual,
  160.                       thanks to Magnus Holmgren <cmh@lls.se>
  161.  
  162.                       Spanish translation reworked by
  163.                       Marcos Broc <amiga187@arrakis.es> and 
  164.                       Samuel Aguilera <slyguy92@arrakis.es>
  165.  
  166.                       Now FlexCat does DisplayBeep() when any error
  167.                       or warning happen (but don't worry, it's smart
  168.                       enough, so you won't experience any Beep() bombing ;).
  169.                       By using NOBEEP switch you can shut it up.
  170.  
  171.                       Previous releases had problems with comment lines
  172.                       ending with \'s, which made FlexCat think it's multiline
  173.                       string. Now it is not as dumb to get fooled any longer.
  174.  
  175.                       You can now use octal, decimal and hexadecimal
  176.                       (e.g 0x20) digits for all FlexCat digital arguments
  177.                       (like ##version) as well as for (ID/MIN/MAX),
  178.                       ##codeset and others.
  179.  
  180.                       FLUSH switch added. By using it all unused
  181.                       catalogs (but also libraries, fonts, devices etc) will
  182.                       be flushed from memory, whenever new catalog is
  183.                       written. So note: FLUSH works only with CATALOG switch
  184.                       (it means while compiling new catalog).
  185.  
  186.                       New C source descriptors: catcomp_h.sd creates
  187.                       source (almost) identical to CatComp's ones, but
  188.                       expanded for multicatalog support. With this
  189.                       descriptor you can handle more than one catalog
  190.                       in your program harmless.  NOTE:  for compatibility
  191.                       reasons, other descriptors remain unchanged (however
  192.                       additional, multicatalog versions may appear
  193.                       in next release).
  194.  
  195.                       FlexCat does not accept empty ##language argument
  196.                       any longer.
  197.  
  198.                       FILL switch. This feature is highly useful for the
  199.                       translators, and probably for them only. Normally,
  200.                       when you're working on the new translation, some
  201.                       of the strings remains untranslated due the work
  202.                       is just in progress. Unfortunately all catalog
  203.                       tools write all these empty strings into the catalog
  204.                       file, which will cause empty buttons, menus or simmilar
  205.                       things to appear whenever you check your unfinished
  206.                       translation with the program, which isn't nice effect.
  207.                       Using FILL you may force FlexCat to ignore all empty
  208.                       translations (strings from #?.ct file) and instead
  209.                       to write original string (from #?.cd) to the catalog.
  210.                       That prevents you from watching empty GUI etc.
  211.                       NOTE: this option is only for testing purposes.
  212.                       Final catalogs should always be created without FILL
  213.                       switch used!
  214.  
  215.                       English manual is now up-to-date.
  216.  
  217.                       Added %a, %t and %z operands for source
  218.                       descriptors. See (probably english and
  219.                       swedish only, for now) manual for detailed
  220.                       information
  221.