texlive[70014] Master/texmf-dist/doc/luatex/base: Updated LuaTeX

commits+lscarso at tug.org commits+lscarso at tug.org
Tue Feb 20 19:03:53 CET 2024


Revision: 70014
          https://tug.org/svn/texlive?view=revision&revision=70014
Author:   lscarso
Date:     2024-02-20 19:03:52 +0100 (Tue, 20 Feb 2024)
Log Message:
-----------
Updated LuaTeX manual.

Modified Paths:
--------------
    trunk/Master/texmf-dist/doc/luatex/base/NEWS
    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/NEWS
===================================================================
--- trunk/Master/texmf-dist/doc/luatex/base/NEWS	2024-02-20 17:59:51 UTC (rev 70013)
+++ trunk/Master/texmf-dist/doc/luatex/base/NEWS	2024-02-20 18:03:52 UTC (rev 70014)
@@ -1,4 +1,51 @@
 ==============================================================
+LuaTeX 1.18.0 2024-02-13
+==============================================================
+
+- New kpse.in_name_ok_silent_extended and kpse.in_name_ok_silent_extended
+- New kpse.in_name_ok, kpse.in_name_ok
+- New lfs.mkdirp that make parent directories as needed
+- In kpse mode os.rename,os.remove, lfs.attributes,
+  lfs.chdir, lfs.lock_dir, lfs.dir, lfs.link,
+  lfs.mkdir, lfs.mkdirp, lfs.rmdir, lfs.symlinkattributes, lfs.touch 
+  are now validated with kpse.in_name_ok_silent_extended  *and* kpse.out_name_ok_silent_extended;
+  lfs.attributes, lfs.dir and lfs.symlinkattributes are now validated only against kpse.in_name_ok_silent_extended
+- With --safer, all debug functions except traceback are nil 
+- New commandline switch --[no-]check-dvi-total-pages  exit when DVI exceeds 65535 pages (default: check).
+  This breaks backward compatibility.
+- Some fixes, among others:  
+  * setgentounicode has a glyph_unicode_tree not NULL (thanks M. Chernoff)
+  * Character index within the  limits in defining a Type 3 font (H.Hagen). Thanks M. Chernoff.
+  * Fix for dubious cff fonts (not following the 1000 unit recommendation) (Hans Hagen).
+  * TEXMF_OUTPUT_DIRECTORY and output_directory have the same value, having output_directory
+    the priority on TEXMF_OUTPUT_DIRECTORY.
+
+
+==============================================================
+LuaTeX 1.17.0 2023-04-29
+==============================================================
+ 
+- A breaking backward compatibility change: by default the socket 
+  library is not enabled . 
+  The new option --socket enable the socket library as 
+  before, as also --shell-escape (without --shell-restricted);
+  --nosocket, --no-socket , --safer disabled the library, and 
+  they have the priority in case of conflicting options.
+  The mime library is always available; socket.sleep
+  and socket.gettime are duplicated as os.socketsleep
+  and os.socketgettime, both always available.
+  The new os.kpsepopen replace io.popopen in kpse mode
+  (i.e. when kpse_init is not zero) as it was before
+  but the permission now cannot be changed anymore with 
+  kpse.check_permission . 
+  The function os.kpsepopen follows the same restrictions
+  as io.popen .
+  Thanks to Max Chernoff for debugging.
+
+ 
+
+
+==============================================================
 LuaTeX 1.16.0 2023-02-19
 ==============================================================
 

Modified: trunk/Master/texmf-dist/doc/luatex/base/luatex-lua.tex
===================================================================
--- trunk/Master/texmf-dist/doc/luatex/base/luatex-lua.tex	2024-02-20 17:59:51 UTC (rev 70013)
+++ trunk/Master/texmf-dist/doc/luatex/base/luatex-lua.tex	2024-02-20 18:03:52 UTC (rev 70014)
@@ -86,6 +86,7 @@
 \NC \type{--kpathsea-debug=NUMBER}      \NC set path searching debugging flags according to the bits of
                                            \type {NUMBER} \NC \NR
 \NC \type{--lua=FILE}                   \NC load and execute a \LUA\ initialization script \NC\NR
