Bug 18726 - RFE: help write locale-specific tests

Add an example matching rule for the language specific

diff --git a/doc/fontconfig-user.sgml b/doc/fontconfig-user.sgml
index 92d0db8..f7632ea 100644 (file)
--- a/doc/fontconfig-user.sgml
+++ b/doc/fontconfig-user.sgml
@@ -677,6 +677,41 @@ $XDG_CONFIG_HOME/fontconfig/fonts.conf
 <match target="font">
        <edit name="rgba" mode="assign"><const>rgb</const></edit>
 </match>
+<!--
+       use WenQuanYi Zen Hei font when serif is requested for Chinese
+-->
+<match>
+       <!--
+               If you don't want to use WenQuanYi Zen Hei font for zh-tw etc,
+               you can use zh-cn instead of zh.
+               Please note, even if you set zh-cn, it still matches zh.
+               if you don't like it, you can use compare="eq"
+               instead of compare="contains".
+       -->
+       <test name="lang" compare="contains">
+               <string>zh</string>
+       </test>
+       <test name="family">
+               <string>serif</string>
+       </test>
+       <edit name="family" mode="prepend">
+               <string>WenQuanYi Zen Hei</string>
+       </edit>
+</match>
+<!--
+       use VL Gothic font when sans-serif is requested for Japanese
+-->
+<match>
+       <test name="lang" compare="contains">
+               <string>ja</string>
+       </test>
+       <test name="family">
+               <string>sans-serif</string>
+       </test>
+       <edit name="family" mode="prepend">
+               <string>VL Gothic</string>
+       </edit>
+</match>
 </fontconfig>
     </programlisting>
   </refsect2>