texlive[73830] Master/texmf-dist/doc/luatex/base: luatex doc update

[commits+karl at tug.org]

Revision: 73830
          https://tug.org/svn/texlive?view=revision&revision=73830
Author:   karl
Date:     2025-02-10 00:08:55 +0100 (Mon, 10 Feb 2025)
Log Message:
-----------
luatex doc update

Modified Paths:
--------------
    trunk/Master/texmf-dist/doc/luatex/base/ChangeLog
    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/ChangeLog
===================================================================
--- trunk/Master/texmf-dist/doc/luatex/base/ChangeLog	2025-02-09 23:06:52 UTC (rev 73829)
+++ trunk/Master/texmf-dist/doc/luatex/base/ChangeLog	2025-02-09 23:08:55 UTC (rev 73830)
@@ -1,3 +1,10 @@
+2025-02-09 Luigi Scarso <luigi.scarso at gmail.com>
+	* fixed shell-escape bypass (thanks to tex at maxchernoff.ca)
+	* Add token.unchecked_put_next, support setting the environment
+	  with os.spawn, permit usage of the img module in texlua mode
+	  (thanks to tex at maxchernoff.ca)
+	
+	
 2025-02-05 Luigi Scarso <luigi.scarso at gmail.com>
 	* add mathemptydisplaymode primitive, 
 	* fix nodes leak in end_graf (thanks to udifoglle at gmail.com)

Modified: trunk/Master/texmf-dist/doc/luatex/base/luatex-lua.tex
===================================================================
--- trunk/Master/texmf-dist/doc/luatex/base/luatex-lua.tex	2025-02-09 23:06:52 UTC (rev 73829)
+++ trunk/Master/texmf-dist/doc/luatex/base/luatex-lua.tex	2025-02-09 23:08:55 UTC (rev 73830)
@@ -570,6 +570,12 @@
     If the command ran ok, then the return value is the exit status of the
     command. Otherwise, it will return the two values \type {nil} and \type
     {error}.
+
+    \type {os.spawn()} takes an optional second argument, a table of key-value
+    pairs for the environment of the spawned process. Note that if you do pass
+    this table, it will be used as the \notabene {complete} environment for the
+    spawned process, so you'll likely want to start from \type {os.env} and add
+    or remove keys as needed.
 \stopitem
 
 \startitem

Modified: trunk/Master/texmf-dist/doc/luatex/base/luatex-tex.tex
===================================================================
--- trunk/Master/texmf-dist/doc/luatex/base/luatex-tex.tex	2025-02-09 23:06:52 UTC (rev 73829)
+++ trunk/Master/texmf-dist/doc/luatex/base/luatex-tex.tex	2025-02-09 23:08:55 UTC (rev 73830)
@@ -1970,6 +1970,14 @@
      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
+\NC \type{texlua_img} \NC boolean \NC
+\NC 
+     if true, allows access to the \type {img} library in \TEXLUA\ mode. If
+     false (the default), the \type {img} library is not available in \TEXLUA\
+     mode (as it was unconditionally for \LUATEX\ versions prior to 1.22.0).
+     Note that this setting is {\bf experimental} and subject to be removed at
+     any time, without notice.
+\NC \NR
 \LL
 \stoptabulate
 
@@ -2429,6 +2437,7 @@
 
 \libindex{get_next}
 \libindex{put_next}
+\libindex{unchecked_put_next}
 
 There is a (for now) experimental putter:
 
@@ -2444,7 +2453,12 @@
 \stoptyping
 
 When we scan \type {wxyz!} we get \type {yzwx!} back. The argument is either a table
-with tokens or a list of tokens. The \type {token.expand} function will trigger
+with tokens or a list of tokens. The new function \type {token.unchecked_put_next}
+has been added per request of the \LATEX\ team. It skips this error checking and
+follows a different code path. It assumes that a valid token user datum is
+passed and can crash the engine otherwise.
+
+The \type {token.expand} function will trigger
 expansion but what happens really depends on what you're doing where.
 
 \stopsubsection

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	2025-02-09 23:06:52 UTC (rev 73829)
+++ trunk/Master/texmf-dist/doc/luatex/base/luatex.tex	2025-02-09 23:08:55 UTC (rev 73830)
@@ -73,7 +73,7 @@
 \startdocument
   [manual=Lua\TeX,
    status=stable,
-   version=1.21]
+   version=1.20]
 
 \startnotmode[*export]
     \component luatex-titlepage