summaryrefslogtreecommitdiff
path: root/doc/luaotfload.conf.rst
diff options
context:
space:
mode:
authorPhilipp Gesang <phg42.2a@gmail.com>2014-07-13 12:19:47 +0200
committerPhilipp Gesang <phg42.2a@gmail.com>2014-07-13 12:19:47 +0200
commit992b0150c8182c10cd3415d696bf66c10a381dd7 (patch)
tree2e65dabeb05fc69679fd8a660de73a6ae6ab3ca4 /doc/luaotfload.conf.rst
parent441f07d9a08ac3e9654a7ff5daf1bdb426072616 (diff)
downloadluaotfload-992b0150c8182c10cd3415d696bf66c10a381dd7.tar.gz
[doc] extend documentation of config options in manpage
Diffstat (limited to 'doc/luaotfload.conf.rst')
-rw-r--r--doc/luaotfload.conf.rst18
1 files changed, 16 insertions, 2 deletions
diff --git a/doc/luaotfload.conf.rst b/doc/luaotfload.conf.rst
index 9c8153a..f25fc88 100644
--- a/doc/luaotfload.conf.rst
+++ b/doc/luaotfload.conf.rst
@@ -29,7 +29,7 @@ The file ``luaotfload.conf`` contains configuration options for
EXAMPLE
=======================================================================
-* TODO, small example snippet
+
SYNTAX
@@ -208,13 +208,27 @@ this happens in a ``pre_linebreak_filter`` but alternatively the
inconsistent output. The latter also was the default in the 1.x series
of Luaotfload.
-The value of ``log_level`` set the default verbosity of messages
+The ``definer`` allows for switching the ``define_font`` callback.
+Apart from the default ``patch`` one may also choose the ``generic``
+one that comes with the vanilla fontloader. Beware that this might
+break tools like Fontspect that rely on the ``patch_font`` callback
+provided by Luaotfload to perform important corrections on font data.
+
+The value of ``log_level`` sets the default verbosity of messages
printed by Luaotfload. Only messages defined with a verbosity of less
than or equal to the supplied value will be output on the terminal.
At a log level of five Luaotfload can be very noisy. Also, printing too
many messages will slow down the interpreter due to line buffering
being disabled (see **setbuf**\(3)).
+The ``resolver`` setting allows choosing the font name resolution
+function: With the default value ``cached`` Luaotfload saves the result
+of a successful font name request to a cache file to speed up
+subsequent lookups. The alternative, ``normal`` circumvents the cache
+and resolves every request individually. (Since to the restructuring of
+the font name index in Luaotfload 2.4 the performance difference
+between the cached and uncached lookups should be marginal.)
+
FILES
=======================================================================