gbranden pushed a commit to branch master
in repository groff.
commit ada8ef394ac1c411001572796d2e6e81f4ae80f2
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sun Jul 27 15:00:52 2025 -0500
doc/*,man/*: Recast stroke/fill color discussion.
---
doc/groff.texi.in | 33 ++++++++++++++++++++-------------
man/groff.7.man | 12 ++++++------
man/groff_diff.7.man | 12 +++++++-----
3 files changed, 33 insertions(+), 24 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 46b1b69e3..49944d9af 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -13449,10 +13449,15 @@ withdrawn.}
@DefescItem {\\m, (, co, }
@DefescItem {\\m, [, col, ]}
@DefregListEndx {.m}
-Set stroke color to
-@var{col}.
+Select
+@var{col}
+as the stroke color for glyphs,
+rules,
+and objects drawn with
+@code{\D'@dots{}'}
+escape sequences.
The escape sequence
-@code{\m[]}
+@code{\M[]}
restores the previous stroke color,
or the default if there is none,
as does a
@@ -13470,10 +13475,10 @@ and these words are in the previous color.
@cindex stroke color name register (@code{.m})
@cindex name, stroke color, register (@code{.m})
@cindex color name, stroke, register (@code{.m})
-The name of the current stroke color is available in the read-only
-string-valued register @samp{.m}; it is associated with the environment
-(@pxref{Environments}). The default stroke color is named
-@samp{default}.
+The current environment's stroke color selection
+is available in the read-only string-valued register @samp{.m}
+(@pxref{Environments}).
+The default strike color is named @samp{default}.
@cindex @code{\m} escape sequence, untokenized on input
@cindex untokenized escape sequence, @code{\m}
@@ -13497,10 +13502,11 @@ We can assign a stroke color to a margin character as
follows
@DefescItem {\\M, (, co, }
@DefescItem {\\M, [, col, ]}
@DefregListEndx {.M}
-Set fill color for objects drawn with
+Select
+@var{col}
+as the fill color for objects drawn with
@code{\D'@dots{}'}
-escape sequences to
-@var{col}.
+escape sequences.
The escape sequence
@code{\M[]}
restores the previous fill color,
@@ -13533,9 +13539,10 @@ interprets the fill color as a character cell
background color.
@cindex fill color name register (@code{.M})
@cindex name, fill color, register (@code{.M})
@cindex color name, fill, register (@code{.M})
-The name of the current fill color is available in the read-only
-string-valued register @samp{.M}; it is associated with the environment
-(@pxref{Environments}). The default fill color is named @samp{default}.
+The current environment's fill color selection
+is available in the read-only string-valued register @samp{.M}
+(@pxref{Environments}).
+The default fill color is named @samp{default}.
Create an ellipse with a red interior as follows.
diff --git a/man/groff.7.man b/man/groff.7.man
index 2f587ff15..7a29cbe2f 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -5814,19 +5814,19 @@ default scaling unit\~\c
.
.TP
.ESC m c
-Set stroke color to that with one-character
+Select stroke color with one-character
.RI name\~ c .
.
.
.TP
.ESC m( cl
-Set stroke color to that with two-character
+Select stroke color with two-character
.RI name\~ cl .
.
.
.TP
.ESC[] m color
-Set stroke color to that with arbitrarily long
+Select stroke color with arbitrarily long
.RI name\~ color .
.
.
@@ -5837,19 +5837,19 @@ Restore previous stroke color.
.
.TP
.ESC M c
-Set fill color to that with one-character
+Select fill color with one-character
.RI name\~ c .
.
.
.TP
.ESC M( cl
-Set fill color to that with two-character
+Select fill color with two-character
.RI name\~ cl .
.
.
.TP
.ESC[] M color
-Set fill color to that with arbitrarily long
+Select fill color with arbitrarily long
.RI name\~ color .
.
.
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 91d90c91c..9ae61447e 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -2994,11 +2994,12 @@ performs this test before searching special fonts.
.TP
.BR .fcolor\~ [\c
.IR col ]
-Set the fill color to
-.IR col ,
+Select
+.I col
+as the environment's fill color,
or,
without an argument,
-restore the previous stroke color,
+restore the previous fill color,
or the default if there is none.
.
.
@@ -3123,8 +3124,9 @@ not an abstract style or mounting position.
.TP
.BR .gcolor\~ [\c
.IR col ]
-Set the stroke color to
-.IR col ,
+Select
+.I col
+as the environment's stroke color,
or,
without an argument,
restore the previous stroke color,
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
