[latex3-commits] [git/LaTeX3-latex3-latex2e] develop: small docu updates (aed9c0ff)

[Joseph Wright]

Repository : https://github.com/latex3/latex2e
On branch  : develop
Link       : https://github.com/latex3/latex2e/commit/aed9c0ff6e5a1495db4988cf36e850cafa0899ad

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

commit aed9c0ff6e5a1495db4988cf36e850cafa0899ad
Author: Frank Mittelbach <frank.mittelbach at latex-project.org>
Date:   Thu Mar 10 15:10:07 2022 +0100

    small docu updates


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

aed9c0ff6e5a1495db4988cf36e850cafa0899ad
 required/latex-lab/changes.txt             |  2 +-
 required/latex-lab/latex-lab-prototype.dtx | 10 +++++++++-
 2 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/required/latex-lab/changes.txt b/required/latex-lab/changes.txt
index e8595ba2..e146c5a0 100644
--- a/required/latex-lab/changes.txt
+++ b/required/latex-lab/changes.txt
@@ -1,7 +1,7 @@
 2022-03-08 Joseph Wright <Joseph.Wright at latex-project.org>
 
 	* latex-lab-prototype.dtx
-	 New file re-implementing ides from on xtemplate.dtx using updated
+	 New file re-implementing ideas from on xtemplate.dtx using updated
 	 keyval support
 
 2021-12-30 Ulrike Fischer <Ulrike.Fischer at latex-project.org>
diff --git a/required/latex-lab/latex-lab-prototype.dtx b/required/latex-lab/latex-lab-prototype.dtx
index 9414fdf3..7ac7e58f 100644
--- a/required/latex-lab/latex-lab-prototype.dtx
+++ b/required/latex-lab/latex-lab-prototype.dtx
@@ -163,6 +163,11 @@
 %   \end{verbatim}
 %  creates an object type \enquote{sectioning}, where each use of that
 %  object type will need three arguments.
+%
+%  While not formally verified the semantics of all arguments are part
+%  of the object declaration and need to be carefully documented in
+%  order to make the use of different templates for the same object
+%  type meaningful.
 % \end{function}
 %
 % \section{Templates}
@@ -313,13 +318,16 @@
 %     \cs{prototype_show_template_defaults:nn} \Arg{object type} \Arg{template}
 %     \cs{prototype_show_instance_values:nn} \Arg{object type} \Arg{instance}
 %   \end{syntax}
+%   Show information about a declare template or instance for
+%   debugging purposes.
 % \end{function}
 %
 % \section{Open questions and comparison with \pkg{xtemplate}}
 %
 % The approach here is modelled on that from \pkg{xtemplate}, but since it uses
 % \pkg{l3keys} rather than dedicated key handling, there are some differences.
-% There is also a simplification in that collections are not supported.
+% There is also a simplification in that collections are not supported
+% (because we now think that they provided the wrong kind of abstraction).
 %
 % The various open questions, including those linked to \pkg{xtemplate}
 % concepts, are collected here.