Update doc for salt

This commit is contained in:
Akira TAGOH 2019-02-01 06:41:38 +00:00
parent 2e8ce63514
commit 4ff52ffb52
1 changed files with 9 additions and 3 deletions

View File

@ -310,9 +310,13 @@ following structure:
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 @@ Unicode characters which is supposed to be blank in an <literal>&lt;int&gt;</lit
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.