pdftex[946] branches/stable/doc/manual: document

[commits+karl at tug.org]

Revision: 946
          https://tug.org/svn/pdftex?view=revision&revision=946
Author:   karl
Date:     2025-01-25 18:23:55 +0100 (Sat, 25 Jan 2025)
Log Message:
-----------
document \ignoreprimitiveerror

Modified Paths:
--------------
    branches/stable/doc/manual/ChangeLog
    branches/stable/doc/manual/pdftex.tex

Modified: branches/stable/doc/manual/ChangeLog
===================================================================
--- branches/stable/doc/manual/ChangeLog	2025-01-25 08:14:37 UTC (rev 945)
+++ branches/stable/doc/manual/ChangeLog	2025-01-25 17:23:55 UTC (rev 946)
@@ -1,3 +1,7 @@
+2025-01-25  Karl Berry  <karl at freefriends.org>
+
+	* pdftex.tex (\ignoreprimitiveerror): document this.
+
 2025-01-18  Karl Berry  <karl at freefriends.org>
 
 	* pdftex.tex (\pdfximage): mention that image metadata is (now)

Modified: branches/stable/doc/manual/pdftex.tex
===================================================================
--- branches/stable/doc/manual/pdftex.tex	2025-01-25 08:14:37 UTC (rev 945)
+++ branches/stable/doc/manual/pdftex.tex	2025-01-25 17:23:55 UTC (rev 946)
@@ -3281,7 +3281,7 @@
 
 \section{Macro programming}
 
-Expansion-related commands.
+Expansion and other programming-related commands.
 
 \subsection{\cs{expanded}}
 \pdftexprimitive{\Syntax{\cs{expanded} \Something{tokens}
@@ -3307,6 +3307,30 @@
 (redefined, made \cs{undefined}, has never been primitive), it is false.
 \introduced{1.40.0}
 
+\subsection{\cs{ignoreprimitiveerror}}
+\pdftexprimitive{\Syntax{\cs{ignoreprimitiveerror} \Whatever{integer}}}
+
+If this primitive parameter is set to~1, the error\\
+\verb|! Infinite glue shrinkage found in box being split|\\
+is changed from an error to a warning, and thus the exit status is not
+changed to failure.
+
+Other values of \cs{ignoreprimitiveerror} are reserved for future use.
+
+Here is a simple plain \TeX\ example to provoke that error:
+
+\begin{verbatim}
+\ignoreprimitiveerror=1 % with this, get warning
+\setbox0=\vbox{\hrule height 1pt \vskip 0pt minus 1fill}
+\setbox1=\vsplit0 to 5pt
+\end
+\end{verbatim}
+
+This parameter is defined only when the \type{-etex} option is given,
+like the standard \ETEX\ extensions, which is the default configuration.
+
+\introduced{1.40.27}
+
 \subsection{\cs{partokencontext}}
 \pdftexprimitive{\Syntax{\cs{partokencontext} \Something{number}}}