Adding information about the font cache file.

git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@1066543 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/src/documentation/content/xdocs/trunk/fonts.xml b/src/documentation/content/xdocs/trunk/fonts.xml
index dcd03e548d5454f725c0c7e0e7490bb33e856585..57b9b98f9da67c3e6f48a54ab5d251e6877dd321 100644 (file)
--- a/src/documentation/content/xdocs/trunk/fonts.xml
+++ b/src/documentation/content/xdocs/trunk/fonts.xml
@@ -426,6 +426,21 @@
           Name: font/myfont.ttf
           Content-Type: application/x-font</source>
         <p>This feature allows you to create JAR files containing fonts. The JAR files can be added to fop by providem them in the classpath, e.g. copying them into the lib/ directory.</p>
+        <section id="font-cache">
+          <title>The font cache</title>
+          <p>
+            Apache FOP maintains a cache file that is used to speed up auto-detection. This file
+            is usually found in the ".fop" directory under the user's home directory. It's called
+            "fop-fonts.cache". When the user's home directory is not writable, the font cache file
+            is put in the directory for temporary files.
+          </p>
+          <p>
+            If there was a problem loading a particular font, it is flagged in the cache file so
+            it is not loaded anymore. So, if a font is actually around but is still not found
+            by Apache FOP, it's worth a try to delete the font cache file which forces Apache FOP
+            to reparse all fonts.
+          </p>
+        </section>
       </section>
       <section id="embedding">
         <title>Embedding</title>