/**	@file	dk3uc2l.h	UC to LaTeX conversion module.

The UC to LaTeX conversion module was redesigned for the following goals:
	- Localization-independent data (i.e. the LaTeX commands for UC
	  characters)
  	  must be separated from localized data
	  (i.e. UC character descriptions).
	- No manual configuration file editing should be necessary when adding
	  or installing new tables to support an additional language.
	- Management of configuration and data files must focus on languages
	  and/or character purposes, not on the position in the UC charts.

So we use the following new mechanism:
	- When the dk3_uc2lat_t object is created, the character map
	  directory is inspected, all *.dir files are processed.
	  Each dir file lists the code ranges (one range per line,
	  start and end character specified as hexadecimal number)
	  defined in the corresponding *.lat file.
	  Here is an example excerpt from the dingbats.dir file:
	  @code
	  2701	2704
	  2706	2709
	  270C	2727
	  @endcode
	  The *.dir files must be ASCII text.
	- The *.lat files files contain the LaTeX code for the characters.
	  Here is an example excerpt from dingbats.lat and two others
	  from iso-latin-1.lat:
	  @code
	  [2701]
	  t\ding{33}
	  ppifont
	  @endcode
	  @code
	  [A9]
	  l\textcopyright{}
	  ptextcomp
	  @endcode
	  @code
	  [2A]
	  t\textasteriskcentered{}
	  m*
	  @endcode
	  The 32-bit value in hexadecimal notation starts a section.
	  A line started by "l" contains LaTeX code to be used in both
	  text and math mode. Lines started by "t" or "m contain text working
	  only in text or math mode. A line started by "p" contains the name
	  of a package required to show that character.
	  The *.lat files must contain ASCII text.
	- A character map application can read additional files:
	  - A *.str file containing the description texts for a character
	    @code
	    A9 Copyright sign
	    2A Centered asterisk
	    @endcode
	    This file resides in the "desc/en" subdirectory of the character
	    map directory or in a directory named like the users preferred
	    language (i.e. "desc/de", "desc/sp"...).
	    The *.str files must be UTF-8 encoded.
	  - A *.png file to show the character. The file for the asterisk
	    is "png/00/00/00/2A.png" in the character map directory.
	  - Files configuring the menu structure and order of appearance.
	    These files must be UTF-8 encoded. They reside in the
	    "desc/en" subdirectory of the character map directory or in a
	    directory named like the users preferred language.
	    @code
	    .1	LATIN
	    .2	ISO-LATIN-1
	    0	FF
	    @endcode
	    @code
	    .1	LATIN
	    .2	Ligatures
	    FB00 FB06
	    @endcode
	    @code
	    .1	LATIN
	    .2	Latin extended
	    0100	024F
	    2C60	2C7F
	    A720	A78E
	    A7A0	A7A9
	    A7FA	A7FF
	    1E00	1EFF
	    @endcode
	    @code
	    .1	LATIN
	    .2	Full-width latin letters
	    FF01	FF60
	    @endcode
*/