[latex3-commits] [git/LaTeX3-latex3-luaotfload] master-v3.0008-201910290: ignore temporary man files (143988b)
Ulrike Fischer
fischer at troubleshooting-tex.de
Tue Nov 5 15:02:53 CET 2019
Repository : https://github.com/latex3/luaotfload
On branch : master-v3.0008-201910290
Link : https://github.com/latex3/luaotfload/commit/143988b33d93aa7fb68370c64c7b23cb8dd3b8e5
>---------------------------------------------------------------
commit 143988b33d93aa7fb68370c64c7b23cb8dd3b8e5
Author: Ulrike Fischer <fischer at troubleshooting-tex.de>
Date: Tue Nov 5 15:02:53 2019 +0100
ignore temporary man files
>---------------------------------------------------------------
143988b33d93aa7fb68370c64c7b23cb8dd3b8e5
.gitignore | 2 +
doc/luaotfload-tool.1 | 442 -----------------------------------
doc/luaotfload.conf.5 | 632 --------------------------------------------------
3 files changed, 2 insertions(+), 1074 deletions(-)
diff --git a/.gitignore b/.gitignore
index f9bec74..aa54672 100644
--- a/.gitignore
+++ b/.gitignore
@@ -71,6 +71,8 @@ doc/*.tmp
doc/*.toc
doc/*.tuc
doc/*.vimout
+doc/*.1
+doc/*.5
*.synctex
*.synctex.gz
diff --git a/doc/luaotfload-tool.1 b/doc/luaotfload-tool.1
deleted file mode 100644
index 106fa37..0000000
--- a/doc/luaotfload-tool.1
+++ /dev/null
@@ -1,442 +0,0 @@
-.\" Man page generated from reStructuredText.
-.
-.TH LUAOTFLOAD-TOOL 1 "2019-10-29" "3.0008-dev" "text processing"
-.SH NAME
-luaotfload-tool \- generate and query the Luaotfload font names database
-.
-.nr rst2man-indent-level 0
-.
-.de1 rstReportMargin
-\\$1 \\n[an-margin]
-level \\n[rst2man-indent-level]
-level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
--
-\\n[rst2man-indent0]
-\\n[rst2man-indent1]
-\\n[rst2man-indent2]
-..
-.de1 INDENT
-.\" .rstReportMargin pre:
-. RS \\$1
-. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
-. nr rst2man-indent-level +1
-.\" .rstReportMargin post:
-..
-.de UNINDENT
-. RE
-.\" indent \\n[an-margin]
-.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
-.nr rst2man-indent-level -1
-.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
-.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
-..
-.SH SYNOPSIS
-.sp
-\fBluaotfload\-tool\fP [ \-bcDfFiIlLnpqRSuvVhw ]
-.INDENT 0.0
-.TP
-.B \fBluaotfload\-tool\fP \-\-update [ \-\-force ] [ \-\-quiet ] [ \-\-verbose ]
-[ \-\-prefer\-texmf ] [ \-\-dry\-run ]
-[ \-\-formats=[+|\-]EXTENSIONS ]
-[ \-\-no\-compress ] [ \-\-no\-strip ]
-[ \-\-local ] [ \-\-max\-fonts=N ]
-.TP
-.B \fBluaotfload\-tool\fP \-\-find=FONTNAME [ \-\-fuzzy ] [ \-\-info ] [ \-\-inspect ]
-[ \-\-no\-reload ]
-.UNINDENT
-.sp
-\fBluaotfload\-tool\fP \-\-flush\-lookups
-.sp
-\fBluaotfload\-tool\fP \-\-cache=DIRECTIVE
-.sp
-\fBluaotfload\-tool\fP \-\-list=CRITERION[:VALUE] [ \-\-fields=F1,F2,..,Fn ]
-.sp
-\fBluaotfload\-tool\fP \-\-bisect=DIRECTIVE
-.sp
-\fBluaotfload\-tool\fP \-\-help
-.sp
-\fBluaotfload\-tool\fP \-\-version
-.sp
-\fBluaotfload\-tool\fP \-\-show\-blacklist
-.sp
-\fBluaotfload\-tool\fP \-\-diagnose=CHECK
-.sp
-\fBluaotfload\-tool\fP \-\-conf=FILE \-\-dumpconf
-.SH DESCRIPTION
-.sp
-luaotfload\-tool accesses the font names database that is required by
-the \fILuaotfload\fP package. There are two general modes: \fBupdate\fP and
-\fBquery\fP\&.
-.INDENT 0.0
-.IP \(bu 2
-\fBupdate\fP: update the database or rebuild it entirely;
-.IP \(bu 2
-\fBquery\fP: resolve a font name or display close matches.
-.UNINDENT
-.SH OPTIONS
-.SS update mode
-.INDENT 0.0
-.TP
-.B \-\-update\fP,\fB \-u
-Update the database; indexes new fonts.
-.TP
-.B \-\-force\fP,\fB \-f
-Force rebuilding of the database; re\-indexes
-all fonts.
-.TP
-.B \-\-local\fP,\fB \-L
-Include font files in \fB$PWD\fP\&. This option
-will cause large parts of the database to be
-rebuilt. Thus it is quite inefficient.
-Additionally, if local font files are found,
-the database is prevented from being saved
-to disk, so the local fonts need to be parsed
-with every invocation of \fBluaotfload\-tool\fP\&.
-.TP
-.B \-\-no\-reload\fP,\fB \-n
-Suppress auto\-updates to the database (e.g.
-when \fB\-\-find\fP is passed an unknown name).
-.TP
-.B \-\-no\-compress\fP,\fB \-c
-Do not filter the plain text version of the
-font index through gzip. Useful for debugging
-if your editor is built without zlib.
-.TP
-.B \-\-prefer\-texmf\fP,\fB \-p
-Organize the file name database in a way so
-that it prefer fonts in the \fITEXMF\fP tree over
-system fonts if they are installed in both.
-.TP
-.BI \-\-formats\fB= EXTENSIONS
-Extensions of the font files to index.
-Where \fIEXTENSIONS\fP is a comma\-separated list of
-supported file extensions (otf, ttf, ttc).
-If the list is prefixed
-with a \fB+\fP sign, the given list is added to
-the currently active one; \fB\-\fP subtracts.
-Default: \fIotf,ttf,ttc\fP\&.
-Examples:
-.INDENT 7.0
-.IP 1. 3
-\fB\-\-formats=\-ttc,ttf\fP would skip
-TrueType fonts and font collections;
-.IP 2. 3
-\fB\-\-formats=otf\fP would scan only OpenType
-files;
-.IP 3. 3
-\fB\-\-formats=+afm\fP includes binary
-Postscript files accompanied by an AFM file.
-.UNINDENT
-.UNINDENT
-.SS query mode
-.INDENT 0.0
-.TP
-.BI \-\-find\fB= NAME
-Resolve a font name; this looks up <name> in
-the database and prints the file name it is
-mapped to.
-\fB\-\-find\fP also understands request syntax,
-i.e. \fB\-\-find=file:foo.otf\fP checks whether
-\fBfoo.otf\fP is indexed.
-.TP
-.B \-\-fuzzy\fP,\fB \-F
-Show approximate matches to the file name if
-the lookup was unsuccessful (requires
-\fB\-\-find\fP).
-.TP
-.B \-\-info\fP,\fB \-i
-Display basic information to a resolved font
-file (requires \fB\-\-find\fP).
-.TP
-.B \-\-inspect\fP,\fB \-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 \fB\-\-find\fP).
-.TP
-.BI \-\-list\fB= CRITERION
-Show entries, where \fICRITERION\fP is one of the
-following:
-.INDENT 7.0
-.IP 1. 3
-the character \fB*\fP, selecting all entries;
-.IP 2. 3
-a field of a database entry, for instance
-\fIversion\fP or \fIformat*\fP, according to which
-the output will be sorted.
-Information in an unstripped database (see
-the option \fB\-\-no\-strip\fP above) is nested:
-Subfields of a record can be addressed using
-the \fB\->\fP separator, e. g.
-\fBfile\->location\fP, \fBstyle\->units_per_em\fP,
-or
-\fBnames\->sanitized\->english\->prefmodifiers\fP\&.
-NB: shell syntax requires that arguments
-containing \fB\->\fP be properly quoted!
-.IP 3. 3
-an expression of the form \fBfield:value\fP to
-limit the output to entries whose \fBfield\fP
-matches \fBvalue\fP\&.
-.UNINDENT
-.sp
-For example, in order to output file names and
-corresponding versions, sorted by the font
-format:
-.INDENT 7.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-\&./luaotfload\-tool.lua \-\-list="format" \-\-fields="file\->base,version"
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-This prints:
-.INDENT 7.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-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
-\&...
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.TP
-.BI \-\-fields\fB= FIELDS
-Comma\-separated list of fields that should be
-printed.
-Information in an unstripped database (see the
-option \fB\-\-no\-strip\fP above) is nested:
-Subfields of a record can be addressed using
-the \fB\->\fP separator, e. g.
-\fBfile\->location\fP, \fBstyle\->units_per_em\fP,
-or \fBnames\->sanitized\->english\->subfamily\fP\&.
-The default is plainname,version*.
-(Only meaningful with \fB\-\-list\fP\&.)
-.UNINDENT
-.SS font and lookup caches
-.INDENT 0.0
-.TP
-.B \-\-flush\-lookups
-Clear font name lookup cache (experimental).
-.TP
-.BI \-\-cache\fB= DIRECTIVE
-Cache control, where \fIDIRECTIVE\fP is one of the
-following:
-.INDENT 7.0
-.IP 1. 3
-\fBpurge\fP \-> delete Lua files from cache;
-.IP 2. 3
-\fBerase\fP \-> delete Lua and Luc files from
-cache;
-.IP 3. 3
-\fBshow\fP \-> print stats.
-.UNINDENT
-.UNINDENT
-.SS debugging methods
-.INDENT 0.0
-.TP
-.B \-\-show\-blacklist\fP,\fB \-b
-Show blacklisted files (not directories).
-.TP
-.B \-\-dry\-run\fP,\fB \-D
-Don’t load fonts when updating the database;
-scan directories only.
-(For debugging file system related issues.)
-.TP
-.B \-\-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.
-.TP
-.BI \-\-max\-fonts\fB= N
-Process at most \fIN\fP font files, including fonts
-already indexed in the count.
-.TP
-.BI \-\-bisect\fB= DIRECTIVE
-Bisection of the font database.
-This mode is intended as assistance in
-debugging the Luatex engine, especially when
-tracking memleaks or buggy fonts.
-.sp
-\fIDIRECTIVE\fP can be one of the following:
-.INDENT 7.0
-.IP 1. 3
-\fBrun\fP \-> Make \fBluaotfload\-tool\fP respect
-the bisection progress when running.
-Combined with \fB\-\-update\fP and possibly
-\fB\-\-force\fP this will only process the files
-from the start up until the pivot and ignore
-the rest.
-.IP 2. 3
-\fBstart\fP \-> Start bisection: create a
-bisection state file and initialize the low,
-high, and pivot indices.
-.IP 3. 3
-\fBstop\fP \-> Terminate the current bisection
-session by deleting the state file.
-.IP 4. 3
-\fBgood\fP | \fBbad\fP \-> Mark the section
-processed last as “good” or “bad”,
-respectively. The next bisection step will
-continue with the bad section.
-.IP 5. 3
-\fBstatus\fP \-> Print status information about
-the current bisection session. Hint: Use
-with higher verbosity settings for more
-output.
-.UNINDENT
-.sp
-A bisection session is initiated by issuing the
-\fBstart\fP directive. This sets the pivot to the
-middle of the list of available font files.
-Now run \fIluaotfload\-tool\fP with the \fB\-\-update\fP
-flag set as well as \fB\-\-bisect=run\fP: only the
-fonts up to the pivot will be considered. If
-that task exhibited the issue you are tracking,
-then tell Luaotfload using \fB\-\-bisect=bad\fP\&.
-The next step of \fB\-\-bisect=run\fP will continue
-bisection with the part of the files below the
-pivot.
-Likewise, issue \fB\-\-bisect=good\fP in order to
-continue with the fonts above the pivot,
-assuming the tested part of the list did not
-trigger the bug.
-.sp
-Once the culprit font is tracked down, \fBgood\fP
-or \fBbad\fP will have no effect anymore. \fBrun\fP
-will always end up processing the single font
-file that was left.
-Use \fB\-\-bisect=stop\fP to clear the bisection
-state.
-.UNINDENT
-.SS miscellaneous
-.INDENT 0.0
-.TP
-.BI \-\-verbose\fB= N\fP,\fB \ \-v
-Set verbosity level to \fIn\fP or the number of
-repetitions of \fB\-v\fP\&.
-.TP
-.B \-\-quiet
-No verbose output (log level set to zero).
-.TP
-.BI \-\-log\fB= CHANNEL
-Redirect log output (for database
-troubleshooting), where \fICHANNEL\fP can be
-.INDENT 7.0
-.IP 1. 3
-\fBstdout\fP \-> all output will be
-dumped to the terminal (default); or
-.IP 2. 3
-\fBfile\fP \-> write to a file to the temporary
-directory (the name will be chosen
-automatically.
-.UNINDENT
-.TP
-.B \-\-version\fP,\fB \-V
-Show version numbers of components as well as
-some basic information and exit.
-.TP
-.B \-\-help\fP,\fB \-h
-Show help message and exit.
-.TP
-.BI \-\-diagnose\fB= CHECK
-Run the diagnostic procedure \fICHECK\fP\&. Available
-procedures are:
-.INDENT 7.0
-.IP 1. 3
-\fBfiles\fP \-> check \fILuaotfload\fP files for
-modifications;
-.IP 2. 3
-\fBpermissions\fP \-> check permissions of
-cache directories and files;
-.IP 3. 3
-.INDENT 3.0
-.TP
-.B \fBenvironment\fP \-> print relevant
-environment and kpse variables;
-.UNINDENT
-.IP 4. 3
-\fBrepository\fP \-> check the git repository
-for new releases,
-.IP 5. 3
-\fBindex\fP \-> check database, display
-information about it.
-.UNINDENT
-.sp
-Procedures can be chained by concatenating with
-commas, e.g. \fB\-\-diagnose=files,permissions\fP\&.
-Specify \fBthorough\fP to run all checks.
-.TP
-.BI \-\-conf\fB= FILE
-Read the configuration from \fIFILE\fP\&. See
-\fBluaotfload.conf\fP(%) for documentation
-concerning the format and available options.
-.TP
-.B \-\-dumpconf
-Print the currently active configuration; the
-output can be saved to a file and used for
-bootstrapping a custom configuration files.
-.UNINDENT
-.SH FILES
-.sp
-The font name database is usually located in the directory
-\fBtexmf\-var/luatex\-cache/generic/names/\fP (\fB$TEXMFCACHE\fP as set in
-\fBtexmf.cnf\fP) of your \fITeX Live\fP distribution as a zlib\-compressed
-file \fBluaotfload\-names.lua.gz\fP\&.
-The experimental lookup cache will be created as
-\fBluaotfload\-lookup\-cache.lua\fP 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 \fB\&.luc\fP 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 \fILuaTeX\fP\&.
-.SH SEE ALSO
-.sp
-\fBluaotfload.conf\fP(5), \fBluatex\fP(1), \fBlua\fP(1)
-.INDENT 0.0
-.IP \(bu 2
-\fBtexdoc luaotfload\fP to display the manual for the \fILuaotfload\fP
-package
-.IP \(bu 2
-Luaotfload development \fI\%https://github.com/lualatex/luaotfload\fP
-.IP \(bu 2
-LuaLaTeX mailing list \fI\%http://tug.org/pipermail/lualatex\-dev/\fP
-.IP \(bu 2
-LuaTeX \fI\%http://luatex.org/\fP
-.IP \(bu 2
-ConTeXt \fI\%http://wiki.contextgarden.net\fP
-.IP \(bu 2
-Luaotfload on CTAN \fI\%http://ctan.org/pkg/luaotfload\fP
-.UNINDENT
-.SH BUGS
-.sp
-Tons, probably.
-.SH AUTHORS
-.sp
-\fILuaotfload\fP was developed by the LuaLaTeX dev team
-(\fI\%https://github.com/lualatex/\fP). It is currently maintained by Ulrike Fischer
-and Marcel Krüger at \fI\%https://github.com/u\-fischer/luaotfload\fP
-The fontloader code is provided by Hans Hagen of Pragma ADE, Hasselt
-NL (\fI\%http://pragma\-ade.com/\fP).
-.sp
-This manual page was written by Philipp Gesang <\fI\%phg at phi\-gamma.net\fP>.
-.SH COPYRIGHT
-GPL v2.0
-.\" Generated by docutils manpage writer.
-.
diff --git a/doc/luaotfload.conf.5 b/doc/luaotfload.conf.5
deleted file mode 100644
index 17ceaa5..0000000
--- a/doc/luaotfload.conf.5
+++ /dev/null
@@ -1,632 +0,0 @@
-.\" Man page generated from reStructuredText.
-.
-.TH LUAOTFLOAD.CONF 5 "2019-10-29" "3.0008-dev" "text processing"
-.SH NAME
-luaotfload.conf \- Luaotfload configuration file
-.
-.nr rst2man-indent-level 0
-.
-.de1 rstReportMargin
-\\$1 \\n[an-margin]
-level \\n[rst2man-indent-level]
-level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
--
-\\n[rst2man-indent0]
-\\n[rst2man-indent1]
-\\n[rst2man-indent2]
-..
-.de1 INDENT
-.\" .rstReportMargin pre:
-. RS \\$1
-. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
-. nr rst2man-indent-level +1
-.\" .rstReportMargin post:
-..
-.de UNINDENT
-. RE
-.\" indent \\n[an-margin]
-.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
-.nr rst2man-indent-level -1
-.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
-.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
-..
-.SH SYNOPSIS
-.INDENT 0.0
-.IP \(bu 2
-\fB\&./luaotfload{.conf,rc}\fP
-.IP \(bu 2
-\fBXDG_CONFIG_HOME/luaotfload/luaotfload{.conf,rc}\fP
-.IP \(bu 2
-\fB~/.luaotfloadrc\fP
-.UNINDENT
-.SH DESCRIPTION
-.sp
-The file \fBluaotfload.conf\fP contains configuration options for
-\fILuaotfload\fP, a font loading and font management component for LuaTeX.
-.SH EXAMPLE
-.sp
-A small Luaotfload configuration file with few customizations could
-look as follows:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-[db]
- formats = afm,ttf
- compress = false
-
-[misc]
- termwidth = 60
-
-[run]
- log\-level = 6
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-This will make Luaotfload ignore all font files except for PostScript
-binary fonts with a matching AFM file, and Truetype fonts. Also, an
-uncompressed index file will be dumped which is going to be much larger
-than the default gzip’ed index. The terminal width
-is truncated to 60 characters which influences the verbose output
-during indexing. Finally, the verbosity is increased greatly: each font
-file being processed will be printed to the stdout on a separate line,
-along with lots of other information.
-.sp
-To observe the difference in behavior, save above snippet to
-\fB\&./luaotfload.conf\fP and update the font index:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-luaotfload\-tool \-\-update \-\-force
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-The current configuration can be written to disk using
-\fBluaotfload\-tool\fP:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-luaotfload\-tool \-\-dumpconf > luaotfload.conf
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-The result can itself be used as a configuration file.
-.SH SYNTAX
-.sp
-The configuration file syntax follows the common INI format. For a more
-detailed description please refer to the section “CONFIGURATION FILE”
-of \fBgit\-config\fP(1). A brief list of rules is given below:
-.INDENT 0.0
-.INDENT 3.5
-.INDENT 0.0
-.IP \(bu 2
-Blank lines and lines starting with a semicolon (\fB;\fP) are ignored.
-.IP \(bu 2
-A configuration file is partitioned into sections that are declared
-by specifying the section title in brackets on a separate line:
-.INDENT 2.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-[some\-section]
-\&... section content ...
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.IP \(bu 2
-Sections consist of one or more variable assignments of the form
-\fBvariable\-name = value\fP E. g.:
-.INDENT 2.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-[foo]
- bar = baz
- quux = xyzzy
- ...
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.IP \(bu 2
-Section and variable names may contain only uppercase and lowercase
-letters as well as dashes (\fB\-\fP).
-.UNINDENT
-.UNINDENT
-.UNINDENT
-.SH VARIABLES
-.sp
-Variables in belong into a configuration section and their values must
-be of a certain type. Some of them have further constraints. For
-example, the “color callback” must be a string of one of the values
-\fBpost_linebreak_filter\fP, \fBpre_linebreak_filter\fP, or
-\fBpre_output_filter\fP, defined in the section \fIrun\fP of the
-configuration file.
-.sp
-Currently, the configuration is organized into four sections:
-.INDENT 0.0
-.TP
-.B db
-Options relating to the font index.
-.TP
-.B misc
-Options without a clearly defined category.
-.TP
-.B paths
-Path and file name settings.
-.TP
-.B run
-Options controlling runtime behavior of Luaotfload.
-.UNINDENT
-.sp
-The list of valid variables, the sections they are part of and their
-type is given below. Types represent Lua types that the values must be
-convertible to; they are abbreviated as follows: \fBs\fP for the \fIstring\fP
-type, \fBn\fP for \fInumber\fP, \fBb\fP for \fIboolean\fP\&. A value of \fBnil\fP means
-the variable is unset.
-.SS Section \fBdb\fP
-.TS
-center;
-|l|l|l|.
-_
-T{
-variable
-T} T{
-type
-T} T{
-default
-T}
-_
-T{
-compress
-T} T{
-b
-T} T{
-\fBtrue\fP
-T}
-_
-T{
-designsize\-dimen
-T} T{
-b
-T} T{
-\fBbp\fP
-T}
-_
-T{
-formats
-T} T{
-s
-T} T{
-\fB"otf,ttf,ttc"\fP
-T}
-_
-T{
-max\-fonts
-T} T{
-n
-T} T{
-\fB2^51\fP
-T}
-_
-T{
-scan\-local
-T} T{
-b
-T} T{
-\fBfalse\fP
-T}
-_
-T{
-skip\-read
-T} T{
-b
-T} T{
-\fBfalse\fP
-T}
-_
-T{
-strip
-T} T{
-b
-T} T{
-\fBtrue\fP
-T}
-_
-T{
-update\-live
-T} T{
-b
-T} T{
-\fBtrue\fP
-T}
-_
-.TE
-.sp
-The flag \fBcompress\fP determines whether the font index (usually
-\fBluaotfload\-names.lua[.gz]\fP will be stored in compressed forms.
-If unset it is equivalent of passing \fB\-\-no\-compress\fP to
-\fBluaotfload\-tool\fP\&. Since the file is only created for convenience
-and has no effect on the runtime behavior of Luaotfload, the flag
-should remain set. Most editors come with zlib support anyways.
-.sp
-The setting \fBdesignsize\-dimen\fP applies when looking up fonts from
-families with design sizes. In Opentype, these are specified as
-“decipoints” where one decipoint equals ten DTP style “big points”.
-When indexing fonts these values are converted to \fBsp\fP\&. In order to
-treat the values as though they were specified in TeX points or Didot
-points, set \fBdesignsize\-dimen\fP to \fBpt\fP or \fBdd\fP\&.
-.sp
-The list of \fBformats\fP must be a comma separated sequence of strings
-containing one or more of these elements:
-.INDENT 0.0
-.IP \(bu 2
-\fBotf\fP (OpenType format),
-.IP \(bu 2
-\fBttf\fP and \fBttc\fP (TrueType format),
-.IP \(bu 2
-\fBafm\fP (Adobe Font Metrics),
-.UNINDENT
-.sp
-It corresponds loosely to the \fB\-\-formats\fP option to
-\fBluaotfload\-tool\fP\&. Invalid or duplicate members are ignored; if the
-list does not contain any useful identifiers, the default list
-\fB"otf,ttf,ttc"\fP will be used.
-.sp
-The variable \fBmax\-fonts\fP determines after processing how many font
-files the font scanner will terminate the search. This is useful for
-debugging issues with the font index and has the same effect as the
-option \fB\-\-max\-fonts\fP to \fBluaotfload\-tools\fP\&.
-.sp
-The \fBscan\-local\fP flag, if set, will incorporate the current working
-directory as a font search location. NB: This will potentially slow
-down document processing because a font index with local fonts will not
-be saved to disk, so these fonts will have to be re\-indexed whenever
-the document is built.
-.sp
-The \fBskip\-read\fP flag is only useful for debugging: It makes
-Luaotfload skip reading fonts. The font information for rebuilding the
-index is taken from the presently existing one.
-.sp
-Unsetting the \fBstrip\fP flag prevents Luaotfload from removing data
-from the index that is only useful when processing font files. NB: this
-can increase the size of the index files significantly and has no
-effect on the runtime behavior.
-.sp
-If \fBupdate\-live\fP is set, Luaotfload will reload the database if it
-cannot find a requested font. Those who prefer to update manually using
-\fBluaotfload\-tool\fP should unset this flag. This option does not affect
-rebuilds due to version mismatch.
-.SS Section \fBdefault\-features\fP
-.sp
-By default Luaotfload enables \fBnode\fP mode and picks the default font
-features that are prescribed in the OpenType standard. This behavior
-may be overridden in the \fBdefault\-features\fP section. Global defaults
-that will be applied for all scripts can be set via the \fBglobal\fP
-option, others by the script they are to be applied to. For example,
-a setting of
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-[default\-features]
- global = mode=base,color=0000FF
- dflt = smcp,onum
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-would force \fIbase\fP mode, tint all fonts blue and activate small
-capitals and text figures globally. Features are specified as a comma
-separated list of variables or variable\-value pairs. Variables without
-an explicit value are set to \fBtrue\fP\&.
-.SS Section \fBmisc\fP
-.TS
-center;
-|l|l|l|.
-_
-T{
-variable
-T} T{
-type
-T} T{
-default
-T}
-_
-T{
-statistics
-T} T{
-b
-T} T{
-\fBfalse\fP
-T}
-_
-T{
-termwidth
-T} T{
-n
-T} T{
-\fBnil\fP
-T}
-_
-T{
-version
-T} T{
-s
-T} T{
-<Luaotfload version>
-T}
-_
-.TE
-.sp
-With \fBstatistics\fP enabled, extra statistics will be collected during
-index creation and appended to the index file. It may then be queried
-at the Lua end or inspected by reading the file itself.
-.sp
-The value of \fBtermwidth\fP, if set, overrides the value retrieved by
-querying the properties of the terminal in which Luatex runs. This is
-useful if the engine runs with \fBshell_escape\fP disabled and the actual
-terminal dimensions cannot be retrieved.
-.sp
-The value of \fBversion\fP is derived from the version string hard\-coded
-in the Luaotfload source. Override at your own risk.
-.SS Section \fBpaths\fP
-.TS
-center;
-|l|l|l|.
-_
-T{
-variable
-T} T{
-type
-T} T{
-default
-T}
-_
-T{
-cache\-dir
-T} T{
-s
-T} T{
-\fB"fonts"\fP
-T}
-_
-T{
-names\-dir
-T} T{
-s
-T} T{
-\fB"names"\fP
-T}
-_
-T{
-index\-file
-T} T{
-s
-T} T{
-\fB"luaotfload\-names.lua"\fP
-T}
-_
-T{
-lookups\-file
-T} T{
-s
-T} T{
-\fB"luaotfload\-lookup\-cache.lua"\fP
-T}
-_
-.TE
-.sp
-The paths \fBcache\-dir\fP and \fBnames\-dir\fP determine the subdirectory
-inside the Luaotfload subtree of the \fBluatex\-cache\fP directory where
-the font cache and the font index will be stored, respectively.
-.sp
-Inside the index directory, the names of the index file and the font
-lookup cache will be derived from the respective values of
-\fBindex\-file\fP and \fBlookups\-file\fP\&. This is the filename base for the
-bytecode compiled version as well as \-\- for the index \-\- the gzipped
-version.
-.SS Section \fBrun\fP
-.TS
-center;
-|l|l|l|.
-_
-T{
-variable
-T} T{
-type
-T} T{
-default
-T}
-_
-T{
-anon\-sequence
-T} T{
-s
-T} T{
-\fB"tex,path,name"\fP
-T}
-_
-T{
-color\-callback
-T} T{
-s
-T} T{
-\fB"post_linebreak_filter"\fP
-T}
-_
-T{
-definer
-T} T{
-s
-T} T{
-\fB"patch"\fP
-T}
-_
-T{
-log\-level
-T} T{
-n
-T} T{
-\fB0\fP
-T}
-_
-T{
-resolver
-T} T{
-s
-T} T{
-\fB"cached"\fP
-T}
-_
-T{
-fontloader
-T} T{
-s
-T} T{
-\fB"default"\fP
-T}
-_
-.TE
-.sp
-Unqualified font lookups are treated with the flexible “anonymous”
-mechanism. This involves a chain of lookups applied successively until
-the first one yields a match. By default, the lookup will first search
-for TFM fonts using the Kpathsea library. If this wasn’t successful, an
-attempt is made at interpreting the request as an absolute path (like
-the \fB[/path/to/font/foo.ttf]\fP syntax) or a file name
-(\fBfile:foo.ttf\fP). Finally, the request is interpreted as a font name
-and retrieved from the index (\fBname:Foo Regular\fP). This behavior can
-be configured by specifying a list as the value to \fBanon\-sequence\fP\&.
-Available items are \fBtex\fP, \fBpath\fP, \fBname\fP \-\- representing the
-lookups described above, respectively \-\-, and \fBfile\fP for searching a
-filename but not an absolute path. Also, \fBmy\fP lookups are valid
-values but they should only be used from within TeX documents, because
-there is no means of customizing a \fBmy\fP lookups on the command line.
-.sp
-The \fBcolor\-callback\fP option determines the stage at which fonts that
-defined with a \fBcolor=xxyyzz\fP feature will be colorized. By default
-this happens in a \fBpost_linebreak_filter\fP but alternatively the
-\fBpre_linebreak_filter\fP or \fBpre_output_filter\fP may be chosen, which
-is faster but might produce inconsistent output. The
-\fBpre_output_filter\fP used to be the default in the 1.x series of
-Luaotfload, whilst later versions up to and including 2.5 hooked into
-the \fBpre_linebreak_filter\fP which naturally didn’t affect any glyphs
-inserting during hyphenation. Both are kept around as options to
-restore the previous behavior if necessary.
-.sp
-The \fBdefiner\fP allows for switching the \fBdefine_font\fP callback.
-Apart from the default \fBpatch\fP one may also choose the \fBgeneric\fP
-one that comes with the vanilla fontloader. Beware that this might
-break tools like Fontspec that rely on the \fBpatch_font\fP callback
-provided by Luaotfload to perform important corrections on font data.
-.sp
-The fontloader backend can be selected by setting the value of
-\fBfontloader\fP\&. The most important choices are \fBdefault\fP, which will
-load the dedicated Luaotfload fontloader, and \fBreference\fP, the
-upstream package as shipped with Luaotfload. Other than those, a file
-name accessible via kpathsea can be specified.
-.sp
-Alternatively, the individual files that constitute the fontloader can
-be loaded directly. While less efficient, this greatly aids debugging
-since error messages will reference the actual line numbers of the
-source files and explanatory comments are not stripped. Currently,
-three distinct loading strategies are available: \fBunpackaged\fP will
-load the batch that is part of Luaotfload. These contain the identical
-source code that the reference fontloader has been compiled from.
-Another option, \fBcontext\fP will attempt to load the same files by
-their names in the Context format from the search path. Consequently
-this option allows to use the version of Context that comes with the
-TeX distribution. Distros tend to prefer the stable version (“current”
-in Context jargon) of those files so certain bugs encountered in the
-more bleeding edge Luaotfload can be avoided this way. A third option
-is to use \fBcontext\fP with a colon to specify a directory prefix where
-the \fITEXMF\fP is located that the files should be loaded from, e. g.
-\fBcontext:~/context/tex/texmf\-context\fP\&. This can be used when
-referencing another distribution like the Context minimals that is
-installed under a different path not indexed by kpathsea.
-.sp
-The value of \fBlog\-level\fP sets the default verbosity of messages
-printed by Luaotfload. Only messages defined with a verbosity of less
-than or equal to the supplied value will be output on the terminal.
-At a log level of five Luaotfload can be very noisy. Also, printing too
-many messages will slow down the interpreter due to line buffering
-being disabled (see \fBsetbuf\fP(3)).
-.sp
-The \fBresolver\fP setting allows choosing the font name resolution
-function: With the default value \fBcached\fP Luaotfload saves the result
-of a successful font name request to a cache file to speed up
-subsequent lookups. The alternative, \fBnormal\fP circumvents the cache
-and resolves every request individually. (Since to the restructuring of
-the font name index in Luaotfload 2.4 the performance difference
-between the cached and uncached lookups should be marginal.)
-.SH FILES
-.sp
-Luaotfload only processes the first configuration file it encounters at
-one of the search locations. The file name may be either
-\fBluaotfload.conf\fP or \fBluaotfloadrc\fP, except for the dotfile in the
-user’s home directory which is expected at \fB~/.luaotfloadrc\fP\&.
-.sp
-Configuration files are located following a series of steps. The search
-terminates as soon as a suitable file is encountered. The sequence of
-locations that Luaotfload looks at is
-.INDENT 0.0
-.IP i. 5
-The current working directory of the LuaTeX process.
-.IP ii. 5
-The subdirectory \fBluaotfload/\fP inside the XDG configuration
-tree, e. g. \fB/home/oenothea/config/luaotfload/\fP\&.
-.IP iii. 5
-The dotfile.
-.IP iv. 5
-The \fITEXMF\fP (using kpathsea).
-.UNINDENT
-.SH SEE ALSO
-.sp
-\fBluaotfload\-tool\fP(1), \fBluatex\fP(1), \fBlua\fP(1)
-.INDENT 0.0
-.IP \(bu 2
-\fBtexdoc luaotfload\fP to display the PDF manual for the \fILuaotfload\fP
-package
-.IP \(bu 2
-Luaotfload development \fI\%https://github.com/u\-fischer/luaotfload\fP
-.IP \(bu 2
-LuaLaTeX mailing list \fI\%http://tug.org/pipermail/lualatex\-dev/\fP
-.IP \(bu 2
-LuaTeX \fI\%http://luatex.org/\fP
-.IP \(bu 2
-Luaotfload on CTAN \fI\%http://ctan.org/pkg/luaotfload\fP
-.UNINDENT
-.SH REFERENCES
-.INDENT 0.0
-.IP \(bu 2
-The XDG base specification
-\fI\%http://standards.freedesktop.org/basedir\-spec/basedir\-spec\-latest.html\fP\&.
-.UNINDENT
-.SH AUTHORS
-.sp
-\fILuaotfload\fP was developed by the LuaLaTeX dev team
-(\fI\%https://github.com/lualatex/\fP). It is currently maintained by Ulrike Fischer
-and Marcel Krüger at \fI\%https://github.com/u\-fischer/luaotfload\fP
-.sp
-This manual page was written by Philipp Gesang <\fI\%phg at phi\-gamma.net\fP>.
-.SH COPYRIGHT
-GPL v2.0
-.\" Generated by docutils manpage writer.
-.
More information about the latex3-commits
mailing list