[latex3-commits] [git/LaTeX3-latex3-latex3] master: Detail limitations on what goes in a drawing [ci skip] (400b8a2)

[Joseph Wright]

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

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

commit 400b8a2fd5cd68265fdc7f561d6161921a5aa5fb
Author: Joseph Wright <joseph.wright at morningstar2.co.uk>
Date:   Mon Feb 26 10:46:30 2018 +0000

    Detail limitations on what goes in a drawing [ci skip]
    
    Don't actually have text support just yet!


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

400b8a2fd5cd68265fdc7f561d6161921a5aa5fb
 l3experimental/l3draw/l3draw.dtx |    7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/l3experimental/l3draw/l3draw.dtx b/l3experimental/l3draw/l3draw.dtx
index fb229ec..e5b5571 100644
--- a/l3experimental/l3draw/l3draw.dtx
+++ b/l3experimental/l3draw/l3draw.dtx
@@ -158,6 +158,13 @@
 %       \draw_path_use_clear:n { stroke }
 %     \draw_end:
 %   \end{demo}
+%
+%   Within a drawing, the only commands that should appear are those directly
+%   aimed at drawing (from \pkg{l3draw}) and those which produce \emph{no}
+%   typeset output. For example, it is possible to include loops inside a
+%   drawing using |\int_step_function:nnnn| or similar. On the other hand,
+%   text should not be included directly in drawings, but should rather be
+%   inserted using the appropriate \pkg{l3draw} command.
 % \end{function}
 %
 % Within a drawing, there are different ways of referring to a position.