home *** CD-ROM | disk | FTP | other *** search
/ Dream 52 / Amiga_Dream_52.iso / Linux / Divers / lynx2.8.1dev.10.tar.gz / lynx2.8.1dev.10.tar / lynx2-8 / src / chrtrans / README.tables < prev    next >
Text File  |  1998-05-02  |  3KB  |  60 lines

  1. The translation table files in this directory were collected from
  2. several sources (among them ftp://ftp.unicode.org, Linux kbd package,
  3. ftp://dkuug.dk/) and are believed to be correct in their mappings,
  4. but not checked in detail.  The Unicode/UCS2 values
  5. for some of the RFC 1345 Mnemonic codes are out of date,
  6. a cleanup and update would be needed for serious use.
  7.  
  8. More translation files can be easily provided (and new character entities
  9. added to entities.h), this set is just to test whether the system works
  10. in principle (and also how it behaves with incomplete data...)
  11.  
  12. See the file README.format for a brief explanation of what's in the
  13. table files.
  14.  
  15. The examples have names *_uni or *_suni with a .tbl suffix, but it
  16. doesn't really matter.  The auxiliary program makeuctb (MAKE UniCode
  17. TaBle) is used to "compile" them into C header files, which can be
  18. included by UCdomap.c.
  19.  
  20. Ideally, this should be taken care of by the Makefiles.  On VMS, use
  21. build-chrtrans.com to compile and link makeuctb.exe and create the
  22. set of .h files from the current set of .tbl files.  Thereafter, use
  23. build-header.com to update particular .h files.
  24.  
  25. To make a new chartrans table available to Lynx (and thereby make a new
  26. charset known to Lynx) you currently have to manually edit UCdomap.c, in
  27. two places:
  28.  
  29. a) Near the top, you will find a bunch of lines (some may be commented out)
  30.  
  31.   #include "<fn>.h"
  32.  
  33. Add or comment out as you wish.  But it is probably safest to leave the
  34. commonly used ones, referring to "def7_uni.h" and "iso01_uni.h", in place.
  35.  
  36. b) At the bottom, you will find a bunch of lines (again, some may be
  37.    commented out by default) of the form
  38.  
  39.     UC_CHARSET_SETUP_<something>;
  40.  
  41. which should correspond to the #include lines from a).  Again,
  42. add or subtract as you wish (but preferably consistent with what you
  43. did under a)...) [The <something> is derived from the charset's MIME name.
  44. if in doubt, check the last lines of the corresponding ...uni.h file.]
  45.  
  46. c) To let make automatically notice when you have changed one of the
  47.    table files, and automatically regenerate the *uni.h file(s),
  48. you also have to add any new tables to both src/Makefile *and*
  49. src/chrtrans/Makefile.  Or, for auto-config, the equivalent files
  50. named makefile.in before running ./configure, or makefile after running
  51. ./configure.  (That may be inconvenient, but I didn't want to depend
  52. on features than not all makes may have.)  Note that for recompiling
  53. Lynx, a `make clean' should not be necessary if you have *only* made
  54. changes to the files in src/chrtrans.  On VMS, add entries for new
  55. tables to build-chrtrans.com, but you can update the particular file
  56. with build-header.com, then use the top directory's build.com and
  57. answer 'n' to it's prompts about whether to update the WWWlibrary
  58. and chrtrans modules.
  59.  
  60.