summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorPhilipp Gesang <phg42.2a@gmail.com>2014-07-13 13:02:17 +0200
committerPhilipp Gesang <phg42.2a@gmail.com>2014-07-13 13:02:17 +0200
commit18aceb2612c0352535aa07ca9628d9cbc5285c19 (patch)
treed55850326fe048e264e2f5e48e3ec1cf30dd0ea2 /doc
parent42554adf7de06013127c9a2d63431456c82f447f (diff)
downloadluaotfload-18aceb2612c0352535aa07ca9628d9cbc5285c19.tar.gz
[doc] add short example file to configuration man page
Diffstat (limited to 'doc')
-rw-r--r--doc/luaotfload.conf.rst28
1 files changed, 27 insertions, 1 deletions
diff --git a/doc/luaotfload.conf.rst b/doc/luaotfload.conf.rst
index 762f412..561ca97 100644
--- a/doc/luaotfload.conf.rst
+++ b/doc/luaotfload.conf.rst
@@ -29,7 +29,33 @@ The file ``luaotfload.conf`` contains configuration options for
EXAMPLE
=======================================================================
-
+A small Luaotfload configuration file with few customizations could
+look as follows: ::
+
+ [db]
+ formats = afm, pfa, pfb
+ compress = false
+
+ [misc]
+ termwidth = 60
+
+ [run]
+ log-level = 6
+
+This will make Luaotfload ignore all font files except for PostScript
+formats. NB: With a default Tex Live install the PS fonts will take
+much longer to index than OpenType or TrueType ones. Also, an
+uncompressed index file will be dumped which is going to be much larger
+due to the huge amount of PostScript fonts indexed. The terminal width
+is truncated to 60 characters which influences the verbose output
+during indexing. Finally, the verbosity is increased greatly: each font
+file being processed will be printed to the stdout on a separate line,
+along with lots of other information.
+
+To observe the difference in behavior, save above snippet to
+``./luaotfload.conf`` and update the font index: ::
+
+ luaotfload --update --force
SYNTAX