summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rwxr-xr-xluaotfload-tool.lua9
-rw-r--r--luaotfload-tool.rst23
2 files changed, 27 insertions, 5 deletions
diff --git a/luaotfload-tool.lua b/luaotfload-tool.lua
index 3e10820..8d7f6f5 100755
--- a/luaotfload-tool.lua
+++ b/luaotfload-tool.lua
@@ -129,11 +129,14 @@ This tool is part of the luaotfload package. Valid options are:
-v --verbose=LEVEL be more verbose (print the searched directories)
-vv print the loaded fonts
-vvv print all steps of directory searching
+ --log=stdout redirect log output to stdout
+
-V --version print version and exit
-h --help print this message
--alias=<name> force behavior of “luaotfload-tool” or legacy
“mkluatexfontdb”
+
-------------------------------------------------------------------------------
DATABASE
@@ -147,7 +150,9 @@ This tool is part of the luaotfload package. Valid options are:
(default: n = 1)
-i --info display font metadata
- --log=stdout redirect log output to stdout
+ --list=<criterion> output list of entries by field <criterion>
+ --list=<criterion>:<value> restrict to entries with <criterion>=<value>
+ --fields=<f1>,<f2>,…,<fn> which fields <f> to print with --list
The font database will be saved to
%s
@@ -158,7 +163,7 @@ The font database will be saved to
Usage: %s [OPTION]...
-Rebuild the LuaTeX font database.
+Rebuild or update the LuaTeX font database.
Valid options:
-f --force force re-indexing all fonts
diff --git a/luaotfload-tool.rst b/luaotfload-tool.rst
index cd42606..5b6c6b8 100644
--- a/luaotfload-tool.rst
+++ b/luaotfload-tool.rst
@@ -23,6 +23,8 @@ SYNOPSIS
**luaotfload** --flush-cache
+**luaotfload** --list=CRITERION[:VALUE] [ --fields=F1,F2,...,Fn ]
+
**luaotfload** --help
**luaotfload** --version
@@ -54,13 +56,28 @@ update mode
query mode
-----------------------------------------------------------------------
---find=<name> Resolve a font name; this looks up <name> in
+--find=NAME Resolve a font name; this looks up <name> in
the database and prints the file name it is
mapped to.
--fuzzy, -F Show approximate matches to the file name if
- the lookup was unsuccessful (requires ``--find``).
+ the lookup was unsuccessful (requires
+ ``--find``).
--info, -i Display basic information to a resolved font
file (requires ``--find``).
+--list=CRITERION Show entries, where *CRITERION* is one of the
+ following:
+
+ 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
+ 3) an expression of the form ``field:value`` to
+ limit the output to entries whose ``field``
+ matches ``value``.
+
+--fields=FIELDS Comma-separated list of fields that should be
+ printed. The default is *fullname,version*.
+ (Only meaningful with ``--list``.)
lookup cache
-----------------------------------------------------------------------
@@ -68,7 +85,7 @@ lookup cache
miscellaneous
-----------------------------------------------------------------------
---verbose=<n>, -v Set verbosity level to *n* or the number of
+--verbose=N, -v Set verbosity level to *n* or the number of
repetitions of ``-v``.
--quiet No verbose output (log level set to zero).
--log=stdout Redirect log output to terminal (for database