[latex3-commits] [latex3/tagpdf] develop: separate keys in documentation (4cf6a8f)

[github at latex-project.org]

Repository : https://github.com/latex3/tagpdf
On branch  : develop
Link       : https://github.com/latex3/tagpdf/commit/4cf6a8f4b252b09c86ce6612f703454ae54094e2

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

commit 4cf6a8f4b252b09c86ce6612f703454ae54094e2
Author: Ulrike Fischer <fischer at troubleshooting-tex.de>
Date:   Sun Sep 29 00:52:42 2024 +0200

    separate keys in documentation


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

4cf6a8f4b252b09c86ce6612f703454ae54094e2
 tagpdf.dtx | 29 +++++++++++++++++++++++++----
 1 file changed, 25 insertions(+), 4 deletions(-)

diff --git a/tagpdf.dtx b/tagpdf.dtx
index d40c60b..8de8c25 100644
--- a/tagpdf.dtx
+++ b/tagpdf.dtx
@@ -87,16 +87,37 @@
 % \end{setupkeydecl}
 %
 % \begin{setupkeydecl}{activate/mc,
-%    activate/tree,
-%    activate/struct,
-%    activate/all,
 %    activate-mc (deprecated),
+%    }
+% A key to to activate the marked content code. It should be used
+% only in special cases, e.g. for debugging.
+% \end{setupkeydecl}
+% 
+% \begin{setupkeydecl}{
+%    activate/tree,
 %    activate-tree (deprecated),
+%    }
+% This key activates the code that finalize the 
+% various trees. It should be used
+% only in special cases, e.g. for debugging.
+% \end{setupkeydecl}
+% \begin{setupkeydecl}{
+%    activate/struct,
 %    activate-struct (deprecated),
+%    }
+% This key activates the code for structures.
+% It should be used
+% only in special cases, e.g. for debugging.
+% \end{setupkeydecl}
+
+% \begin{setupkeydecl}{
+%    activate/all,
 %    activate-all (deprecated),
 %    }
-% Keys to activate the various tagging steps. 
+% This is a meta key for the three previous keys
+% and is normally what should be used to activate tagging.
 % \end{setupkeydecl}
+ 
 %\begin{setupkeydecl}{activate/struct-dest,no-struct-dest (deprecated)}
 % The key allows to suppress the creation of structure destinations
 % \end{setupkeydecl}