summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPhilipp Gesang <phg42.2a@gmail.com>2013-11-05 16:12:43 +0100
committerPhilipp Gesang <phg42.2a@gmail.com>2013-11-05 16:12:43 +0100
commit0228ec5a8a6d969c94cc2f5b7befd0cdb17a3c63 (patch)
tree2ea61476608e6c02286c0e6f1953ae338729d424
parentbf255ef48e5b7710008141e4935183d8ca9a42aa (diff)
downloadluaotfload-0228ec5a8a6d969c94cc2f5b7befd0cdb17a3c63.tar.gz
[man] expand paragraph about --list
-rw-r--r--luaotfload-tool.rst29
1 files changed, 27 insertions, 2 deletions
diff --git a/luaotfload-tool.rst b/luaotfload-tool.rst
index d123e04..6971163 100644
--- a/luaotfload-tool.rst
+++ b/luaotfload-tool.rst
@@ -120,12 +120,37 @@ query mode
1) the character ``*``, selecting all entries;
2) a field of a database entry, for instance
- *fullname* or *units_per_em*, according to
- which the output will be sorted; or
+ *version* or *format**, according to which
+ the output will be sorted; or
+ Subfields of a record can be addressed using
+ the ``->`` separator, e. g.
+ ``file->location``, ``style->units_per_em``,
+ or
+ ``names->sanitized->english->prefmodifiers``.
+ NB: shell syntax requires that arguments
+ containing ``->`` be properly quoted!
3) an expression of the form ``field:value`` to
limit the output to entries whose ``field``
matches ``value``.
+ For example, in order to output file names and
+ corresponding versions, sorted by the font
+ format::
+
+ ./luaotfload-tool.lua --list="format" --fields="file->base,version"
+
+ This prints::
+
+ otf latinmodern-math.otf Version 1.958
+ otf lmromancaps10-oblique.otf 2.004
+ otf lmmono8-regular.otf 2.004
+ otf lmmonoproplt10-bold.otf 2.004
+ otf lmsans10-oblique.otf 2.004
+ otf lmromanslant8-regular.otf 2.004
+ otf lmroman12-italic.otf 2.004
+ otf lmsansdemicond10-oblique.otf 2.004
+ ...
+
--fields=FIELDS Comma-separated list of fields that should be
printed.
Subfields of a record can be addressed using