From 0228ec5a8a6d969c94cc2f5b7befd0cdb17a3c63 Mon Sep 17 00:00:00 2001 From: Philipp Gesang Date: Tue, 5 Nov 2013 16:12:43 +0100 Subject: [man] expand paragraph about --list --- luaotfload-tool.rst | 29 +++++++++++++++++++++++++++-- 1 file 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 -- cgit v1.2.3