+\NC \type{--luadebug}                   \NC enable the \type{debug} library\NC\NR
 \NC \type{--[no-]mktex=FMT}             \NC disable/enable \type {mktexFMT} generation with \type {FMT} is
                                             \type {tex} or \type {tfm} \NC \NR
 \NC \type{--nosocket}                   \NC disable the \LUA\ socket library \NC\NR
@@ -137,7 +138,11 @@
 attaching the proper extension (\type {log}, \type {pdf}, etc.) to the found
 \prm {jobname}. These files are created in the directory pointed to by \type
 {--output-directory}, or in the current directory, if that switch is not present.
+If \type{--output-directory} is not empty, its value it's copied to the
+\type{TEXMF_OUTPUT_DIRECTORY} env. variable; if it's empty, the value of
+\type{TEXMF_OUTPUT_DIRECTORY} is the value of the output directory.
 
+
 Without the \type {--lua} option, command line processing works like it does in
 any other \WEBC|-|based typesetting engine, except that \LUATEX\ has a few extra
 switches and lacks some others. Also, if the \type {--lua} option is present,
@@ -165,8 +170,8 @@
 
 \startitem
     Then it checks the various safety switches. You can use those to disable some
-    \LUA\ commands that can easily be abused by a malicious document. At the
-    moment, \type {--safer} \type {nil}s the following functions:
+    \LUA\ commands that can easily be abused by a malicious document. Currently
+    \type {--safer} nils the following functions:
 
     \blank
 
@@ -177,8 +182,8 @@
                             \type {spawn} \type {setenv}
                             \type {rename} \type {remove} \type {tmpdir} \NC \NR
         \NC \type {io}  \NC \type {popen} \type {output} \type {tmpfile} \NC \NR
-        \NC \type {lfs} \NC \type {rmdir} \type {mkdir} \type {chdir} \type {lock}
-                            \type {touch} \NC \NR
+        \NC \type {lfs} \NC \type {rmdir} \type {mkdir} \type {mkdirp} \type {chdir}
+                            \type {lock}  \type {touch} \NC \NR
         \LL
     \stoptabulate
 
@@ -189,6 +194,23 @@
 
     Finally, it disables the \type {socket} library unconditionally (but not the
     \type {mime} library which is always available).
+
+    From version 1.18.0  and if  \KPATHSEA\ is used, with the exception of \type{debug.traceback}
+    the \type{debug} library is not enabled by default; it can
+    be enabled with the \type{--luadebug} switch. The \type{debug} library
+    is always enabled in shell-escape mode.
+
+   Also from version 1.18.0 and if  \KPATHSEA\ is used, the functions
+   \type{os.rename},\type{os.remove}, \type{lfs.attributes}, \type{lfs.chdir},
+   \type{lfs.lock_dir}, \type{lfs.dir}, \type{lfs.link}, \type{lfs.mkdir}, \type{lfs.mkdirp},
+   \type{lfs.rmdir}, \type{lfs.symlinkattributes}, \type{lfs.touch} 
+   return \type{true} if both \type{kpse.in_name_ok_silent_extended} and
+   \type{kpse.out_name_ok_silent_extended} validate the pathname;
+   \type{lfs.attributes}, \type{lfs.dir} and  \type{lfs.symlinkattributes} are validated
+   only against \type{kpse.in_name_ok_silent_extended}.
+
+
+
 \stopitem
 
 \startitem
