-<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
+<!ENTITY version SYSTEM "version.sgml">
+<!ENTITY confdir SYSTEM "confdir.sgml">
+]>
<!--
$Id$
-->
<refentry>
<refmeta>
- <refentrytitle>fonts.conf</refentrytitle>
+ <refentrytitle>fonts-conf</refentrytitle>
<manvolnum>5</manvolnum>
</refmeta>
<refnamediv>
</refnamediv>
<refsynopsisdiv>
<synopsis>
- /etc/fonts/fonts.conf
- /etc/fonts/fonts.dtd
+ &confdir;/fonts.conf
+ &confdir;/fonts.dtd
~/.fonts.conf
</synopsis>
</refsynopsisdiv>
-<refsect1><title>DESCRIPTION</title>
+<refsect1><title>Description</title>
<para>
Fontconfig is a library designed to provide system-wide font configuration,
customization and application access.
</para>
</refsect1>
-<refsect1><title>FUNCTIONAL OVERVIEW</title>
+<refsect1><title>Functional Overview</title>
<para>
Fontconfig contains two essential modules, the configuration module which
builds an internal configuration from XML files and the matching module
which accepts font patterns and returns the nearest matching font.
</para>
- <refsect2><title>FONT CONFIGURATION</title>
+ <refsect2><title>Font Configuration</title>
<para>
The configuration module consists of the FcConfig datatype, libexpat and
FcConfigParse which walks over an XML tree and ammends a configuration with
</para>
</refsect2>
<refsect2>
- <title>FONT PROPERTIES</title>
+ <title>Font Properties</title>
<para>
While font patterns may contain essentially any properties, there are some
well known properties with associated types. Fontconfig uses some of these
</programlisting>
</refsect2>
<refsect2>
- <title>FONT MATCHING</title>
+ <title>Font Matching</title>
<para>
Fontconfig performs matching by measuring the distance from a provided
pattern to all of the available fonts in the system. The closest matching
as false matches will often occur.
</para>
</refsect2>
- <refsect2><title>FONT NAMES</title>
+ <refsect2><title>Font Names</title>
<para>
Fontconfig provides a textual representation for patterns that the library
can both accept and generate. The representation is in three parts, first a
</programlisting>
</refsect2>
</refsect1>
-<refsect1><title>LANG TAGS</title>
+<refsect1><title>Lang Tags</title>
<para>
Each font in the database contains a list of languages it supports. This is
computed by comparing the Unicode coverage of the font with the orthography
languages with only three-letter codes.
</para>
</refsect1>
-<refsect1><title>CONFIGURATION FILE FORMAT</title>
+<refsect1><title>Configuration File Format</title>
<para>
Configuration files for fontconfig are stored in XML format; this
format makes external configuration tools easier to write and ensures that
</para><para>
The fontconfig document type definition resides in the external entity
"fonts.dtd"; this is normally stored in the default font configuration
-directory (/etc/fonts). Each configuration file should contain the
+directory (&confdir;). Each configuration file should contain the
following structure:
<programlisting>
<?xml version="1.0"?>
</programlisting>
</para></refsect2>
<refsect2><title><sgmltag>int</>, <sgmltag>double</>, <sgmltag>string</>, <sgmltag>bool</></title><para>
-These elements hold a single value of the indicated type. <sgmltag>bool</> elements
-hold either true or false.
+These elements hold a single value of the indicated type. <sgmltag>bool</>
+elements hold either true or false. An important limitation exists in
+the parsing of floating point numbers -- fontconfig requires that
+the mantissa start with a digit, not a decimal point, so insert a leading
+zero for purely fractional values (e.g. use 0.5 instead of .5 and -0.5
+instead of -.5).
</para></refsect2>
<refsect2><title><sgmltag>matrix</></title><para>
This element holds the four <sgmltag>double</> elements of an affine
<programlisting>
<?xml version="1.0"?>
<!DOCTYPE fontconfig SYSTEM "fonts.dtd">
-<!-- /etc/fonts/fonts.conf file to configure system font access -->
+<!-- &confdir;/fonts.conf file to configure system font access -->
<fontconfig>
<!--
Find fonts in these directories
</programlisting>
</refsect2>
</refsect1>
-<refsect1><title>FILES</title>
+<refsect1><title>Files</title>
<para>
<emphasis>fonts.conf</emphasis>
contains configuration information for the fontconfig library
per-directory caches. This file is automatically maintained by fontconfig.
</para>
</refsect1>
+<refsect1><title>Version</title>
+ <para>
+Fontconfig version &version;
+ </para>
+</refsect1>
</refentry>