update manpage and usage info

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