Add doc for description element and update fonts.dtd

Fixes https://gitlab.freedesktop.org/fontconfig/fontconfig/issues/133
This commit is contained in:
Akira TAGOH 2018-11-15 20:55:08 +09:00
parent 13b4ba9135
commit 2bd559f75d
2 changed files with 21 additions and 5 deletions

View File

@ -339,6 +339,11 @@ the library. If 'prefix' is set to "xdg", the value in the XDG_CONFIG_HOME envi
This element provides a place to consolidate additional configuration
information. <literal>&lt;config&gt;</literal> can contain <literal>&lt;blank&gt;</literal> and <literal>&lt;rescan&gt;</literal> elements in any
order.
</para></refsect2>
<refsect2><title><literal>&lt;description domain="fontconfig-conf"&gt;</literal></title><para>
This element is supposed to hold strings which describe what a config is used for.
This string can be translated through gettext. 'domain' needs to be set the proper name to apply then.
fontconfig will tries to retrieve translations with 'domain' from gettext.
</para></refsect2>
<refsect2><title><literal>&lt;blank&gt;</literal></title><para>
Fonts often include "broken" glyphs which appear in the encoding but are

View File

@ -1,12 +1,13 @@
<!-- This is the Document Type Definition for font configuration files -->
<!ELEMENT fontconfig (dir |
<!ELEMENT fontconfig (alias |
cache |
cachedir |
include |
config |
selectfont |
match |
alias)* >
description |
dir |
include |
match |
selectfont)* >
<!--
Add a directory that provides fonts
@ -43,6 +44,16 @@
prefix CDATA "default"
xml:space (default|preserve) 'preserve'>
<!--
Set a string as a description for the targeted config file
Set 'domain' to change where to pull translations from.
This will be done through gettext.
-->
<!ELEMENT description (#PCDATA)>
<!ATTLIST description
domain CDATA "fontconfig-conf">
<!--
Reference another configuration file; note that this
is another complete font configuration file and not