[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 10/39: [docs]: Tweak presentation of colors.
From: |
G. Branden Robinson |
Subject: |
[groff] 10/39: [docs]: Tweak presentation of colors. |
Date: |
Tue, 31 May 2022 20:32:19 -0400 (EDT) |
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
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 10/39: [docs]: Tweak presentation of colors.,
G. Branden Robinson <=