CTAN sync 201910040301

1 files changed, 14 insertions, 1 deletions

diff --git a/macros/latex/contrib/knowledge/knowledge-utils.dtx b/macros/latex/contrib/knowledge/knowledge-utils.dtx
index af2d372a40..dc0f0deed7 100644
--- a/macros/latex/contrib/knowledge/knowledge-utils.dtx
+++ b/macros/latex/contrib/knowledge/knowledge-utils.dtx
@@ -523,6 +523,18 @@
 %
 % \subsection{References}
 %
+% This is an old part of the code which is difficult to read.
+% It should probably be cleaned.
+%
+% When using \cs{\cell_new_type:nnn}, a new name space is created,
+% in which can be stored information. The first parameter is the name space. The second
+% is the description (expl3 style) of the parameters defining an entry, and the third is the
+% string of character (that can use the arguments defined) used to address this space.
+% For instance \verb|\cell_new_type:nnn{carots}{nn}{K@ROT:{#1}{#2}}|
+% define a cell type named `carot' that is indexed by two parameters.
+% In particular, it defines the macro \cs{\carot:Nnn} that takes a token, and parameters, that executes the
+% token with as first parameter the token identifying the location of the carot.
+% For instance, \verb|\carot_at:Nnn\show{A}{B}| will display the content of the carot defined by the parameters A and B.
 %    \begin{macrocode}
 \cs_new:Nn\cell_new_type:nnn
   {
@@ -532,7 +544,8 @@
       {\exp_not:n{\exp_after:wN\exp_args:Nc\exp_after:wN}
        ##1 \exp_not:c{#1_id_b:#2}}
   }
-
+%    \end{macrocode}
+%    \begin{macrocode}
 \cs_new:Nn\cell_specialize:nnn
   {\cs_new:cpx{#1_#2_id:#3}
       {\exp_not:c{#1_id:n#3}{#2}}