summaryrefslogtreecommitdiff
path: root/systems/doc/luatex
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2023-12-22 03:02:07 +0000
committerNorbert Preining <norbert@preining.info>2023-12-22 03:02:07 +0000
commit49150e453072cff2c2ecaba1d1a55d8333d191d3 (patch)
treebd7e16e55839f6baf784320bb751d2892bcb88cc /systems/doc/luatex
parent838a56d5436e7e7e526d6dffe2461cf050643168 (diff)
CTAN sync 202312220302
Diffstat (limited to 'systems/doc/luatex')
-rw-r--r--systems/doc/luatex/luatex-callbacks.tex30
-rw-r--r--systems/doc/luatex/luatex-lua.tex9
-rw-r--r--systems/doc/luatex/luatex-tex.tex31
-rw-r--r--systems/doc/luatex/luatex.pdfbin1780325 -> 1788528 bytes
-rw-r--r--systems/doc/luatex/luatex.tex2
5 files changed, 70 insertions, 2 deletions
diff --git a/systems/doc/luatex/luatex-callbacks.tex b/systems/doc/luatex/luatex-callbacks.tex
index 22638f759b..a65b6e8d1f 100644
--- a/systems/doc/luatex/luatex-callbacks.tex
+++ b/systems/doc/luatex/luatex-callbacks.tex
@@ -1157,6 +1157,36 @@ returned string is used. By default the \UTF\ representation is shown which is
not always that useful, especially when there is no real representation. Keep in
mind that setting this callback can change the log in an incompatible way.
+\subsection{\cbk {provide_charproc_data}}
+
+\topicindex{callbacks+fonts}
+
+The \type {provide_charproc_data} callback is triggered when the backend is
+writing out a user-defined Type~3 font:
+
+\startfunctioncall
+function(<number> mode, <number> id, <number> char)
+ if mode == 1 then
+ -- preroll
+ return
+ elseif mode == 2 then
+ -- write out the glyph contents
+ return <number> stream, <number> width
+ elseif mode == 3 then
+ -- the overall font scale
+ return <number> scale
+ end
+end
+\stopfunctioncall
+
+To make a user-defined Type~3 font, you need to set \type {encodingbytes = 0}
+and \type {psname = "none"} at the top-level when defining the font. From the
+\type {glyph_not_found} callback, you should return the overall font scale
+(conventionally 0.001) in mode~3, and the index of a \PDF\ stream (where the
+first operator is either \type {d0} or \type {d1}) and the width of the glyph
+(in sp's) in mode~2. You can generally ignore mode~1.
+
+
\stopsection
\stopchapter
diff --git a/systems/doc/luatex/luatex-lua.tex b/systems/doc/luatex/luatex-lua.tex
index eefdf4425b..ed0bc23a53 100644
--- a/systems/doc/luatex/luatex-lua.tex
+++ b/systems/doc/luatex/luatex-lua.tex
@@ -73,6 +73,7 @@ consequence. The following command|-|line options are understood:
\NC \type{--credits} \NC display credits and exit \NC \NR
\NC \type{--debug-format} \NC enable format debugging \NC \NR
\NC \type{--draftmode} \NC switch on draft mode i.e.\ generate no output in \PDF\ mode \NC \NR
+\NC \type{--[no-]check-dvi-total-pages} \NC exit when DVI exceeds 65535 pages (default: check) \NC \NR
\NC \type{--[no-]file-line-error} \NC disable/enable \type {file:line:error} style messages \NC \NR
\NC \type{--[no-]file-line-error-style} \NC aliases of \type {--[no-]file-line-error} \NC \NR
\NC \type{--fmt=FORMAT} \NC load the format file \type {FORMAT} \NC\NR
@@ -236,7 +237,7 @@ deal with typesetting, like \type {tex}, \type {token}, \type {node} and
\type {pdf}, are off|-|limits during the execution of the startup file (they
are \type {nil}'d). Special care is taken that \type {texio.write} and \type
{texio.write_nl} function properly, so that you can at least report your actions
-to the log file when (and if) it eventually becomes opened (note that \TEX\ does
+to the log file when (and if) it eventually becom1es opened (note that \TEX\ does
not even know its \prm {jobname} yet at this point).
Everything you do in the \LUA\ initialization script will remain visible during
@@ -263,6 +264,12 @@ finished: in order to initialize the built|-|in \KPATHSEA\ library properly,
check \type {--progname}, or \type {--ini} and \type {--fmt}, if \type
{--progname} is missing.
+From version 1.17.1, in \DVI\ mode the new commandline switch \type {--check-dvi-total-pages},
+enabled by default, checks that the total number of pages does not
+exceeds 65535, and in case the run abort. This breaks the compatibility with \PDFTEX\
+where, as in \TEX, when the total number of pages is greater than 65535 the file will lie.
+The previous behaviour can be restored with \type {--[no-]check-dvi-total-pages}.
+
\stopsubsection
\stopsection
diff --git a/systems/doc/luatex/luatex-tex.tex b/systems/doc/luatex/luatex-tex.tex
index 4752c25157..d711b0709f 100644
--- a/systems/doc/luatex/luatex-tex.tex
+++ b/systems/doc/luatex/luatex-tex.tex
@@ -1962,6 +1962,11 @@ the executable after loading and executing the startup file.
{\tracingmacros} is set; levels above this value will be clipped with
the level shown up front
\NC \NR
+\NC \type{check_dvi_total_pages} \NC boolean \NC
+\NC
+ in \DVI\ output mode, if true abort run when the number of pages exceeds 65535.
+ This is the default behaviour. If false, the run goes on as is in \TEX.
+\NC \NR
\LL
\stoptabulate
@@ -2818,6 +2823,32 @@ Like kpsewhich's \type {-expand-braces}:
\stopsubsection
+\startsubsection[title={\type {in_name_ok}}]
+
+\libindex{in_name_ok}
+
+Return true if \type{fname} is acceptable to open for reading.
+
+\startfunctioncall
+<boolean> r = kpse_in_name_ok(<string> fname)
+\stopfunctioncall
+
+\stopsubsection
+
+\startsubsection[title={\type {out_name_ok}}]
+
+\libindex{out_name_ok}
+
+Return true if \type{fname} is acceptable to open for writing.
+
+\startfunctioncall
+<boolean> r = kpse_out_name_ok(<string> fname)
+\stopfunctioncall
+
+\stopsubsection
+
+
+
\startsubsection[title={\type {show_path}}]
\libindex{show_path}
diff --git a/systems/doc/luatex/luatex.pdf b/systems/doc/luatex/luatex.pdf
index cfb9e734a7..04dc1ef67c 100644
--- a/systems/doc/luatex/luatex.pdf
+++ b/systems/doc/luatex/luatex.pdf
Binary files differ
diff --git a/systems/doc/luatex/luatex.tex b/systems/doc/luatex/luatex.tex
index 1a3d684cea..45aa1f5cb5 100644
--- a/systems/doc/luatex/luatex.tex
+++ b/systems/doc/luatex/luatex.tex
@@ -73,7 +73,7 @@
\startdocument
[manual=Lua\TeX,
status=stable,
- version=1.16]
+ version=1.17]
\startnotmode[*export]
\component luatex-titlepage