1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
|
=======================================================================
luaotfload-tool
=======================================================================
-----------------------------------------------------------------------
generate and query the Luaotfload font names database
-----------------------------------------------------------------------
:Date: 2014-01-02
:Copyright: GPL v2.0
:Version: 2.5
:Manual section: 1
:Manual group: text processing
SYNOPSIS
=======================================================================
**luaotfload-tool** [ -bDfFiIlnpquvVhw ]
**luaotfload-tool** --update [ --force ] [ --quiet ] [ --verbose ]
[ --prefer-texmf ] [ --dry-run ]
[ --formats=[+|-]EXTENSIONS ]
[ --no-compress ] [ --no-strip ]
**luaotfload-tool** --find=FONTNAME [ --fuzzy ] [ --info ] [ --inspect ]
[ --no-reload ]
**luaotfload-tool** --flush-lookups
**luaotfload-tool** --cache=DIRECTIVE
**luaotfload-tool** --list=CRITERION[:VALUE] [ --fields=F1,F2,...,Fn ]
**luaotfload-tool** --help
**luaotfload-tool** --version
**luaotfload-tool** --show-blacklist
**luaotfload-tool** --diagnose=CHECK
DESCRIPTION
=======================================================================
luaotfload-tool accesses the font names database that is required by
the *Luaotfload* package. There are two general modes: **update** and
**query**.
+ **update**: update the database or rebuild it entirely;
+ **query**: resolve a font name or display close matches.
OPTIONS
=======================================================================
update mode
-----------------------------------------------------------------------
--update, -u Update the database; indexes new fonts.
--force, -f Force rebuilding of the database; re-indexes
all fonts.
--no-reload, -n Suppress auto-updates to the database (e.g.
when ``--find`` is passed an unknown name).
--no-strip Do not strip redundant information after
building the database. Warning: this will
inflate the index to about two to three times
the normal size.
--no-compress, -c Do not filter the plain text version of the
font index through gzip. Useful for debugging
if your editor is built without zlib.
--prefer-texmf, -p Organize the file name database in a way so
that it prefer fonts in the *TEXMF* tree over
system fonts if they are installed in both.
--max-fonts=N Process at most *N* font files, including fonts
already indexed in the count.
--formats=EXTENSIONS Extensions of the font files to index.
Where *EXTENSIONS* is a comma-separated list of
supported file extensions (otf, ttf, ttc,
dfont, pfa, and pfb). If the list is prefixed
with a ``+`` sign, the given list is added to
the currently active one; ``-`` subtracts.
Default: *otf,ttf,ttc,dfont*.
Examples:
1) ``--formats=-ttc,ttf`` would skip
TrueType fonts and font collections;
2) ``--formats=otf`` would scan only OpenType
files;
3) ``--formats=+pfb`` includes binary
Postscript files. **Warning**: with a
standard TeX Live installation this will
grow the database considerably and slow down
font indexing.
--dry-run, -D Don’t load fonts, scan directories only.
(For debugging file system related issues.)
query mode
-----------------------------------------------------------------------
--find=NAME Resolve a font name; this looks up <name> in
the database and prints the file name it is
mapped to.
``--find`` also understands request syntax,
i.e. ``--find=file:foo.otf`` checks whether
``foo.otf`` is indexed.
--fuzzy, -F Show approximate matches to the file name if
the lookup was unsuccessful (requires
``--find``).
--info, -i Display basic information to a resolved font
file (requires ``--find``).
--inspect, -I Display detailed information by loading the
font and analyzing the font table; very slow!
For the meaning of the returned fields see
the LuaTeX documentation.
(requires ``--find``).
--warnings, -w Print the warnings generated by the fontloader
library (assumes ``-I``). Automatically enabled
if the verbosity level exceeds 2.
--show-blacklist, -b Show blacklisted files (not directories).
--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
*version* or *format**, according to which
the output will be sorted.
Information in an unstripped database (see
the option ``--no-strip`` above) is nested:
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.
Information in an unstripped database (see the
option ``--no-strip`` above) is nested:
Subfields of a record can be addressed using
the ``->`` separator, e. g.
``file->location``, ``style->units_per_em``,
or ``names->sanitized->english->subfamily``.
The default is plainname,version*.
(Only meaningful with ``--list``.)
font and lookup caches
-----------------------------------------------------------------------
--flush-lookups Clear font name lookup cache (experimental).
--cache=DIRECTIVE Cache control, where *DIRECTIVE* is one of the
following:
1) ``purge`` -> delete Lua files from cache;
2) ``erase`` -> delete Lua and Luc files from
cache;
3) ``show`` -> print stats.
miscellaneous
-----------------------------------------------------------------------
--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=CHANNEL Redirect log output (for database
troubleshooting), where *CHANNEL* can be
1) ``stdout`` -> all output will be
dumped to the terminal (default); or
2) ``file`` -> write to a file to the temporary
directory (the name will be chosen
automatically.
--version, -V Show version numbers of components as well as
some basic information and exit.
--help, -h Show help message and exit.
--diagnose=CHECK Run the diagnostic procedure *CHECK*. Available
procedures are:
1) ``files`` -> check *Luaotfload* files for
modifications;
2) ``permissions`` -> check permissions of
cache directories and files;
3) ``environment`` -> print relevant
environment and kpse variables;
4) ``repository`` -> check the git repository
for new releases,
5) ``index`` -> check database, display
information about it.
Procedures can be chained by concatenating with
commas, e.g. ``--diagnose=files,permissions``.
Specify ``thorough`` to run all checks.
FILES
=======================================================================
The font name database is usually located in the directory
``texmf-var/luatex-cache/generic/names/`` (``$TEXMFCACHE`` as set in
``texmf.cnf``) of your *TeX Live* distribution as a zlib-compressed
file ``luaotfload-names.lua.gz``.
The experimental lookup cache will be created as
``luaotfload-lookup-cache.lua`` in the same directory.
These Lua tables are not used directly by Luaotfload, though.
Instead, they are compiled to Lua bytecode which is written to
corresponding files with the extension ``.luc`` in the same directory.
When modifying the files by hand keep in mind that only if the bytecode
files are missing will Luaotfload use the plain version instead.
Both kinds of files are safe to delete, at the cost of regenerating
them with the next run of *LuaTeX*.
SEE ALSO
=======================================================================
**luatex** (1), **lua** (1)
* ``texdoc luaotfload`` to display the manual for the *Luaotfload*
package
* Luaotfload development `<https://github.com/lualatex/luaotfload>`_
* LuaLaTeX mailing list `<http://tug.org/pipermail/lualatex-dev/>`_
* LuaTeX `<http://luatex.org/>`_
* ConTeXt `<http://wiki.contextgarden.net>`_
* Luaotfload on CTAN `<http://ctan.org/pkg/luaotfload>`_
BUGS
=======================================================================
Tons, probably.
AUTHORS
=======================================================================
*Luaotfload* is maintained by the LuaLaTeX dev team
(`<https://github.com/lualatex/>`__).
The fontloader code is provided by Hans Hagen of Pragma ADE, Hasselt
NL (`<http://pragma-ade.com/>`__).
This manual page was written by Philipp Gesang
<philipp.gesang@alumni.uni-heidelberg.de>.
|
