[latex3-commits] [git/LaTeX3-latex3-latex2e] testmetadata: Some doc changes, needs further cleanup and more text. (3cb2a252)

[Frank Mittelbach]

Repository : https://github.com/latex3/latex2e
On branch  : testmetadata
Link       : https://github.com/latex3/latex2e/commit/3cb2a2527b8109678563488c642d75993bc31d9f

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

commit 3cb2a2527b8109678563488c642d75993bc31d9f
Author: Frank Mittelbach <frank.mittelbach at latex-project.org>
Date:   Wed Jan 12 00:35:02 2022 +0100

    Some doc changes, needs further cleanup and more text.


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

3cb2a2527b8109678563488c642d75993bc31d9f
 required/latex-lab/documentmetadata-support.dtx | 42 ++++++++++++++++++-------
 1 file changed, 30 insertions(+), 12 deletions(-)

diff --git a/required/latex-lab/documentmetadata-support.dtx b/required/latex-lab/documentmetadata-support.dtx
index 99080bee..16ab9650 100644
--- a/required/latex-lab/documentmetadata-support.dtx
+++ b/required/latex-lab/documentmetadata-support.dtx
@@ -30,7 +30,7 @@
 %
 
 % \title{The \texttt{documentmetadata-support} code\thanks{}}
-% \author{Frank Mittelbach, \LaTeX{} Project}
+% \author{Frank Mittelbach, Ulrike Fischer, \LaTeX{} Project}
 %
 % \maketitle
 %
@@ -50,8 +50,9 @@
 %^^A    This will probably be extended to  pass the value also to packages.
 %    \item[\texttt{pdfversion}] e.g. \texttt{pdfversion=1.7}
 %    \item[\texttt{uncompress}] no value. Forces an uncompressed pdf.
-%    \item[\texttt{lang}] to set the Lang entry in the Catalog.
-%    E.g. \texttt{lang=de-DE}. The initial value is |en-US|
+%    \item[\texttt{lang}] to set the Lang entry in the Catalog,
+%     e.g., \texttt{lang=de-DE}. If not given the default value used is |en-US|.
+%
 %    \item[\texttt{pdfstandard}] Choice key to set the pdf standard.
 %      Currently |A-1b|, |A-2a|, |A-2b|, |A-2u|, |A-3a|, |A-3b| and |A-3u| are accepted as
 %      values. The casing is irrelevant, |a-1b| works too.
@@ -62,20 +63,28 @@
 %      do \emph{not} enforce (or even test) a tagged pdf yet.
 %      More information can be found in the documentation
 %      of \pkg{l3pdfmeta}.
+%
 %    \item[\texttt{colorprofiles}] This allows to load icc-colorprofiles. Details
 %    are described in the documentation of \pkg{l3pdfmeta}.
+%
 %    \item[\texttt{testphase}] This key is used to load testphase code. The values it accepts
 %    and their effect will change over time, when testphase packages are added or
-%    removed or when the code is moved into the kernel. The value
-%    \texttt{phase-I} will load the tagpdf package. It will also issue
-%    |\tagpdfsetup{activate,interwordspace}| and so activate tagging. This phase
-%    is frozen.
-%    \texttt{phase-II} is the current development phase.
-%    Currently it differs from \texttt{phase-I} only in one point: It will
-%     additionally activate tagging of paragraphs with
-%    |\tagpdfsetup{paratagging}|.
-%  
+%    removed or when the code is moved into the kernel.
+%     \begin{description}
+%    \item[\texttt{phase-I}]
+%       This value loads code implementing the first phase of the project~\cite{blueprint}, i.e., it 
+%       will load the tagpdf package. It will also activate tagging by issuing
+%       |\tagpdfsetup{activate,interwordspace}|. This phase
+%       is frozen.
+%    \item[\texttt{phase-II}]
+%       This is the current development phase.
+%       Currently it differs from \texttt{phase-I} only in one point: It will
+%       additionally activate tagging of paragraphs with
+%       |\tagpdfsetup{paratagging}|. In the upcoming months it will
+%       also enable automatic tagging of other basic document elements.
+%    \end{description}
 %    The |testphase| key can only be used in the first \cs{DocumentMetadata}.
+%
 %    \item[\texttt{debug}] This key activates some debug options. It takes a list of key-values
 %    as value. Currently the following keys are known:
 %     \begin{description}
@@ -90,6 +99,15 @@
 %    \end{description}
 % \end{description}
 %
+% \bibliographystyle{plain}
+%
+% \begin{thebibliography}{9}
+%
+% \bibitem{blueprint} Frank Mittelbach and Chris Rowley:
+%   \emph{\LaTeX{} Tagged PDF\,---\,A blueprint for a large project}.
+%   \url{https://latex-project.org/publications/indexbyyear/2020/}
+%
+% \end{thebibliography}
 %
 %
 %