From 992b0150c8182c10cd3415d696bf66c10a381dd7 Mon Sep 17 00:00:00 2001 From: Philipp Gesang Date: Sun, 13 Jul 2014 12:19:47 +0200 Subject: [doc] extend documentation of config options in manpage --- doc/luaotfload.conf.rst | 18 ++++++++++++++++-- 1 file changed, 16 insertions(+), 2 deletions(-) (limited to 'doc/luaotfload.conf.rst') 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 ======================================================================= -- cgit v1.2.3