Emphasize that fonts.conf isnt the right place for local configuration
[platform/upstream/fontconfig.git] / fonts.conf.in
1 <?xml version="1.0"?>
2 <!DOCTYPE fontconfig SYSTEM "fonts.dtd">
3 <!-- /etc/fonts/fonts.conf file to configure system font access -->
4 <fontconfig>
5
6 <!--
7         DO NOT EDIT THIS FILE.
8         IT WILL BE REPLACED WHEN FONTCONFIG IS UPDATED.
9         LOCAL CHANGES BELONG IN 'local.conf'.
10
11         The intent of this standard configuration file is to be adequate for
12         most environments.  If you have a reasonably normal environment and
13         have found problems with this configuration, they are probably
14         things that others will also want fixed.  Please send any suggested
15         changes to fonts@xfree86.org so that future releases can include
16         such changes.
17
18         Note that the normal 'make install' procedure for fontconfig is to
19         replace any existing fonts.conf file with the new version.  Place
20         any local customizations in local.conf which this file references.
21
22         Keith Packard
23 -->
24
25 <!-- FONTPATH_START -->
26
27 <!-- 
28   Common X11R6 font directories
29 -->
30
31         <dir>/usr/X11R6/lib/X11/fonts</dir>
32         <dir>/usr/share/fonts</dir>
33         <dir>~/.fonts</dir>
34
35 <!-- FONTPATH_END -->
36
37 <!--
38   Enable sub-pixel rendering
39         <match target="font">
40                 <test qual="all" name="rgba">
41                         <const>unknown</const>
42                 </test>
43                 <edit name="rgba" mode="assign"><const>rgb</const></edit>
44         </match>
45 -->
46
47 <!--
48   Accept deprecated 'mono' alias, replacing it with 'monospace'
49 -->
50         <match target="pattern">
51                 <test qual="any" name="family">
52                         <string>mono</string>
53                 </test>
54                 <edit name="family" mode="assign">
55                         <string>monospace</string>
56                 </edit>
57         </match>
58
59 <!--
60   Accept alternate 'sans serif' spelling, replacing it with 'sans-serif'
61 -->
62         <match target="pattern">
63                 <test qual="any" name="family">
64                         <string>sans serif</string>
65                 </test>
66                 <edit name="family" mode="assign">
67                         <string>sans-serif</string>
68                 </edit>
69         </match>
70
71 <!--
72   Accept deprecated 'sans' alias, replacing it with 'sans-serif'
73 -->
74         <match target="pattern">
75                 <test qual="any" name="family">
76                         <string>sans</string>
77                 </test>
78                 <edit name="family" mode="assign">
79                         <string>sans-serif</string>
80                 </edit>
81         </match>
82
83 <!--
84   Mark common families with their generics so we'll get
85   something reasonable
86 -->
87
88 <!--
89   Serif faces
90  -->
91         <alias>
92                 <family>Times</family>
93                 <family>Times New Roman</family>
94                 <family>Nimbus Roman No9 L</family>
95                 <family>Luxi Serif</family>
96                 <family>Kochi Mincho</family>
97                 <family>AR PL SungtiL GB</family>
98                 <family>AR PL Mingti2L Big5</family>
99                 <family>Baekmuk Batang</family>                 
100                 <default><family>serif</family></default>
101         </alias>
102 <!--
103   Sans-serif faces
104  -->
105         <alias>
106                 <family>Helvetica</family>
107                 <family>Arial</family>
108                 <family>Verdana</family>
109                 <family>Nimbus Sans L</family>
110                 <family>Luxi Sans</family>
111                 <family>Kochi Gothic</family>
112                 <family>AR PL KaitiM GB</family>
113                 <family>AR PL KaitiM Big5</family>
114                 <family>Baekmuk Dotum</family>
115                 <family>SimSun</family>
116                 <default><family>sans-serif</family></default>
117         </alias>
118 <!--
119   Monospace faces
120  -->
121         <alias>
122                 <family>Courier</family>
123                 <family>Courier New</family>
124                 <family>Andale Mono</family>
125                 <family>Luxi Mono</family>
126                 <family>Nimbus Mono L</family>
127                 <family>NSimSun</family>
128                 <default><family>monospace</family></default>
129         </alias>
130 <!--
131   If the font still has no generic name, add sans-serif
132  -->
133         <match target="pattern">
134                 <test qual="all" name="family" compare="not_eq">
135                         <string>sans-serif</string>
136                 </test>
137                 <test qual="all" name="family" compare="not_eq">
138                         <string>serif</string>
139                 </test>
140                 <test qual="all" name="family" compare="not_eq">
141                         <string>monospace</string>
142                 </test>
143                 <edit name="family" mode="append_last">
144                         <string>sans-serif</string>
145                 </edit>
146         </match>
147         
148 <!--
149   Load per-user customization file
150 -->
151         <include ignore_missing="yes">~/.fonts.conf</include>
152
153 <!--
154   Load local system customization file
155 -->
156         <include ignore_missing="yes">local.conf</include>
157
158 <!--
159   Alias well known font names to available TrueType fonts
160 -->
161         <alias>
162                 <family>Times</family>
163                 <accept><family>Times New Roman</family></accept>
164         </alias>
165         <alias>
166                 <family>Helvetica</family>
167                 <accept><family>Verdana</family></accept>
168         </alias>
169         <alias>
170                 <family>Arial</family>
171                 <accept><family>Verdana</family></accept>
172         </alias>
173         <alias>
174                 <family>Courier</family>
175                 <accept><family>Courier New</family></accept>
176         </alias>
177
178 <!--
179   Provide required aliases for standard names
180 -->
181         <alias>
182                 <family>serif</family>
183                 <prefer>
184                         <family>Times New Roman</family>
185                         <family>Nimbus Roman No9 L</family>
186                         <family>Luxi Serif</family>
187                         <family>Times</family>
188                         <family>Kochi Mincho</family>
189                         <family>AR PL SungtiL GB</family>
190                         <family>AR PL Mingti2L Big5</family>
191                         <family>Baekmuk Batang</family>                 
192                 </prefer>
193         </alias>
194         <alias>
195                 <family>sans-serif</family>
196                 <prefer>
197                         <family>Verdana</family>
198                         <family>Nimbus Sans L</family>
199                         <family>Luxi Sans</family>
200                         <family>Arial</family>
201                         <family>Helvetica</family>
202                         <family>Kochi Gothic</family>
203                         <family>AR PL KaitiM GB</family>
204                         <family>AR PL KaitiM Big5</family>
205                         <family>Baekmuk Dotum</family>
206                         <family>SimSun</family>
207                 </prefer>
208         </alias>
209         <alias>
210                 <family>monospace</family>
211                 <prefer>
212                         <family>Andale Mono</family>
213                         <family>Courier New</family>
214                         <family>Luxi Mono</family>
215                         <family>Nimbus Mono L</family>
216                         <family>Kochi Gothic</family>
217                         <family>AR PL KaitiM GB</family>
218                         <family>Baekmuk Dotum</family>
219                 </prefer>
220         </alias>
221
222 <!-- 
223  Artificial oblique for fonts without an italic or oblique version
224  -->
225  
226         <match target="font">
227                 <!-- check to see if the font is roman -->
228                 <test name="slant">
229                         <const>roman</const>
230                 </test>
231                 <!-- check to see if the pattern requested non-roman -->
232                 <test target="pattern" name="slant" compare="not_eq">
233                         <const>roman</const>
234                 </test>
235                 <!-- multiply the matrix to slant the font -->
236                 <edit name="matrix" mode="assign">
237                         <times>
238                                 <name>matrix</name>
239                                 <matrix><double>1</double><double>.2</double>
240                                         <double>0</double><double>1</double>
241                                 </matrix>
242                         </times>
243                 </edit>
244                 <!-- pretend the font is oblique now -->
245                 <edit name="slant" mode="assign">
246                         <const>oblique</const>
247                 </edit>
248         </match>
249
250         <config>
251 <!--
252   These are the default Unicode chars that are expected to be blank
253   in fonts.  All other blank chars are assumed to be broken and
254   won't appear in the resulting charsets
255  -->
256                 <blank>
257                         <int>0x0020</int>       <!-- SPACE -->
258                         <int>0x00a0</int>       <!-- NO-BREAK SPACE -->
259                         <int>0x00ad</int>       <!-- SOFT HYPHEN -->
260                         <int>0x115f</int>       <!-- HANGUL CHOSEONG FILLER -->
261                         <int>0x1160</int>       <!-- HANGUL JUNGSEONG FILLER -->
262                         <int>0x1680</int>       <!-- OGHAM SPACE MARK -->
263                         <int>0x2000</int>       <!-- EN QUAD -->
264                         <int>0x2001</int>       <!-- EM QUAD -->
265                         <int>0x2002</int>       <!-- EN SPACE -->
266                         <int>0x2003</int>       <!-- EM SPACE -->
267                         <int>0x2004</int>       <!-- THREE-PER-EM SPACE -->
268                         <int>0x2005</int>       <!-- FOUR-PER-EM SPACE -->
269                         <int>0x2006</int>       <!-- SIX-PER-EM SPACE -->
270                         <int>0x2007</int>       <!-- FIGURE SPACE -->
271                         <int>0x2008</int>       <!-- PUNCTUATION SPACE -->
272                         <int>0x2009</int>       <!-- THIN SPACE -->
273                         <int>0x200a</int>       <!-- HAIR SPACE -->
274                         <int>0x200b</int>       <!-- ZERO WIDTH SPACE -->
275                         <int>0x200c</int>       <!-- ZERO WIDTH NON-JOINER -->
276                         <int>0x200d</int>       <!-- ZERO WIDTH JOINER -->
277                         <int>0x200e</int>       <!-- LEFT-TO-RIGHT MARK -->
278                         <int>0x200f</int>       <!-- RIGHT-TO-LEFT MARK -->
279                         <int>0x2028</int>       <!-- LINE SEPARATOR -->
280                         <int>0x2029</int>       <!-- PARAGRAPH SEPARATOR -->
281                         <int>0x202a</int>       <!-- LEFT-TO-RIGHT EMBEDDING -->
282                         <int>0x202b</int>       <!-- RIGHT-TO-LEFT EMBEDDING -->
283                         <int>0x202c</int>       <!-- POP DIRECTIONAL FORMATTING -->
284                         <int>0x202d</int>       <!-- LEFT-TO-RIGHT OVERRIDE -->
285                         <int>0x202e</int>       <!-- RIGHT-TO-LEFT OVERRIDE -->
286                         <int>0x202f</int>       <!-- NARROW NO-BREAK SPACE -->
287                         <int>0x205f</int>       <!-- MEDIUM MATHEMATICAL SPACE -->
288                         <int>0x2060</int>       <!-- WORD JOINER -->
289                         <int>0x2061</int>       <!-- FUNCTION APPLICATION -->
290                         <int>0x2062</int>       <!-- INVISIBLE TIMES -->
291                         <int>0x2063</int>       <!-- INVISIBLE SEPARATOR -->
292                         <int>0x206A</int>       <!-- INHIBIT SYMMETRIC SWAPPING -->
293                         <int>0x206B</int>       <!-- ACTIVATE SYMMETRIC SWAPPING -->
294                         <int>0x206C</int>       <!-- INHIBIT ARABIC FORM SHAPING -->
295                         <int>0x206D</int>       <!-- ACTIVATE ARABIC FORM SHAPING -->
296                         <int>0x206E</int>       <!-- NATIONAL DIGIT SHAPES -->
297                         <int>0x206F</int>       <!-- NOMINAL DIGIT SHAPES -->
298                         <int>0x3000</int>       <!-- IDEOGRAPHIC SPACE -->
299                         <int>0x3164</int>       <!-- HANGUL FILLER -->
300                         <int>0xfeff</int>       <!-- ZERO WIDTH NO-BREAK SPACE -->
301                         <int>0xffa0</int>       <!-- HALFWIDTH HANGUL FILLER -->
302                         <int>0xfff9</int>       <!-- INTERLINEAR ANNOTATION ANCHOR -->
303                         <int>0xfffa</int>       <!-- INTERLINEAR ANNOTATION SEPARATOR -->
304                         <int>0xfffb</int>       <!-- INTERLINEAR ANNOTATION TERMINATOR -->
305                 </blank>
306 <!--
307   Rescan configuration every 30 seconds when FcFontSetList is called
308  -->
309                 <rescan>
310                         <int>30</int>
311                 </rescan>
312         </config>
313
314 </fontconfig>