[latex3-commits] [latex3/latex2e] tagging705-float: caption sockets (6a52a8b9)

[github at latex-project.org]

Repository : https://github.com/latex3/latex2e
On branch  : tagging705-float
Link       : https://github.com/latex3/latex2e/commit/6a52a8b9cad367507fb0dbc76b3ac6766688ec4c

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

commit 6a52a8b9cad367507fb0dbc76b3ac6766688ec4c
Author: Ulrike Fischer <fischer at troubleshooting-tex.de>
Date:   Tue Sep 17 23:59:03 2024 +0200

    caption sockets


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

6a52a8b9cad367507fb0dbc76b3ac6766688ec4c
 base/lttagging.dtx                     | 31 ++++++++++++++++++++++++++++++-
 required/latex-lab/latex-lab-float.dtx |  4 +++-
 2 files changed, 33 insertions(+), 2 deletions(-)

diff --git a/base/lttagging.dtx b/base/lttagging.dtx
index 2b4d2b26..80780e9c 100644
--- a/base/lttagging.dtx
+++ b/base/lttagging.dtx
@@ -33,7 +33,7 @@
 %<*driver>
 % \fi
 \ProvidesFile{lttagging.dtx}
-             [2024/09/13 v1.0h LaTeX Kernel (tagging support)]
+             [2024/09/17 v1.0h LaTeX Kernel (tagging support)]
 % \iffalse
 \documentclass{l3doc}
 \GetFileInfo{lttagging.dtx}
@@ -462,6 +462,35 @@
 %    \end{macrocode}
 % \end{socketdecl}
 %
+% 
+% \begin{socketdecl}{tagsupport/caption/begin,
+%                    tagsupport/caption/end}
+%  These sockets are used in \cs{@makecaption}.
+%  They open and close the \texttt{Caption} structure.
+%  Their default plugs assume that they are used in 
+%  vmode. The argument of the begin socket is
+%  the structure number of the parent float. If it is
+%  empty the current structure number is used. 
+%    \begin{macrocode}
+\NewSocket{tagsupport/caption/begin}{1}
+\NewSocket{tagsupport/caption/end}{0}
+%    \end{macrocode}
+% \end{socketdecl}
+% 
+% \begin{socketdecl}{tagsupport/caption/label/begin,
+%                    tagsupport/caption/label/end}
+%  These sockets are used in \cs{@makecaption} around the
+%  label. Their default plugs ensure that 
+%  the label is outside the paragraph and that 
+%  the rest of the caption uses flattened para mode. If the
+%  caption is not in a hbox, the \texttt{para/begin} 
+%  socket should follow to properly start the paragraph. 
+%    \begin{macrocode}
+\NewSocket{tagsupport/caption/label/begin}{0}
+\NewSocket{tagsupport/caption/label/end}{0} 
+%    \end{macrocode}
+% \end{socketdecl}
+% 
 % \section{For lttab.dtx parked here for now}
 %
 %    
diff --git a/required/latex-lab/latex-lab-float.dtx b/required/latex-lab/latex-lab-float.dtx
index e5aaf38e..aff15d4c 100644
--- a/required/latex-lab/latex-lab-float.dtx
+++ b/required/latex-lab/latex-lab-float.dtx
@@ -552,8 +552,10 @@
  }
 %    \end{macrocode}
 %
-% This socket is for formatting the label.
 % \begin{socketdecl}{caption/label}
+% This socket is for formatting the label. The argument is 
+% the label text. The default plug \texttt{kernel} adds a colon
+% and a space.
 %    \begin{macrocode}
 \NewSocket{caption/label}{1}
 %    \end{macrocode}