summaryrefslogtreecommitdiff
path: root/doc/fontconfig-user.sgml
diff options
context:
space:
mode:
authorNicolas Mailhot <nim@fedoraproject.org>2020-03-28 15:01:35 +0100
committerNicolas Mailhot <nim@fedoraproject.org>2020-03-28 15:01:35 +0100
commit9c46ef4aac87c42d013d0e7380b6aeb03e1a9949 (patch)
treee6753a73b1370507703916f07cd283869a3ef553 /doc/fontconfig-user.sgml
parent6f6b39780215714386606ca1c5457a7106639ff4 (diff)
downloadfontconfig-9c46ef4aac87c42d013d0e7380b6aeb03e1a9949.tar.gz
Use an URN for DTD ID
XML tools interpret “fonts.dtd” as a relative path. Unfortunately, that can not work now that the configuration is spread over multiple system-dependant directories, without a common relative path to this file. And, an absolute path can not be defined in a system-independant way. System independance is a requirement to share config files between systems. Therefore, replace the broken relative path by a formal URN, that will work the same way on all systems, without network access. This makes the DTD registerable with commands like: $ xmlcatalog --noout --add system \ "urn:fontconfig:fonts.dtd" \ "file:///usr/share/xml/fontconfig/fonts.dtd" \ /etc/xml/catalog That enables easy config file checking: $ xmllint --loaddtd ${config_file} >/dev/null
Diffstat (limited to 'doc/fontconfig-user.sgml')
-rw-r--r--doc/fontconfig-user.sgml6
1 files changed, 3 insertions, 3 deletions
diff --git a/doc/fontconfig-user.sgml b/doc/fontconfig-user.sgml
index 59431dd..c4e8312 100644
--- a/doc/fontconfig-user.sgml
+++ b/doc/fontconfig-user.sgml
@@ -301,7 +301,7 @@ directory (&confdir;). Each configuration file should contain the
following structure:
<programlisting>
&lt;?xml version="1.0"?&gt;
- &lt;!DOCTYPE fontconfig SYSTEM "fonts.dtd"&gt;
+ &lt;!DOCTYPE fontconfig SYSTEM "urn:fontconfig:fonts.dtd"&gt;
&lt;fontconfig&gt;
...
&lt;/fontconfig&gt;
@@ -591,7 +591,7 @@ This is an example of a system-wide configuration file
</para>
<programlisting>
&lt;?xml version="1.0"?&gt;
-&lt;!DOCTYPE fontconfig SYSTEM "fonts.dtd"&gt;
+&lt;!DOCTYPE fontconfig SYSTEM "urn:fontconfig:fonts.dtd"&gt;
&lt;!-- &confdir;/fonts.conf file to configure system font access --&gt;
&lt;fontconfig&gt;
&lt;!--
@@ -702,7 +702,7 @@ $XDG_CONFIG_HOME/fontconfig/fonts.conf
</para>
<programlisting>
&lt;?xml version="1.0"?&gt;
-&lt;!DOCTYPE fontconfig SYSTEM "fonts.dtd"&gt;
+&lt;!DOCTYPE fontconfig SYSTEM "urn:fontconfig:fonts.dtd"&gt;
&lt;!-- $XDG_CONFIG_HOME/fontconfig/fonts.conf for per-user font configuration --&gt;
&lt;fontconfig&gt;