[latex3-commits] [git/LaTeX3-latex3-latex3] master: xbox: Add a note on box vs coffin (fd0661c3a)

[Joseph Wright]

Repository : https://github.com/latex3/latex3
On branch  : master
Link       : https://github.com/latex3/latex3/commit/fd0661c3acbcd3195235ac522d9570367f43bf10

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

commit fd0661c3acbcd3195235ac522d9570367f43bf10
Author: Joseph Wright <joseph.wright at morningstar2.co.uk>
Date:   Mon Aug 24 13:57:35 2020 +0100

    xbox: Add a note on box vs coffin


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

fd0661c3acbcd3195235ac522d9570367f43bf10
 l3trial/xbox/xbox.dtx | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/l3trial/xbox/xbox.dtx b/l3trial/xbox/xbox.dtx
index d9029e2b2..80385dc5a 100644
--- a/l3trial/xbox/xbox.dtx
+++ b/l3trial/xbox/xbox.dtx
@@ -56,7 +56,7 @@
 % box constructs using \pkg{xparse} and \pkg{expl3} coding. As such, it provides
 % as far as possible the \LaTeXe{} \textsc{api} (except where explicitly
 % noted). Other than separation of layers, there is no significant new
-% functionality here.
+% functionality here
 %
 % \begin{variable}{\height, \depth, \width, \totalheight}
 %   The natural dimensions of material being boxed are available within
@@ -193,7 +193,10 @@
 % \section{Saving material in boxes}
 %
 % Material may be saved in named boxes, which have command-like names,
-% for example |\mybox|.
+% for example |\mybox|. These are implemented as coffins, which means
+% they automatically contain \cs{color_ensure_current:}. However, we do
+% not make use of the pole structures: would a simple box structure be
+% better?
 %
 % \begin{function}{\newsavebox}
 %   \begin{syntax}