commit 4ff52ffb52dc9eb9b12aee21c4b897206c28d457
author Akira TAGOH <akira@tagoh.org> Fri Feb 01 06:41:38 2019 +0000
committer Akira TAGOH <akira@tagoh.org> Wed Apr 03 12:02:09 2019 +0000
tree 1194bfabf43df262b76632427255cf399da7fb23
parent 2e8ce63514b06590d36d9bf5c332ff83fb72791a

Update doc for salt

doc/fontconfig-user.sgml

diff --git a/doc/fontconfig-user.sgml b/doc/fontconfig-user.sgml
index f30b4f0..cfe173f 100644
--- a/doc/fontconfig-user.sgml
+++ b/doc/fontconfig-user.sgml
@@ -310,9 +310,13 @@
 This is the top level element for a font configuration and can contain
 <literal>&lt;dir&gt;</literal>, <literal>&lt;cachedir&gt;</literal>, <literal>&lt;include&gt;</literal>, <literal>&lt;match&gt;</literal> and <literal>&lt;alias&gt;</literal> elements in any order.
   </para></refsect2>
-  <refsect2><title><literal>&lt;dir prefix="default"&gt;</literal></title><para>
+  <refsect2><title><literal>&lt;dir prefix="default" salt=""&gt;</literal></title><para>
 This element contains a directory name which will be scanned for font files
-to include in the set of available fonts. If 'prefix' is set to "default" or "cwd", the current working directory will be added as the path prefix prior to the value. If 'prefix' is set to "xdg", the value in the XDG_DATA_HOME environment variable will be added as the path prefix. please see XDG Base Directory Specification for more details. If 'prefix' is set to "relative", the path of current file will be added prior to the value.
+to include in the set of available fonts.
+  </para><para>
+If 'prefix' is set to "default" or "cwd", the current working directory will be added as the path prefix prior to the value. If 'prefix' is set to "xdg", the value in the XDG_DATA_HOME environment variable will be added as the path prefix. please see XDG Base Directory Specification for more details. If 'prefix' is set to "relative", the path of current file will be added prior to the value.
+  </para><para>
+'salt' property affects to determine cache filename. this is useful for example when having different fonts sets on same path at container and share fonts from host on different font path.
   </para></refsect2>
   <refsect2><title><literal>&lt;cachedir prefix="default"&gt;</literal></title><para>
 This element contains a directory name that is supposed to be stored or read
@@ -352,12 +356,14 @@
 Characters outside of this set which are drawn as blank will be elided from
 the set of characters supported by the font.
   </para></refsect2>
-  <refsect2><title><literal>&lt;remap-dir prefix="default" as-path=""&lt;</literal></title><para>
+  <refsect2><title><literal>&lt;remap-dir prefix="default" as-path="" salt=""&lt;</literal></title><para>
 This element contains a directory name where will be mapped
 as the path 'as-path' in cached information.
 This is useful if the directory name is an alias
 (via a bind mount or symlink) to another directory in the system for
 which cached font information is likely to exist.
+  </para><para>
+'salt' property affects to determine cache filename as same as <literal>&lt;dir&gt;</literal> element.
   </para></refsect2>
   <refsect2><title><literal>&lt;reset-dirs /&gt;</literal></title><para>
 This element removes all of fonts directories where added by <literal>&lt;dir&gt;</literal> elements.