home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Exec 5 / CD_Magazyn_EXEC_nr_5.iso / Recent / dev / misc / catcheck.readme < prev    next >
Text File  |  2001-06-11  |  2KB  |  45 lines
  1. Short:    Amiga catalog tester, v1.4
  2. Author:   Sönke Tesch <soenke@kino-fahrplan.de>
  3. Type:     dev/misc
  4. Replaces: dev/misc/catcheck.lha
  5.  
  6. catcheck is a tool to test catalog files. Catalog files are used on the Amiga
  7. by applications to display strings in your native language rather than only a
  8. fixed build-in like English.
  9.  
  10. catcheck finds a large number of common and not so common errors (which can
  11. be quiet annoying:). While most of these errors are human-made, there are
  12. also some that have their origin in buggy catalog compilers. An exotic
  13. example is the #lengthbytes command, which is, to my knowledge, only
  14. supported by C='s own catalog compiler, catcomp. All other compilers
  15. either complain about an unsupported command or, even worse, ignore
  16. it completely and produce somewhat unusable catalogs.
  17.  
  18. The most common human-made mistakes are:
  19.  
  20.   - missing or removed strings,
  21.   - wrong placement or order of arguments (%s, %1$s and that stuff),
  22.   - use of escaped characters like \", \n etc and the string-continues-
  23.     on-next-line-marker backslash.
  24.   - broken version strings
  25.  
  26.  
  27. catcheck has been written during and for the development of AmigaOS 3.5 in
  28. late 1999 and turned out to be by far more useful than I expected. It's
  29. been improved since then and also been used during AmigaOS 3.9 development.
  30.  
  31.  
  32. Version 1.2 fixes a few tiny bugs since 1.1 that were so small that I even
  33. forgot to add them to the History list :) Apart from that, version string
  34. checking had to be extended to catch yet another common bug.
  35.  
  36. Version 1.3 fixed a bug in the version name checking added in 1.2.
  37.  
  38. Version 1.4 features a fully working DUMPCT (which earlier existed only
  39. for debugging and produced anything but good results) along with a few
  40. enhancements.
  41.  
  42.  
  43. Hope you like it,
  44.   soenk.e
  45.