@@ -237,7 +259,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 becom1es opened (note that \TEX\ does
+to the log file when (and if) it eventually becomes 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
@@ -363,7 +385,8 @@
 {lfs.isdir} and \type {lfs.isfile} were speedy and better variants of what could
 be done with \type {lfs.attributes}. The additional function \type
 {lfs.shortname} takes a file name and returns its short name on \type {win32}
-platforms. Finally, for non|-|\type {win32} platforms only, we provided \type
+platforms; \type{lfs.mkdirp} is like \type{lfs.mkdir} but make parent directories as needed.
+Finally, for non|-|\type {win32} platforms only, we provided \type
 {lfs.readlink} that takes an existing symbolic link as argument and returns its
 name. However, the \type {lfs} library evolved so we have dropped these in favour of
 pure \LUA\ variants. The \type {shortname} helper is obsolete and now just

Modified: trunk/Master/texmf-dist/doc/luatex/base/luatex-tex.tex
===================================================================
--- trunk/Master/texmf-dist/doc/luatex/base/luatex-tex.tex	2024-02-20 17:59:51 UTC (rev 70013)
+++ trunk/Master/texmf-dist/doc/luatex/base/luatex-tex.tex	2024-02-20 18:03:52 UTC (rev 70014)
@@ -204,6 +204,8 @@
 \NC \type{save_size}          \NC save stack size \NC \NR
 \NC \type{shell_escape}       \NC \type {0} means disabled, \type {1} means anything is permitted, and \type {2} is restricted \NC \NR
 \NC \type{safer_option}       \NC \type {1} means safer is enforced \NC \NR
+\NC \type{luadebug_option}    \NC true if the \type{debug} library is enabled at command line \NC\NR
+\NC \type{output_directory}   \NC the value of the output directory \NC \NR
 \NC \type{kpse_used}          \NC \type {1} means that kpse is used \NC \NR
 \NC \type{stack_size}         \NC input stack size \NC \NR
 \NC \type{str_ptr}            \NC number of strings \NC \NR
@@ -2827,28 +2829,60 @@
 
 \libindex{in_name_ok}
 
-Return true if \type{fname} is acceptable to open for reading. 
+Returns true if \type{fname} is acceptable to open for reading, otherwise false and 
+write a message to standard error. 
 
 \startfunctioncall
-<boolean> r = kpse_in_name_ok(<string> fname)
+<boolean> r = kpse.in_name_ok(<string> fname)
 \stopfunctioncall
 
+\startsubsection[title={\type {in_name_ok_silent_extended}}]
+
+\libindex{in_name_ok_silent_extended}
+
+\startfunctioncall
+<boolean> r = kpse.in_name_ok_silent_extended(<string> fname)
+\stopfunctioncall
+
+Returns true if \type{fname} is acceptable to open for reading;
+the values of \type{TEXMFVAR} and \type{TEXMFSYSVAR} are also
+checked for absolute filenames. Returns false otherwise but it doesn't write
+a message to standard error.
+
 \stopsubsection
 
+
 \startsubsection[title={\type {out_name_ok}}]
 
 \libindex{out_name_ok}
 
-Return true if \type{fname} is acceptable to open for writing. 
+Returns true if \type{fname} is acceptable to open for writing. 
 
 \startfunctioncall
-<boolean> r = kpse_out_name_ok(<string> fname)
+<boolean> r = kpse.out_name_ok(<string> fname)
 \stopfunctioncall
 
 \stopsubsection
 
 
+\startsubsection[title={\type {out_name_ok_silent_extended}}]
 
+\libindex{out_name_ok_silent_extended}
+
+\startfunctioncall
+<boolean> r = kpse.out_name_ok_silent_extended(<string> fname)
+\stopfunctioncall
+
+Returns true if \type{fname} is acceptable to open for writing;
+the values of \type{TEXMFVAR} and \type{TEXMFSYSVAR} are also
+checked for absolute filenames. Returns false otherwise but it doesn't write
+a message to standard error.
+
+\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	2024-02-20 17:59:51 UTC (rev 70013)
+++ trunk/Master/texmf-dist/doc/luatex/base/luatex.tex	2024-02-20 18:03:52 UTC (rev 70014)
@@ -73,7 +73,7 @@
 \startdocument
   [manual=Lua\TeX,
    status=stable,
-   version=1.17]
+   version=1.18]
 
 \startnotmode[*export]
     \component luatex-titlepage



More information about the tex-live-commits mailing list.