[groff] 10/39: [docs]: Tweak presentation of colors.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 25426513292749b4f91c7d8ec56206031a5a71d1
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun May 29 15:24:19 2022 -0500

    [docs]: Tweak presentation of colors.
---
 doc/groff.texi  | 32 +++++++++++++++-----------------
 man/groff.7.man | 14 +++++++-------
 2 files changed, 22 insertions(+), 24 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 67b47a7e..95d9a8a3 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -11530,33 +11530,30 @@ may be more limited.  When color support is enabled, 
two colors are
 current at any given time: the @dfn{stroke color}, with which glyphs,
 rules (lines), and geometric objects like circles and polygons are
 drawn, and the @dfn{fill color}, which can be used to paint the interior
-of closed geometric figures.
+of a closed geometric figure.
 
 @DefreqList {color, [@Var{n}]}
 @DefregListEndx {.color}
 If @var{n} is missing or non-zero, enable the output of color-related
 device-independent output commands (this is the default); otherwise,
-disable them.
+disable them.  This request sets a global flag; it does not produce an
+input token (@pxref{Gtroff Internals}).
 
 The read-only register @code{.color} is@tie{}1 if colors are enabled,
 0@tie{}otherwise.
 
-Internally, @code{color} sets a global flag; it does not produce a
-token.  As with the @code{cp} request, you should use it at the
-beginning of your document to control color output.
-
-Colors can be also turned off with the @option{-c} command-line option.
+Color can also be disabled with the @option{-c} command-line option.
 @endDefreq
 
 @Defreq {defcolor, ident scheme color-component @dots{}}
-Define a color named @var{ident}.  @var{scheme} identifies a color space
+Define a color named @var{ident}.  @var{scheme} selects a color space
 and determines the quantity of required @var{color-component}s; it must
-be one of @samp{rgb} (three components), @samp{cmy} (three components),
-@samp{cmyk} (four components), or @samp{gray} (one component).
-@samp{grey} is accepted as a synonym of @samp{gray}.  The color
-components can be encoded as a hexadecimal value starting with @samp{#}
-or @samp{##}.  The former indicates that each component is in the range
-0--255 (0--FF), the latter the range 0--65535 (0--FFFF).
+be one of @samp{rgb} (three components), @samp{cmy} (three), @samp{cmyk}
+(four), or @samp{gray} (one).  @samp{grey} is accepted as a synonym of
+@samp{gray}.  The color components can be encoded as a single
+hexadecimal value starting with @samp{#} or @samp{##}.  The former
+indicates that each component is in the range 0--255 (0--FF), the latter
+the range 0--65,535 (0--FFFF).
 
 @Example
 .defcolor half gray #7f
@@ -11614,9 +11611,10 @@ 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}).
 
-@code{\m} doesn't produce an input token in GNU @code{troff}.  As a
-consequence, it can be used in requests like @code{mc} (which expects
-a single character as an argument) to change the color on the fly:
+@code{\m} doesn't produce an input token in GNU @code{troff}
+(@pxref{Gtroff Internals}).  It therefore can be used in requests like
+@code{mc} (which expects a single character as an argument) to change
+the color on the fly:
 
 @Example
 .mc \m[red]x\m[]
diff --git a/man/groff.7.man b/man/groff.7.man
index 060a28ff..7052156b 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -641,7 +641,7 @@ rules (lines),
 and geometric objects like circles and polygons are drawn,
 and the
 .I fill color,
-which can be used to paint the interior of closed geometric figures.
+which can be used to paint the interior of a closed geometric figure.
 .
 The
 .BR color ,
@@ -1948,26 +1948,26 @@ it must be one of
 .RB \[lq] rgb \[rq]
 (three components),
 .RB \[lq] cmy \[rq]
-(three components),
+(three),
 .RB \[lq] cmyk \[rq]
-(four components),
+(four),
 or
 .RB \[lq] gray \[rq]
-(one component).
+(one).
 .
 .RB \[lq] grey \[rq]
 is accepted as a synonym of
 .RB \[lq] gray \[rq].
 .
-The color components can be encoded as a hexadecimal value starting
-with
+The color components can be encoded as a single hexadecimal value
+starting with
 .B #
 or
 .BR ## .
 .
 The former indicates that each component is in the range 0\[en]255
 (0\[en]FF),
-the latter the range 0\[en]65535 (0\[en]FFFF).
+the latter the range 0\[en]65,535 (0\[en]FFFF).
 .
 Alternatively,
 each color component can be specified as a decimal fraction in the range