snapshot of project "lynx", label v2-7-1ac_0-6

1 files changed, 52 insertions, 0 deletions

diff --git a/src/chrtrans/README.tables b/src/chrtrans/README.tables
new file mode 100644
index 00000000..94622a99
--- /dev/null
+++ b/src/chrtrans/README.tables
@@ -0,0 +1,52 @@
+The translation table files in this directory are _examples only_.
+They were collected from several sources (among them Linux kbd package, 
+ftp://dkuug.dk/, ftp://unicode.org/) and automatically comverted (if
+applicable), but not checked in detail.  The Unicode/UCS2 values
+for some of the RFC1345 Mnemonic codes are out of date, a cleanup and
+update would be needed for serious use (including removing the mappings
+from the "private zone" U+E000 etc.).
+
+More tranlation files can be easily provided (and new character entities
+added to HTMLDTD.c), this set is just to test whether the system works 
+in principle (and also how it behaves with of incomplete data...)
+
+See the file README.format for a brief explanation of what's in the
+table files.
+
+The examples have names *_uni or *_suni with a .tbl suffix, but it
+doesn't really matter.  The auxiliary program makeuctb (MAKE UniCode
+TaBle) is used to "compile" them into C header files, which can be
+included by UCdomap.c.
+
+Ideally this should be taken care of by the Makefiles..
+
+
+To make a new chartrans table available to Lynx (and thereby make a new
+charset known to Lynx) you currently have to manually edit UCdomap.c, in
+two places:
+
+a) Near the top, you will find a bunch of lines (some may be commented out)
+  
+  #include "chrtrans/<fn>.h"
+
+Add or comment out as you wish. (But it's probably safest to leave the
+first one, referring to "chrtrans/iso01_uni.h", in place...)
+
+b) At the bottom, you will find a bunch of lines (again, some may be
+   commented out by default) of the form
+
+    UC_CHARSET_SETUP_<something>;
+
+which should correspond to the #include lines from a).  Again,
+add or substract as you wish (but preferably consistent with what you
+did under a)...) [The <something> is derived from the charset's MIME name.
+if in doubt, check the last lines of the corresponding ...uni.h file.]
+
+c) To let make automatically notice when you have changed one of the
+   table files, and automatically regenerate the *uni.h file(s), 
+you also have to add any new tables to both src/Makefile *and*
+src/chrtrans/Makefile.  (That may be inconvenient, but I didn't want to
+depend on features than not all makes may have.)  Note that for recompiling
+Lynx, a `make clean' should not be necessary if you have *only* made 
+changes to the files in src/chrtrans.
+