 <!-- manual page source format generated by PolyglotMan v3.2, -->
<!-- available at http://polyglotman.sourceforge.net/ -->

<html>
<head>
<title>"FC-CACHE"("1") manual page</title>
</head>
<body bgcolor='white'>
<a href='#toc'>Table of Contents</a><p>

<h2><a name='sect0' href='#toc0'>Name</a></h2>
fc-cache - build font information cache files 
<h2><a name='sect1' href='#toc1'>Synopsis</a></h2>
<p>
<b>fc-cache</b> [ <b>-EfrsvVh</b>
]  [ <b>--error-on-no-fonts</b> ]  [ <b>--force</b> ]  [ <b>--really-force</b> ]  [ <b> [ -y <i>dir<b> ]  [ --sysroot
<i>dir<b> ] </b></i></b></i></b> ]  [ <b>--system-only</b> ]  [ <b>--verbose</b> ]  [ <b>--version</b> ]  [ <b>--help</b> ]  [ <b><i>dir<b></b></i></b><i>...</i> ] 

<h2><a name='sect2' href='#toc2'>Description</a></h2>
<p>
<b>fc-cache</b> scans the font directories on the system and builds
font information cache files for applications using fontconfig for their
font handling. <p>
If directory arguments are not given, <b>fc-cache</b> uses each directory
in the current font configuration. Each directory is scanned for font files
readable by FreeType. A cache is created which contains properties of each
font and the associated filename. This cache is used to speed up application
startup when using the fontconfig library. <p>
Note that <b>fc-cache</b> must be executed
once per architecture to generate font information customized for that
architecture. 
<h2><a name='sect3' href='#toc3'>Options</a></h2>
<p>
This program follows the usual GNU command line syntax,
with long options starting with two dashes (&lsquo;-&rsquo;). A summary of options is included
below. 
<dl>

<dt><b>-E</b> </dt>
<dd>Raise an error if there are no fonts in <b><i>dir<b></b></i></b> or directories in the
configuration if not given. </dd>

<dt><b>-f</b> </dt>
<dd>Force re-generation of apparently up-to-date
cache files, overriding the timestamp checking. </dd>

<dt><b>-r</b> </dt>
<dd>Erase all existing cache
files and rescan. </dd>

<dt><b>-s</b> </dt>
<dd>Only scan system-wide directories, omitting the places
located in the user&rsquo;s home directory. </dd>

<dt><b>-v</b> </dt>
<dd>Display status information while
busy. </dd>

<dt><b>-y</b> </dt>
<dd>Prepend <b><i>dir<b></b></i></b> to all paths for scanning. </dd>

<dt><b>-h</b> </dt>
<dd>Show summary of options.
</dd>

<dt><b>-V</b> </dt>
<dd>Show version of the program and exit. </dd>

<dt><b><i>dir<b></b></i></b> </dt>
<dd>Directory to scan for fonts.
</dd>
</dl>

<h2><a name='sect4' href='#toc4'>Return Codes</a></h2>
<p>
<b>fc-cache</b> returns zero if the caches successfully generated. otherwise
non-zero. 
<h2><a name='sect5' href='#toc5'>Files</a></h2>

<dl>

<dt><b><i>%cachedir%/*-%arch%.cache-%version%<b></b></i></b> </dt>
<dd>These files are generated
by <b>fc-cache</b> and contain maps from file names to font properties. They are
read by the fontconfig library at application startup to locate appropriate
fonts. </dd>
</dl>

<h2><a name='sect6' href='#toc6'>See Also</a></h2>
<p>
<a href='fc-cat.1'><b>fc-cat</b>(1)</a>
 <a href='fc-list.1'><b>fc-list</b>(1)</a>
 <a href='fc-match.1'><b>fc-match</b>(1)</a>
 <a href='fc-pattern.1'><b>fc-pattern</b>(1)</a>
 <a href='fc-query.1'><b>fc-query</b>(1)</a>
 <a href='fc-scan.1'><b>fc-scan</b>(1)</a>

<p>
The fontconfig user&rsquo;s guide, in HTML format: <i>/usr/share/doc/fontconfig/fontconfig-user.html</i>.

<h2><a name='sect7' href='#toc7'>Author</a></h2>
<p>
This manual page was written by Keith Packard &lt;keithp@keithp.com&gt; and
Josselin Mouette &lt;joss@debian.org&gt;. <p>

<hr><p>
<a name='toc'><b>Table of Contents</b></a><p>
<ul>
<li><a name='toc0' href='#sect0'>Name</a></li>
<li><a name='toc1' href='#sect1'>Synopsis</a></li>
<li><a name='toc2' href='#sect2'>Description</a></li>
<li><a name='toc3' href='#sect3'>Options</a></li>
<li><a name='toc4' href='#sect4'>Return Codes</a></li>
<li><a name='toc5' href='#sect5'>Files</a></li>
<li><a name='toc6' href='#sect6'>See Also</a></li>
<li><a name='toc7' href='#sect7'>Author</a></li>
</ul>
</body>
</html>
