summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPhilipp Gesang <phg42.2a@gmail.com>2014-07-13 15:15:46 +0200
committerPhilipp Gesang <phg42.2a@gmail.com>2014-07-13 15:15:46 +0200
commitf66b2ffe8fdc30e517d00b4796c142acd0e4438d (patch)
tree214aea2e1231b770d3555aaad7a4f5cf9af2048f
parentd84ce4ec794e634b853ca88925e1d20f6a1287e3 (diff)
downloadluaotfload-f66b2ffe8fdc30e517d00b4796c142acd0e4438d.tar.gz
[doc] describe feature settings and config file syntax in manpage
-rw-r--r--doc/luaotfload.conf.rst44
1 files changed, 43 insertions, 1 deletions
diff --git a/doc/luaotfload.conf.rst b/doc/luaotfload.conf.rst
index 9940be2..774095b 100644
--- a/doc/luaotfload.conf.rst
+++ b/doc/luaotfload.conf.rst
@@ -61,7 +61,29 @@ To observe the difference in behavior, save above snippet to
SYNTAX
=======================================================================
-* TODO, short intro to ``.ini`` file syntax
+The configuration file syntax follows the common INI format. For a more
+detailed description please refer to the section “CONFIGURATION FILE”
+of **git-config**\(1). A brief list of rules is given below:
+
+ * Blank lines and lines starting with a semicolon (``;``) are ignored.
+
+ * A configuration file is partitioned into sections that are declared
+ by specifying the section title in brackets on a separate line: ::
+
+ [some-section]
+ ... section content ...
+
+ * Sections consist of one or more variable assignments of the form
+ ``variable-name = value`` E. g.::
+
+ [foo]
+ bar = baz
+ quux = xyzzy
+ ...
+
+ * Section and variable names may contain only uppercase and lowercase
+ letters as well as dashes (``-``).
+
VARIABLES
=======================================================================
@@ -160,6 +182,26 @@ cannot find a requested font. Those who prefer to update manually using
**luaotfload-tool** should unset this flag.
+Section ``default-features``
+-----------------------------------------------------------------------
+
+By default Luaotfload enables ``node`` mode and picks the default font
+features that are prescribed in the OpenType standard. This behavior
+may be overridden in the ``default-features`` section. Global defaults
+that will be applied for all scripts can be set via the ``global``
+option, others by the script they are to be applied to. For example,
+a setting of ::
+
+ [default-features]
+ global = mode=base,color=0000FF
+ dflt = smcp,onum
+
+would force *base* mode, tint all fonts blue and activate small
+capitals and text figures globally. Features are specified as a comma
+separated list of variables or variable-value pairs. Variables without
+an explicit value are set to ``true``.
+
+
Section ``misc``
-----------------------------------------------------------------------