Initial revision
[platform/upstream/fontconfig.git] / fonts.dtd
1 <!-- This is the Document Type Definition for font configuration files -->
2 <!ELEMENT fontconfig (dir | 
3                       cache | 
4                       include | 
5                       config |
6                       match | 
7                       alias)* >
8
9 <!-- 
10     Add a directory that provides fonts
11 -->
12 <!ELEMENT dir (#PCDATA)>
13 <!ATTLIST dir xml:space (default|preserve) 'preserve'>
14
15 <!--
16     Define the per-user file that holds cache font information.
17
18     If the filename begins with '~', it is replaced with the users
19     home directory path.
20 -->
21 <!ELEMENT cache (#PCDATA)>
22 <!ATTLIST cache xml:space (default|preserve) 'preserve'>
23
24 <!--
25     Reference another configuration file; note that this
26     is another complete font configuration file and not
27     just a file included by the XML parser.
28
29     Set 'ignore_missing' to 'yes' if errors are to be ignored.
30
31     If the filename begins with '~', it is replaced with the users
32     home directory path.
33 -->
34 <!ELEMENT include (#PCDATA)>
35 <!ATTLIST include
36           ignore_missing    (no|yes)            "no"
37           xml:space         (default|preserve)  "preserve">
38
39 <!--
40     Global library configuration data
41  -->
42 <!ELEMENT config (blanks)*>
43
44 <!--
45     Specify the set of Unicode encoding values which
46     represent glyphs that are allowed to contain no
47     data.  With this list, fontconfig can examine
48     fonts for broken glyphs and eliminate them from
49     the set of valid Unicode chars.  This idea
50     was borrowed from Mozilla
51  -->
52 <!ELEMENT blanks (int)*>
53
54 <!--
55     Aliases are just a special case for multiple match elements
56
57     They are syntactically equivalent to:
58
59     <match>
60         <test name="family">
61             <string value=[family]/>
62         </test>
63         <edit name="family" mode="prepend">
64             <string value=[prefer]/>
65             ...
66         </edit>
67         <edit name="family" mode="append">
68             <string value=[accept]/>
69             ...
70         </edit>
71         <edit name="family" mode="append_last">
72             <string value=[default]/>
73             ...
74         </edit>
75     </match>
76 -->
77 <!ELEMENT alias (family, prefer?, accept?, default?)>
78 <!ELEMENT prefer (family)*>
79 <!ELEMENT accept (family)*>
80 <!ELEMENT default (family)*>
81 <!ELEMENT family (#PCDATA)>
82 <!ATTLIST family xml:space (default|preserve) 'preserve'>
83
84 <!ENTITY % expr 'int|double|string|matrix|bool|charset
85                 |name|const
86                 |or|and|eq|not_eq|less|less_eq|more|more_eq
87                 |plus|minus|times|divide|not|if'>
88
89 <!--
90     Match and edit patterns.
91
92     If 'target' is 'pattern', execute the match before selecting a font.
93     if 'target' is 'font', execute the match on the result of a font
94     selection.
95 -->
96 <!ELEMENT match (test*, edit*)>
97 <!ATTLIST match
98           target (pattern|font) "pattern">
99
100 <!--
101     Match a field in a pattern
102
103     if 'qual' is 'any', then the match succeeds if any value in the field matches.
104     if 'qual' is 'all', then the match succeeds only if all values match.
105 -->
106 <!ELEMENT test (%expr;)>
107 <!ATTLIST test 
108           qual (any|all)    "any"
109           name CDATA        #REQUIRED
110           compare (eq|not_eq|less|less_eq|more|more_eq) "eq">
111
112 <!--
113     Edit a field in a pattern
114
115     The enclosed values are used together to edit the list of values
116     associated with 'name'.
117
118     If 'name' matches one of those used in a test element for this match element:
119         if 'mode' is 'assign', replace the matched value.
120         if 'mode' is 'assign_replace', replace all of the values
121         if 'mode' is 'prepend', insert before the matched value
122         if 'mode' is 'append', insert after the matched value
123         if 'mode' is 'prepend_first', insert before all of the values
124         if 'mode' is 'append_last', insert after all of the values
125     If 'name' doesn't match any of those used in a test element:
126         if 'mode' is 'assign' or 'assign_replace, replace all of the values
127         if 'mode' is 'prepend' or 'prepend_first', insert before all of the values
128         if 'mode' is 'append' or 'append_last', insert after all of the values
129 -->
130 <!ELEMENT edit (%expr;)*>
131 <!ATTLIST edit
132           name CDATA        #REQUIRED
133           mode (assign|assign_replace|prepend|append|prepend_first|append_last) "assign">
134
135 <!--
136     Elements of expressions follow
137 -->
138 <!ELEMENT int (#PCDATA)>
139 <!ATTLIST int xml:space (default|preserve) 'preserve'>
140 <!ELEMENT double (#PCDATA)>
141 <!ATTLIST double xml:space (default|preserve) 'preserve'>
142 <!ELEMENT string (#PCDATA)>
143 <!ATTLIST string xml:space (default|preserve) 'preserve'>
144 <!ELEMENT matrix (double,double,double,double)>
145 <!ELEMENT bool (true|false)>
146 <!ELEMENT charset (#PCDATA)>
147 <!ATTLIST charset xml:space (default|preserve) 'preserve'>
148 <!ELEMENT name (#PCDATA)>
149 <!ATTLIST name xml:space (default|preserve) 'preserve'>
150 <!ELEMENT const (#PCDATA)>
151 <!ATTLIST const xml:space (default|preserve) 'preserve'>
152 <!ELEMENT or (%expr;)*>
153 <!ELEMENT and (%expr;)*>
154 <!ELEMENT eq ((%expr;), (%expr;))>
155 <!ELEMENT not_eq ((%expr;), (%expr;))>
156 <!ELEMENT less ((%expr;), (%expr;))>
157 <!ELEMENT less_eq ((%expr;), (%expr;))>
158 <!ELEMENT more ((%expr;), (%expr;))>
159 <!ELEMENT more_eq ((%expr;), (%expr;))>
160 <!ELEMENT plus (%expr;)*>
161 <!ELEMENT minus (%expr;)*>
162 <!ELEMENT times (%expr;)*>
163 <!ELEMENT divide (%expr;)*>
164 <!ELEMENT not (%expr;)>
165 <!ELEMENT if ((%expr;), (%expr;), (%expr;))>