texlive[69182] Master/texmf-dist/doc/luatex/base: Updated luatex.pdf

Thu Dec 21 16:16:54 CET 2023

Revision: 69182
          https://tug.org/svn/texlive?view=revision&revision=69182
Author:   lscarso
Date:     2023-12-21 16:16:53 +0100 (Thu, 21 Dec 2023)
Log Message:
-----------
Updated luatex.pdf for the new commandline switch --[no-]check-dvi-total-pages .

Modified Paths:
--------------
    trunk/Master/texmf-dist/doc/luatex/base/luatex-callbacks.tex
    trunk/Master/texmf-dist/doc/luatex/base/luatex-lua.tex
    trunk/Master/texmf-dist/doc/luatex/base/luatex-tex.tex
    trunk/Master/texmf-dist/doc/luatex/base/luatex.pdf
    trunk/Master/texmf-dist/doc/luatex/base/luatex.tex

Modified: trunk/Master/texmf-dist/doc/luatex/base/luatex-callbacks.tex
===================================================================

--- trunk/Master/texmf-dist/doc/luatex/base/luatex-callbacks.tex	2023-12-21 15:14:00 UTC (rev 69181)
+++ trunk/Master/texmf-dist/doc/luatex/base/luatex-callbacks.tex	2023-12-21 15:16:53 UTC (rev 69182)
@@ -1157,6 +1157,36 @@
 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

Modified: trunk/Master/texmf-dist/doc/luatex/base/luatex-lua.tex
===================================================================
--- trunk/Master/texmf-dist/doc/luatex/base/luatex-lua.tex	2023-12-21 15:14:00 UTC (rev 69181)
+++ trunk/Master/texmf-dist/doc/luatex/base/luatex-lua.tex	2023-12-21 15:16:53 UTC (rev 69182)
@@ -73,6 +73,7 @@
 \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 @@
 \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 @@
 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

Modified: trunk/Master/texmf-dist/doc/luatex/base/luatex-tex.tex
===================================================================
--- trunk/Master/texmf-dist/doc/luatex/base/luatex-tex.tex	2023-12-21 15:14:00 UTC (rev 69181)
+++ trunk/Master/texmf-dist/doc/luatex/base/luatex-tex.tex	2023-12-21 15:16:53 UTC (rev 69182)
@@ -1962,6 +1962,11 @@
     {\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 @@
 
 \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}

Modified: trunk/Master/texmf-dist/doc/luatex/base/luatex.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/luatex/base/luatex.tex
===================================================================
--- trunk/Master/texmf-dist/doc/luatex/base/luatex.tex	2023-12-21 15:14:00 UTC (rev 69181)
+++ trunk/Master/texmf-dist/doc/luatex/base/luatex.tex	2023-12-21 15:16:53 UTC (rev 69182)
@@ -73,7 +73,7 @@
 \startdocument
   [manual=Lua\TeX,
    status=stable,
-   version=1.16]
+   version=1.17]
 
 \startnotmode[*export]
     \component luatex-titlepage

