*** empty log message ***
[m17n/m17n-db.git] / FORMATS / Dir.txt
1 /* Copyright (C) 2003, 2004, 2005
2      National Institute of Advanced Industrial Science and Technology (AIST)
3      Registration Number H15PRO112
4    See the end for copying conditions.  */
5
6 /***en
7
8 @page mdbDir List of data in a database directory.
9
10 @section dir-description DESCRIPTION
11
12 The m17n library loads a list of definitions of data of the m17n
13 database from files of name "mdb.dir" in each database directory at
14 initialization time.  The plist format of this file is as follows:
15
16 @verbatim
17 MDB-DIR ::= DEFINITION *
18
19 DEFINITION ::= '(' TAG0 [ TAG1 [ TAG2 [ TAG3 ] ] ] FILE [ VERSION ]')'
20
21 TAGn ::= SYMBOL
22
23 FILE ::= MTEXT
24
25 VERSION ::= MTEXT
26 @endverbatim
27
28 If TAG0 is neither `charset' nor `char-table', and TAGn (n > 0) is a
29 symbol `*', FILE can contain a wildcard charater, and all files
30 matching FILE accoding to the rules used by the shell are the target
31 of database files.  In that case, each file must contain a plist
32 element providing the actual TAGn values by the form:
33
34 @verbatim
35 '(' TAG0 TAG1 TAG2 TAG3 [ VERSION ] ')'
36 @endverbatim
37
38 For instance, if a database directory contains these files:
39
40 @verbatim
41 zh-py.mim:
42 (input-method zh py)
43 ...
44
45 ko-han2.mim:
46 (input-method ko han2)
47 ...
48 @endverbatim
49
50 these lines in "mdb.dir":
51
52 @verbatim
53 (input-method zh py "zh-py.mim")
54 (input-method ko han2 "ko-han2.mim")
55 @endverbatim
56
57 can be shortened to this single line:
58
59 @verbatim
60 (input-method * "*.mim")
61 @endverbatim
62
63 VERSION is a required version number of the m17n library.  The format
64 is "XX.YY.ZZ" where XX is a major version number, YY is a minor
65 version number, and ZZ is a patch level.
66
67 */
68
69 /* 
70 Copyright (C) 2003, 2004, 2005
71   National Institute of Advanced Industrial Science and Technology (AIST)
72   Registration Number H15PRO112
73
74 This file is part of the m17n database; a sub-part of the m17n
75 library.
76
77 The m17n library is free software; you can redistribute it and/or
78 modify it under the terms of the GNU Lesser General Public License
79 as published by the Free Software Foundation; either version 2.1 of
80 the License, or (at your option) any later version.
81
82 The m17n library is distributed in the hope that it will be useful,
83 but WITHOUT ANY WARRANTY; without even the implied warranty of
84 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
85 Lesser General Public License for more details.
86
87 You should have received a copy of the GNU Lesser General Public
88 License along with the m17n library; if not, write to the Free
89 Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
90 Boston, MA 02110-1301, USA.
91 */