From 28b035d1f87953021845b4ca5341dab7c5642642 Mon Sep 17 00:00:00 2001 From: Luigi Scarso Date: Thu, 21 Dec 2023 15:16:53 +0000 Subject: 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 --- .../doc/luatex/base/luatex-callbacks.tex | 30 ++++++++++++++++++++ Master/texmf-dist/doc/luatex/base/luatex-lua.tex | 9 +++++- Master/texmf-dist/doc/luatex/base/luatex-tex.tex | 31 +++++++++++++++++++++ Master/texmf-dist/doc/luatex/base/luatex.pdf | Bin 1780325 -> 1788528 bytes Master/texmf-dist/doc/luatex/base/luatex.tex | 2 +- 5 files changed, 70 insertions(+), 2 deletions(-) (limited to 'Master/texmf-dist/doc') 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( mode, id, char) + if mode == 1 then + -- preroll + return + elseif mode == 2 then + -- write out the glyph contents + return stream, width + elseif mode == 3 then + -- the overall font scale + return 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 + r = kpse_in_name_ok( 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 + r = kpse_out_name_ok( 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 Binary files a/Master/texmf-dist/doc/luatex/base/luatex.pdf and b/Master/texmf-dist/doc/luatex/base/luatex.pdf differ 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 -- cgit v1.2.3