(%.tab): Fix previous change.
[m17n/m17n-db.git] / FORMATS / FontEncoding.txt
1 /* Copyright (C) 2003, 2004
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 mdbFontEncoding Font Encoding
9
10 @section font-encoding-description DESCRIPTION
11
12 The m17n library loads information about the encoding of each font
13 form the m17n database by the tags \<font, encoding\>.  The data is
14 loaded as a plist of this format.
15
16 @verbatim
17 FONT-ENCODING ::= PER-FONT *
18
19 PER-FONT ::= '(' FONT-SPEC ENCODING [ REPERTORY ] ')'
20
21 FONT-SPEC ::=
22     '(' [ FOUNDRY FAMILY
23           [ WEIGHT [ STYLE [ STRETCH [ ADSTYLE ]]]]]
24         REGISTRY ')'
25
26 ENCODING ::= SYMBOL
27 @endverbatim
28
29 @c FONT-SPEC is to specify properties of a font.  @c FOUNDRY to @c
30 REGISTRY are symbols corresponding to #Mfoundry to #Mregistry property
31 of a font.  See @ref m17nFont for the meaning of each property.
32
33 For instance, this @c FONT-SPEC:
34
35 @verbatim
36     (nil alice0\ lao iso8859-1)
37 @endverbatim
38
39 should be applied to all fonts whose family name is "alice0 lao", and
40 registry is "iso8859-1".
41
42 @c ENCODING is a symbol representing a charset.  A font matching @c
43 FONT-SPEC supports all characters of the charset, and a character code
44 is mapped to the corresponding glyph code of the font by this charset.
45
46 @c REPERTORY is a symbol representing a charset or "nil".  Omitting it
47 is the same as specifying @c ENCODING as @c REPERTORY.  If it is not
48 "nil", the charset specifies the repertory of the font, i.e, which
49 character it supports.  Otherwise, whether a specific character is
50 supported by the font or not is asked to each font driver.
51
52 For so called Unicode fonts (registry is "iso10646-1"), it is
53 recommended to specify "nil" as @c REPERTORY because such fonts
54 usually supports only a subset of Unicode characters.  */
55
56 /* 
57 Copyright (C) 2003, 2004
58   National Institute of Advanced Industrial Science and Technology (AIST)
59   Registration Number H15PRO112
60
61 This file is part of the m17n database; a sub-part of the m17n
62 library.
63
64 The m17n library is free software; you can redistribute it and/or
65 modify it under the terms of the GNU Lesser General Public License
66 as published by the Free Software Foundation; either version 2.1 of
67 the License, or (at your option) any later version.
68
69 The m17n library is distributed in the hope that it will be useful,
70 but WITHOUT ANY WARRANTY; without even the implied warranty of
71 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
72 Lesser General Public License for more details.
73
74 You should have received a copy of the GNU Lesser General Public
75 License along with the m17n library; if not, write to the Free
76 Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
77 Boston, MA 02110-1301, USA.
78 */