diff options
author | Philipp Gesang <phg42.2a@gmail.com> | 2013-11-05 16:12:43 +0100 |
---|---|---|
committer | Philipp Gesang <phg42.2a@gmail.com> | 2013-11-05 16:12:43 +0100 |
commit | 0228ec5a8a6d969c94cc2f5b7befd0cdb17a3c63 (patch) | |
tree | 2ea61476608e6c02286c0e6f1953ae338729d424 | |
parent | bf255ef48e5b7710008141e4935183d8ca9a42aa (diff) | |
download | luaotfload-0228ec5a8a6d969c94cc2f5b7befd0cdb17a3c63.tar.gz |
[man] expand paragraph about --list
-rw-r--r-- | luaotfload-tool.rst | 29 |
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 |