[latex3-commits] [git/LaTeX3-latex3-latex3] master: Update color fill/stroke docs (d0e364d7d)

[Joseph Wright]

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

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

commit d0e364d7d07324f9559371dd68a26e439fa8f45b
Author: Joseph Wright <joseph.wright at morningstar2.co.uk>
Date:   Tue Jan 19 17:12:28 2021 +0000

    Update color fill/stroke docs


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

d0e364d7d07324f9559371dd68a26e439fa8f45b
 l3experimental/l3color/l3color.dtx | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

diff --git a/l3experimental/l3color/l3color.dtx b/l3experimental/l3color/l3color.dtx
index 416cb9d8a..bca321d15 100644
--- a/l3experimental/l3color/l3color.dtx
+++ b/l3experimental/l3color/l3color.dtx
@@ -247,14 +247,18 @@
 %   and similar are not influenced by this setting.
 % \end{variable}
 %
-% \section{Colors for drawing: fills and strokes}
+% \section{Colors for fills and strokes}
 %
 % Colors for drawing operations and so forth are split into strokes and fills
-% (the latter may also be referred to as non-stroke color). These operations
-% \emph{may} apply to text, but this is backend-depended and the general
-% \cs{color_select:n(n)} should be used for typeset text. An appropriate scope
-% must be applied to the color change, for example
-% \cs{draw_begin:}/\cs{draw_end:}.
+% (the latter may also be referred to as non-stroke color). The fill color is
+% used for text under normal circumstances. Depending on the backend, stroke
+% color may use a \emph{stack}, in which case it exhibits the same page breaking
+% behavior as general color. However, \texttt{dvips}/\texttt{dvisvgm} do not
+% support this, and so color will need to be contained within a scope, such
+% as \cs{draw_begin:}/\cs{draw_end:}.
+%
+% Note that the \emph{current color} is the fill color, as this is used for
+% running text.
 %
 % \begin{function}{\color_fill:n, \color_stroke:n}
 %   \begin{syntax}