[latex3-commits] [git/LaTeX3-latex3-pdfresources] rename-coredict: move boolean description (f767e22)

[Ulrike Fischer]

Repository : https://github.com/latex3/pdfresources
On branch  : rename-coredict
Link       : https://github.com/latex3/pdfresources/commit/f767e22bc7fa14f0bcb4e4780ed93295b1743a2d

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

commit f767e22bc7fa14f0bcb4e4780ed93295b1743a2d
Author: Ulrike Fischer <fischer at troubleshooting-tex.de>
Date:   Fri Nov 27 17:08:46 2020 +0100

    move boolean description


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

f767e22bc7fa14f0bcb4e4780ed93295b1743a2d
 l3pdfinit.dtx       | 32 ++++++++++++++++----------------
 l3pdfmanagement.dtx |  9 ++++++++-
 2 files changed, 24 insertions(+), 17 deletions(-)

diff --git a/l3pdfinit.dtx b/l3pdfinit.dtx
index 6627076..58d097e 100644
--- a/l3pdfinit.dtx
+++ b/l3pdfinit.dtx
@@ -50,27 +50,27 @@
 %
 % \section{\pkg{l3pdfinit} documentation}
 % This small package defines \cs{DeclareDocumentMetadata} and the related keys.
-% \cs{DeclareDocumentMetadata} loads the core code and the backend. So it need
-% at least a key to set the backend.
+% \cs{DeclareDocumentMetadata} loads the management code and other core
+% code. This forces the loading of the backend files the backend.
+% So it needs at least a key to set the backend.
 %
 % Currently the following keys are implemented
 %
 % \begin{description}
-%    \item[\texttt{expl3}] passes the value to expl3.
-%                This be used for example to setup the backend. The name and
-%                implementation will probably change.
-%    \item[\texttt{backend}] passes the backend name to expl3. This will probably be extended, to
-%    pass the value also to packages.
+%    \item[\texttt{backend}] passes the backend name to expl3.
+%    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. Force an uncompressed pdf.
+%    \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}.
-%    \item[\texttt{standard}] Choice key to set the pdf standard. Currently A-1b, A-2b and A-3b are accepted as
-%              values, but the underlying code to ensure the requirements (as far as it
-%              can be ensured) is incomplete.
-%    \item[\texttt{xmpmeta}] Boolean. This includes a skeleton XMP-metadata in the pdf. This clashes
-%     with e.g. hyperxmp, and the code to extend the metadata isn't finished yet.
-%    \item[\texttt{pdfmanagement}] Boolean. This activates/deactivates the core management code.
-%         By default the value is true.
+%    \item[\texttt{standard}] Choice key to set the pdf standard.
+%      Currently A-1b, A-2b and A-3b are accepted as
+%      values, but the underlying code to ensure the requirements (as far as it
+%      can be ensured) is incomplete.
+%^^A     disabled for now.
+%^^A    \item[\texttt{xmpmeta}] Boolean. This includes a skeleton XMP-metadata in the pdf. This clashes
+%^^A     with e.g. hyperxmp, and the code to extend the metadata isn't finished yet.
+%    \item[\texttt{pdfmanagement}] Boolean. This activates/deactivates
+%      the core management code. By default the value is true.
 % \end{description}
 % \end{documentation}
 %
@@ -81,7 +81,7 @@
 %    \begin{macrocode}
 %<*package>
 \ProvidesExplPackage {l3pdfinit} {2020-11-27} {0.2}
-  {pdfresources initialisation command}
+  {New document  command}
 %    \end{macrocode}
 % \section{Document metadata}
 % We plan a \cs{DeclareDocumentMetadata} so let's start with it.
diff --git a/l3pdfmanagement.dtx b/l3pdfmanagement.dtx
index c028f09..cbcf6db 100644
--- a/l3pdfmanagement.dtx
+++ b/l3pdfmanagement.dtx
@@ -504,9 +504,16 @@
     command~'#1'~ignored.
   }
 %    \end{macrocode}
-% A predicate to test if the core code should be active
+% \begin{variable}{\g_@@_active_bool}
+% This boolean will control the activation of the management code.
+% It is used in the hooks, and in some backend files.
+% % \cs{DeclareDocumentMetadata} should set it to true
 %    \begin{macrocode}
 \bool_new:N \g_@@_active_bool
+%    \end{macrocode}
+% \end{variable}
+% A user predicate to test if the management code is active
+%    \begin{macrocode}
 \prg_new_conditional:Npnn \@@_if_active:  { p , T , F , TF }
   {
     \bool_if:NTF \g_@@_active_bool