[latex3-commits] [latex3/latex2e] array: docu changes (fail table-14-pbox) (2184096b)

github at latex-project.org github at latex-project.org
Mon Dec 11 21:34:30 CET 2023


Repository : https://github.com/latex3/latex2e
On branch  : array
Link       : https://github.com/latex3/latex2e/commit/2184096b153e41bb43d26805d4b9d1ecec359423

>---------------------------------------------------------------

commit 2184096b153e41bb43d26805d4b9d1ecec359423
Author: Frank Mittelbach <frank.mittelbach at latex-project.org>
Date:   Mon Dec 11 21:34:30 2023 +0100

    docu changes (fail table-14-pbox)


>---------------------------------------------------------------

2184096b153e41bb43d26805d4b9d1ecec359423
 required/tools/array.dtx    | 45 +++++++++++++++++++++++++++++----------------
 required/tools/changes.txt  |  6 ++++++
 required/tools/tabularx.dtx | 13 ++++++++++++-
 3 files changed, 47 insertions(+), 17 deletions(-)

diff --git a/required/tools/array.dtx b/required/tools/array.dtx
index be469b2c..ff1a0634 100644
--- a/required/tools/array.dtx
+++ b/required/tools/array.dtx
@@ -817,7 +817,14 @@
 % \texttt{docstrip} program.
 %    \begin{macrocode}
 %<*driver>
-\NeedsTeXFormat{LaTeX2e}[1995/12/01]
+\NeedsTeXFormat{LaTeX2e}[2024/06/01]
+%    \end{macrocode}
+%
+%    We switched from \cls{ltxdoc} to \cls{l3doc} to get support for
+%    code written in the L3 programming layer. The first is that we
+%    are currently missing \cs{MaintainedByLaTeXTeam}, so we have to
+%    provide that for now. 
+%    \begin{macrocode}
 \documentclass{l3doc}
 
 % currently missing in l3doc
