[latex3-commits] [latex3/latex2e] array: cleanup docu (WIP) (e9f8fb82)

[github at latex-project.org]

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

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

commit e9f8fb82a0155742807a04e467d0971bdefbd4b7
Author: Frank Mittelbach <frank.mittelbach at latex-project.org>
Date:   Mon Dec 11 19:17:45 2023 +0100

    cleanup docu (WIP)


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

e9f8fb82a0155742807a04e467d0971bdefbd4b7
 required/tools/array.dtx    | 21 ++++++++++++++++++++-
 required/tools/tabularx.dtx | 25 ++++++++++++++++++++++---
 2 files changed, 42 insertions(+), 4 deletions(-)

diff --git a/required/tools/array.dtx b/required/tools/array.dtx
index c3101e43..be469b2c 100644
--- a/required/tools/array.dtx
+++ b/required/tools/array.dtx
@@ -34,7 +34,7 @@
 %<+package>\DeclareCurrentRelease{}{2024-06-01}
 %<+package>
 %<+package>\ProvidesPackage{array}
-%<+package>         [2023/11/28 v2.6a Tabular extension package (FMi)]
+%<+package>         [2023/12/11 v2.6a Tabular extension package (FMi)]
 %
 % \fi
 %
@@ -765,6 +765,25 @@
 % \end{itemize}
 %
 %
+% \section{Support for tagged PDF}
+%
+% With version 2.6a the package is made tagging aware, which means that
+% it will automatically produce tagged tables (necessary, for example, for
+% accessibility) if tagging is requested via \cs{DocumentMetadata}.
+%
+% More granular control, e.g., explicitly deciding which cells are
+% header cells, etc., is currently under development, but syntax for
+% this will not appear in this package. Instead it will become
+% available across all tabular-generating packages and then
+% automatically apply here as well.
+%
+% Enabling \LaTeX{} to automatically produce tagged PDF is a long-term
+% project and this is a tiny step in this puzzle. For more information
+% on the project and already available functionality, see
+% \url{https://latex-project.org/publications/indexbytopic/pdf} and
+% \url{https://github.com/latex3/tagging-project}.
+%
+%
 %
 % \changes{v2.2b}{1994/02/04}{Removed interactive prompt}
 %
diff --git a/required/tools/tabularx.dtx b/required/tools/tabularx.dtx
index 50370bb0..331f2d74 100644
--- a/required/tools/tabularx.dtx
+++ b/required/tools/tabularx.dtx
@@ -31,7 +31,7 @@
 %<driver> \ProvidesFile{tabularx.drv}
 % \fi
 %         \ProvidesFile{tabularx.dtx}
-          [2023/11/28 v2.11d `tabularx' package (DPC)]
+          [2023/12/11 v2.12a `tabularx' package (DPC)]
 % \iffalse
 %<*driver>
 \documentclass{ltxdoc}
@@ -261,6 +261,25 @@
 % This behaviour of the package can be customised slightly
 % as noted in the documentation of the code section.
 %
+% \section{Support for tagged PDF}
+%
+% With version 2.12a the package is made tagging aware, which means that
+% it will automatically produce tagged tables (necessary, for example, for
+% accessibility) if tagging is requested via \cs{DocumentMetadata}.
+%
+% More granular control, e.g., explicitly deciding which cells are
+% header cells, etc., is currently under development, but syntax for
+% this will not appear in this package. Instead it will become
+% available across all tabular-generating packages and then
+% automatically apply here as well.
+%
+% Enabling \LaTeX{} to automatically produce tagged PDF is a long-term
+% project and this is a tiny step in this puzzle. For more information
+% on the project and already available functionality, see
+% \url{https://latex-project.org/publications/indexbytopic/pdf} and
+% \url{https://github.com/latex3/tagging-project}.
+%
+%
 % \MaybeStop{}
 %
 % \section{The Macros}
@@ -508,7 +527,7 @@
     {\@spaces Table Width\@spaces Column Width\@spaces X Columns}%
 %    \end{macrocode}
 %
-%    While we do trial typesetting we stop suspend any tagging:
+%    While we do trial typesetting we suspend any tagging if that is active:
 %    \begin{macrocode}
    \SuspendTagging {tabularx}%
 %    \end{macrocode}
@@ -529,7 +548,7 @@
   \repeat
 %    \end{macrocode}
 %
-%    And now we restart it again.
+%    And here we restart it again:
 %    \begin{macrocode}
   \ResumeTagging {tabularx}%
 %    \end{macrocode}