diff options
| author | Philipp Gesang <phg@phi-gamma.net> | 2016-04-28 22:10:15 +0200 |
|---|---|---|
| committer | Philipp Gesang <phg@phi-gamma.net> | 2016-04-28 22:15:27 +0200 |
| commit | 44973c92caed597ede12de0367947037523d3e65 (patch) | |
| tree | 60be10f80f85eab5d11b4042ee786396fc16bf95 /doc/luaotfload.conf.rst | |
| parent | 2db9e17e57e306bde452c5d97f976b47b0bf9d78 (diff) | |
| download | luaotfload-44973c92caed597ede12de0367947037523d3e65.tar.gz | |
[doc] document new “anon-sequence” option
Diffstat (limited to 'doc/luaotfload.conf.rst')
| -rw-r--r-- | doc/luaotfload.conf.rst | 17 |
1 files changed, 16 insertions, 1 deletions
diff --git a/doc/luaotfload.conf.rst b/doc/luaotfload.conf.rst index e7cbccb..3568909 100644 --- a/doc/luaotfload.conf.rst +++ b/doc/luaotfload.conf.rst @@ -6,7 +6,7 @@ Luaotfload configuration file ----------------------------------------------------------------------- -:Date: 2016-04-21 +:Date: 2016-04-28 :Copyright: GPL v2.0 :Version: 2.7 :Manual section: 5 @@ -271,6 +271,8 @@ Section ``run`` +------------------+--------+------------------------------+ | variable | type | default | +------------------+--------+------------------------------+ +| anon-sequence | s | ``"tex,path,name"`` | ++------------------+--------+------------------------------+ | color-callback | s | ``"post_linebreak_filter"`` | +------------------+--------+------------------------------+ | definer | s | ``"patch"`` | @@ -282,6 +284,19 @@ Section ``run`` | fontloader | s | ``"default"`` | +------------------+--------+------------------------------+ +Unqualified font lookups are treated with the flexible “anonymous” +mechanism. This involves a chain of lookups applied successively until +the first one yields a match. By default, the lookup will first search +for TFM fonts using the Kpathsea library. If this wasn’t successful, an +attempt is made at interpreting the request as an absolute path (like +the ``[/path/to/font/foo.ttf]`` syntax) or a file name +(``file:foo.ttf``). Finally, the request is interpreted as a font name +and retrieved from the index (``name:Foo Regular``). This behavior can +be configured by specifying a list as the value to ``anon-sequence``. +Available items are ``tex``, ``path``, ``name`` -- representing the +lookups described above, respectively --, and ``file`` for searching a +filename but not an absolute path. + The ``color-callback`` option determines the stage at which fonts that defined with a ``color=xxyyzz`` feature will be colorized. By default this happens in a ``post_linebreak_filter`` but alternatively the |