Updated luatex.pdf for the new commandline switch --[no-]check-dvi-total-pages .

git-svn-id: svn://tug.org/texlive/trunk@69182 c570f23f-e606-0410-a88d-b1316a301751

5 files changed, 70 insertions, 2 deletions

diff --git a/Master/texmf-dist/doc/luatex/base/luatex-callbacks.tex b/Master/texmf-dist/doc/luatex/base/luatex-callbacks.tex
index 22638f759b7..a65b6e8d1f2 100644
--- a/Master/texmf-dist/doc/luatex/base/luatex-callbacks.tex
+++ b/Master/texmf-dist/doc/luatex/base/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/Master/texmf-dist/doc/luatex/base/luatex-lua.tex b/Master/texmf-dist/doc/luatex/base/luatex-lua.tex
index eefdf4425b6..ed0bc23a537 100644
--- a/Master/texmf-dist/doc/luatex/base/luatex-lua.tex
+++ b/Master/texmf-dist/doc/luatex/base/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/Master/texmf-dist/doc/luatex/base/luatex-tex.tex b/Master/texmf-dist/doc/luatex/base/luatex-tex.tex
index 4752c251576..d711b0709f8 100644
--- a/Master/texmf-dist/doc/luatex/base/luatex-tex.tex
+++ b/Master/texmf-dist/doc/luatex/base/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/Master/texmf-dist/doc/luatex/base/luatex.pdf b/Master/texmf-dist/doc/luatex/base/luatex.pdf
index cfb9e734a75..04dc1ef67cd 100644
--- a/Master/texmf-dist/doc/luatex/base/luatex.pdf
+++ b/Master/texmf-dist/doc/luatex/base/luatex.pdf
diff --git a/Master/texmf-dist/doc/luatex/base/luatex.tex b/Master/texmf-dist/doc/luatex/base/luatex.tex
index 1a3d684cea9..45aa1f5cb53 100644
--- a/Master/texmf-dist/doc/luatex/base/luatex.tex
+++ b/Master/texmf-dist/doc/luatex/base/luatex.tex
@@ -73,7 +73,7 @@
 \startdocument
   [manual=Lua\TeX,
    status=stable,
-   version=1.16]
+   version=1.17]
 
 \startnotmode[*export]
     \component luatex-titlepage