@@ -890,10 +897,10 @@ Bug reports can be opened (category \texttt{#1}) at\\%
 % cells (or group of cells) from the outside, e.g., \enquote{rows 1,
 % 2, and 10 are header rows} (syntax to be decided).
 %
-% This code is already written with L3 programming layer conventions
-% while more of the legay code is still as it is. This make the code
+% This new code is already written with L3 programming layer conventions
+% while most of the legay code is still as it was before. This make the code
 % currently somewhat clattered, unfortunately. Eventually this will all move to L3
-% programming layer.
+% programming layer but this will take time.
 %
 %
 %    \begin{macrocode}
@@ -1070,7 +1077,7 @@ Bug reports can be opened (category \texttt{#1}) at\\%
  \ifnum \@lastchclass=6 \@ne \@chnum \@ne \else
   \ifnum \@lastchclass=7 5 \else
    \ifnum \@lastchclass=8 \tw@ \else
-    \ifnum \@lastchclass=9 3
+    \ifnum \@lastchclass=9 \thr@@
 %    \end{macrocode}
 %    Otherwise we will assume that the \textsf{token} belongs to the
 %    class $0$
@@ -1121,7 +1128,7 @@ Bug reports can be opened (category \texttt{#1}) at\\%
 %    \begin{macrocode}
   10
   \@chnum
-  \if \@nextchar m3 \else
+  \if \@nextchar m\thr@@ \else
    \if \@nextchar p4 \else
     \if \@nextchar b5 \else
 %    \end{macrocode}
@@ -1366,6 +1373,9 @@ Bug reports can be opened (category \texttt{#1}) at\\%
 \def\insert at column{%
 %    \end{macrocode}
 %
+%    For tagging we insert as special socket, that adds the necessary
+%    PDF tag at the beginning of the cell if tagging is enabled.
+% \changes{v2.6a}{2023/12/11}{Support for tagged PDF}
 %    \begin{macrocode}
   \UseTaggingSocket{tblcell/begin}%
 %    \end{macrocode}
@@ -1399,6 +1409,9 @@ Bug reports can be opened (category \texttt{#1}) at\\%
    \the at toks \the \count@ \relax
 %    \end{macrocode}
 %
+%    And another socket for tagging that adds the necessary closing tag
+%    if enabled.
+% \changes{v2.6a}{2023/12/11}{Support for tagged PDF}
 %    \begin{macrocode}
    \UseTaggingSocket{tblcell/end}%
 }
@@ -1409,9 +1422,10 @@ Bug reports can be opened (category \texttt{#1}) at\\%
 %
 %  \begin{macro}{\insert at pcolumn}
 %    Handling pcolumn-cells needs slightly different handling when
-%    doing tagging.  Rather than changing the  plugs in
+%    doing tagging.  Rather than changing the plugs in
 %    \cs{insert at column} back and forth, we simply use a different
 %    version of \cs{insert at column} that has its own sockets.
+% \changes{v2.6a}{2023/12/11}{Support for tagged PDF}
 %    \begin{macrocode}
 \def\insert at pcolumn{%
    \UseTaggingSocket{tblpcell/begin}%
@@ -1442,6 +1456,7 @@ Bug reports can be opened (category \texttt{#1}) at\\%
 %    \end{macrocode}
 %    If we are after the first column we have to insert a \verb=&= and
 %    also update the cell data.
+% \changes{v2.6a}{2023/12/11}{Support for tagged PDF}
 %    \begin{macrocode}
     \edef\@preamble{\@preamble &
       \noexpand\tbl_update_cell_data: }
@@ -1449,9 +1464,7 @@ Bug reports can be opened (category \texttt{#1}) at\\%
 }
 %    \end{macrocode}
 % \end{macro}
-
-
-
+%
 %
 %
 % \begin{macro}{\@acol}
@@ -1605,7 +1618,7 @@ Bug reports can be opened (category \texttt{#1}) at\\%
 %    \texttt{r}, \texttt{p},\texttt{m} or \texttt{b}. We report an
 %    error and ignore the declaration given by ={..}=.
 %    \begin{macrocode}
-%   \@preamerr 3 \or
+%   \@preamerr \thr@@@@ \or
 %    \end{macrocode}
 %    If =\@lastchclass= is $4$ the user preamble has been empty.
 %    To continue, we insert a =#= in the preamble.
@@ -1911,8 +1924,8 @@ Bug reports can be opened (category \texttt{#1}) at\\%
 %    So the declarations defined by the first  =>{...}=
 %    are ignored.
 %    \begin{macrocode}
-%\def\@classix{\ifnum \@lastchclass = 3~
-%       \@preamerr 3 \fi
+%\def\@classix{\ifnum \@lastchclass = \thr@@@@
+%       \@preamerr \thr@@@@ \fi
 %    \end{macrocode}
 %    Furthermore, we call up =\@class10= because afterwards always a
 %    new column is started by \texttt{c}, \texttt{l}, \texttt{r},
@@ -1964,14 +1977,14 @@ Bug reports can be opened (category \texttt{#1}) at\\%
 %    We only check if the last \textsf{token} was of class $3$ which is
 %    forbidden.
 %    \begin{macrocode}
-\def\@classvii{\ifnum \@lastchclass = 3
+\def\@classvii{\ifnum \@lastchclass = \thr@@@@
 %    \end{macrocode}
 %    If this is true we output an error message and
 %    ignore the declarations stored
 %    by the last  =>{...}=, because these are overwritten
 %    by the argument of \texttt{@}.
 %    \begin{macrocode}
-   \@preamerr 3 \fi}
+   \@preamerr \thr@@@@ \fi}
 %    \end{macrocode}
 % \end{macro}
 %
@@ -3147,7 +3160,7 @@ Bug reports can be opened (category \texttt{#1}) at\\%
    \@acol \or
    \or
    \@acol \or
-   \@preamerr 3 \or
+   \@preamerr \thr@@@@ \or
    \@preamerr \tw@ \@addtopreamble\@sharp \or
    \or
    \else  \@preamerr \@ne \fi
diff --git a/required/tools/changes.txt b/required/tools/changes.txt
index 065f2453..15d66157 100644
--- a/required/tools/changes.txt
+++ b/required/tools/changes.txt
@@ -5,6 +5,12 @@ completeness or accuracy and it contains some references to files that
 are not part of the distribution.
 =======================================================================
 
+2023-12-11  Frank Mittelbach  <Frank.Mittelbach at latex-project.org>
+
+	* tabularx.dtx (section{The Macros}):
+	Require newer LaTeX kernel (that supports tagging)
+	Suspend any tagging while doing trial typesetting
+
 2023-11-10  Frank Mittelbach  <Frank.Mittelbach at latex-project.org>
 
 	* multicol.dtx (subsection{Maintaining the mark registers}]):
diff --git a/required/tools/tabularx.dtx b/required/tools/tabularx.dtx
index 331f2d74..eea2986c 100644
--- a/required/tools/tabularx.dtx
+++ b/required/tools/tabularx.dtx
@@ -288,6 +288,14 @@
 %<*package>
 %    \end{macrocode}
 %
+%    We only need two changes for tagging support, but they require
+%    that a recent \LaTeX{} kernel is used (which should be no problem
+%    if \texttt{tools} is distributed in parallel with the kernel.
+% \changes{v2.12a}{2023/12/11}{Require newer LaTeX kernel}
+%    \begin{macrocode}
+\NeedsTeXFormat{LaTeX2e}[2024/06/01]
+%    \end{macrocode}
+%
 % \changes{v2.00}{1994/02/07}
 %    {New Option Handling}
 %    \begin{macrocode}
@@ -527,7 +535,10 @@
     {\@spaces Table Width\@spaces Column Width\@spaces X Columns}%
 %    \end{macrocode}
 %
-%    While we do trial typesetting we suspend any tagging if that is active:
+%    While we do trial typesetting we suspend any tagging if that is
+%    active:
+% \changes{v2.12a}{2023/12/11}
+%    {Suspend any tagging while doing trial typesetting}
 %    \begin{macrocode}
    \SuspendTagging {tabularx}%
 %    \end{macrocode}





More information about the latex3-commits mailing list.