The m17n database and API for it.
Directory for application specific data.
The m17n library acquires various kinds of information from data in the m17ndatabase on demand.
Application programs can also add/load their original data to/from the m17n database by setting the
variable mdatabase_dir to an application-specific directory and storing data in it. Users can overwrite
those data by storing preferable data in the directory specified by the environment variable 'M17NDIR',
or if it is not set, in the directory '~/.m17n.d'.
The m17n database contains multiple heterogeneous data, and each data is identified by four tags; TAG0,
TAG1, TAG2, TAG3. Each tag must be a symbol.
TAG0 specifies the type of data stored in the database as below.
• If TAG0 is Mchar_table, the data is of the chartabletype and provides information about each
character. In this case, TAG1 specifies the type of the information and must be Msymbol, Minteger,
Mstring, Mtext, or Mplist. TAG2 and TAG3 can be any symbols.
• If TAG0 is Mcharset, the data is of the charsettype and provides a decode/encode mapping table for a
charset. In this case, TAG1 must be a symbol representing a charset. TAG2 and TAG3 can be any symbols.
• If TAG0 is neither Mchar_table nor Mcharset, the data is of the plisttype. See the documentation of
the mdatabase_load() function for the details.
In this case, TAG1, TAG2, and TAG3 can be any symbols.
The notation <TAG0, TAG1, TAG2, TAG3> means a data with those tags.
Application programs first calls the mdatabase_find() function to get a pointer to an object of the type
MDatabase. That object holds information about the specified data. When it is successfully returned, the
mdatabase_load() function loads the data. The implementation of the structure MDatabase is concealed from
application programs.
If an application program wants to provide a data specific to the program or a data overriding what
supplied by the m17n database, it must set this variable to a name of directory that contains the data
files before it calls the macro M17N_INIT(). The directory may contain a file 'mdb.dir' which contains a
list of data definitions in the format described in mdbDir(5).
The default value is NULL.