summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2023-08-20 19:54:36 +0000
committerKarl Berry <karl@freefriends.org>2023-08-20 19:54:36 +0000
commit007a7353b86aae0598b34630a10ee766d514be9d (patch)
treef42d2668db86a6e7953d4098fb8cc9c52b4c4d34 /Master/texmf-dist/doc/man
parentcfc28e1384ddc5bcce439c263230f1fbb4a32a92 (diff)
luaotfload (20aug23)
git-svn-id: svn://tug.org/texlive/trunk@67995 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/man')
-rw-r--r--Master/texmf-dist/doc/man/man1/luaotfload-tool.12
-rw-r--r--Master/texmf-dist/doc/man/man1/luaotfload-tool.man1.pdfbin43841 -> 44095 bytes
-rw-r--r--Master/texmf-dist/doc/man/man5/luaotfload.conf.538
-rw-r--r--Master/texmf-dist/doc/man/man5/luaotfload.conf.man5.pdfbin44804 -> 47494 bytes
4 files changed, 37 insertions, 3 deletions
diff --git a/Master/texmf-dist/doc/man/man1/luaotfload-tool.1 b/Master/texmf-dist/doc/man/man1/luaotfload-tool.1
index bd0617503a9..58b91221092 100644
--- a/Master/texmf-dist/doc/man/man1/luaotfload-tool.1
+++ b/Master/texmf-dist/doc/man/man1/luaotfload-tool.1
@@ -1,6 +1,6 @@
.\" Man page generated from reStructuredText.
.
-.TH LUAOTFLOAD-TOOL 1 "2022-10-03" "3.23" "text processing"
+.TH LUAOTFLOAD-TOOL 1 "2023-08-19" "3.24" "text processing"
.SH NAME
luaotfload-tool \- generate and query the Luaotfload font names database
.
diff --git a/Master/texmf-dist/doc/man/man1/luaotfload-tool.man1.pdf b/Master/texmf-dist/doc/man/man1/luaotfload-tool.man1.pdf
index 1d905d931f8..fcc98312beb 100644
--- a/Master/texmf-dist/doc/man/man1/luaotfload-tool.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/luaotfload-tool.man1.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/man/man5/luaotfload.conf.5 b/Master/texmf-dist/doc/man/man5/luaotfload.conf.5
index 7617508bc32..56160f89fe5 100644
--- a/Master/texmf-dist/doc/man/man5/luaotfload.conf.5
+++ b/Master/texmf-dist/doc/man/man5/luaotfload.conf.5
@@ -1,6 +1,6 @@
.\" Man page generated from reStructuredText.
.
-.TH LUAOTFLOAD.CONF 5 "2022-10-03" "3.23" "text processing"
+.TH LUAOTFLOAD.CONF 5 "2023-08-19" "3.24" "text processing"
.SH NAME
luaotfload.conf \- Luaotfload configuration file
.
@@ -216,6 +216,14 @@ T} T{
T}
_
T{
+location\-precedence
+T} T{
+s
+T} T{
+\fB"system,texmf,local\fP
+T}
+_
+T{
max\-fonts
T} T{
n
@@ -287,6 +295,12 @@ It corresponds loosely to the \fB\-\-formats\fP option to
list does not contain any useful identifiers, the default list
\fB"otf,ttf,ttc"\fP will be used.
.sp
+The variable \fBlocation\-precedence\fP selects where and in which order
+luaotfload searches for fonts. Fonts in earlier locations are preferred.
+The three supported locations are \fBsystem\fP for system specific font
+directories, \fBtexmf\fP for fonts which are part of the TeX{} distribution
+and \fBlocal\fP for local fonts.
+.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
@@ -296,7 +310,8 @@ 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.
+the document is built. Setting \fBscan_local\fP to \fBfalse\fP is the same
+as removing \fBlocal\fP from \fBlocation\-precedence\fP\&.
.sp
The \fBskip\-read\fP flag is only useful for debugging: It makes
Luaotfload skip reading fonts. The font information for rebuilding the
@@ -515,6 +530,14 @@ T} T{
\fB"default"\fP
T}
_
+T{
+default_dvi_driver
+T} T{
+s
+T} T{
+\fB"dvisvgm"\fP
+T}
+_
.TE
.sp
Unqualified font lookups are treated with the flexible “anonymous”
@@ -588,6 +611,17 @@ 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.)
+.sp
+When luaotfload is used in \fBDVI\fP mode, the \fBdefault_dvi_driver\fP option
+determines how OpenType fonts are represented in the DVI output. In most
+cases the default value \fBdvisvgm\fP should be set, it uses a format
+supported by multiple backends including \fBdvipdfmx\fP and \fBdvisvgm\fP
+which uses GIDs to identify characters.
+Setting this to \fBxdvipsk\fP uses an unstable internal format instead
+which will change depending on the luaotfload, engine, or font version.
+No one should rely on the mapping between DVI character codes and font glyphs
+in this mode unless they tightly control all involved versions and are deeply
+familiar with the implementation.
.SH FILES
.sp
Luaotfload only processes the first configuration file it encounters at
diff --git a/Master/texmf-dist/doc/man/man5/luaotfload.conf.man5.pdf b/Master/texmf-dist/doc/man/man5/luaotfload.conf.man5.pdf
index bb90c17a3a7..a00518e3af7 100644
--- a/Master/texmf-dist/doc/man/man5/luaotfload.conf.man5.pdf
+++ b/Master/texmf-dist/doc/man/man5/luaotfload.conf.man5.pdf
Binary files differ