From e8551372aa9d58c247cb7861e25611b2d5d7078d Mon Sep 17 00:00:00 2001
From: Ulrike Fischer <fischer@troubleshooting-tex.de>
Date: Mon, 16 Sep 2024 19:17:08 +0200
Subject: [PATCH] document new resume/suspend commands.

---
 doc/tagpdf.tex | 37 +++++++++++++++++++++++++------------
 1 file changed, 25 insertions(+), 12 deletions(-)

diff --git a/doc/tagpdf.tex b/doc/tagpdf.tex
index bd571f4b..a9d63a39 100644
--- a/doc/tagpdf.tex
+++ b/doc/tagpdf.tex
@@ -2064,16 +2064,12 @@ \subsection{Interrupting the tagging}
 
 \begin{docCommands}
  {
-  {doc name=tag_stop:},
-  {doc name=tag_start:},
-  {doc name=tagstop},
-  {doc name=tagstart},
-  {doc name=tag_stop:n,doc parameter=\marg{label}},
-  {doc name=tag_start:n,doc parameter=\marg{label}}
+  {doc name=tag_suspend:n,doc parameter=\marg{label}},
+  {doc name=tag_resume:n,doc parameter=\marg{label}} 
  } 
 \end{docCommands}
 
-This commands stop and start tagging in the current group by switching 
+These commands suspend and resume tagging in the current group by switching 
 \emph{local} booleans. They also stop the increasing of the counters which 
 keep track of paragraphs if the correct wrapper commands are used. 
 
@@ -2082,18 +2078,35 @@ \subsection{Interrupting the tagging}
 the corresponding stop command actually stopped tagging. This is implement 
 through a local counter which keeps track of the level.  
 
-The \meta{label} can be used to identify the command in debugging message. 
+The \meta{label} can be used to identify the command in debugging message. The label is not expanded and so can for example be a single command token.
+
+The commands are the L3-layer versions of |\SuspendTagging| and |\ResumeTagging|
+and will be available in the kernel with the 2024 november release. 
 
 \begin{taglstlisting}
-\tag_stop:n{outer}
+\tag_suspend:n{\outercommand}
  ...
- \tag_stop:n{inner}
+ \tag_suspend:n{\innercommand}
   ...
- \tag_start:n{inner}
+ \tag_resume:n{\innercommand}
  ...
-\tag_start:n{outer}
+\tag_resume:n{\outercommand}
 \end{taglstlisting} 
  
+\begin{docCommands}
+ {
+  {doc name=tag_stop:},
+  {doc name=tag_start:},
+  {doc name=tagstop},
+  {doc name=tagstart},
+  {doc name=tag_stop:n,doc parameter=\marg{label}},
+  {doc name=tag_start:n,doc parameter=\marg{label}}
+ }
+\end{docCommands}  
+
+These commands are now deprecated in favor or |\tag_suspend:n| and |\tag_resume:n| 
+but are still provided for some time. 
+
 
 \subsection{Lazy and automatic tagging}\label{sec:lazy}