1
0
mirror of https://git.savannah.gnu.org/git/emacs.git synced 2025-01-05 11:45:45 +00:00

(Color Names): Add pointer to the X docs about RGB

color specifications.  Improve indexing
(Text Terminal Colors): Replace the description of RGB values by
an xref to "Color Names".
This commit is contained in:
Eli Zaretskii 2005-02-05 13:19:39 +00:00
parent 3ee341ecad
commit f705df79df

View File

@ -1588,6 +1588,9 @@ but @code{t} on MS-Windows.
@node Color Names
@section Color Names
@cindex color names
@cindex specify color
@cindex numerical RGB color specification
A color name is text (usually in a string) that specifies a color.
Symbolic names such as @samp{black}, @samp{white}, @samp{red}, etc.,
are allowed; use @kbd{M-x list-colors-display} to see a list of
@ -1597,7 +1600,9 @@ as @samp{#@var{rgb}} and @samp{RGB:@var{r}/@var{g}/@var{b}}, where
and @var{b} specifies the blue level. You can use either one, two,
three, or four hex digits for @var{r}; then you must use the same
number of hex digits for all @var{g} and @var{b} as well, making
either 3, 6, 9 or 12 hex digits in all.
either 3, 6, 9 or 12 hex digits in all. (See the documentation of the
X Window System for more details about numerical RGB specification of
colors.)
These functions provide a way to determine which color names are
valid, and what they look like. In some cases, the value depends on the
@ -1657,12 +1662,14 @@ color name, this function returns @code{nil}.
@defun color-values color &optional frame
@tindex color-values
@cindex rgb value
This function returns a value that describes what @var{color} should
ideally look like on @var{frame}. If @var{color} is defined, the
value is a list of three integers, which give the amount of red, the
amount of green, and the amount of blue. Each integer ranges in
principle from 0 to 65535, but some displays may not use the full
range. This kind of three-element list is called an @dfn{rgb value}.
range. This three-element list is called the @dfn{rgb values} of the
color.
If @var{color} is not defined, the value is @code{nil}.
@ -1704,11 +1711,8 @@ standard set of colors and will try to use them automatically.
The functions described in this section control how terminal colors
are used by Emacs.
@cindex rgb value
Several of these functions use or return @dfn{rgb values}. An rgb
value is a list of three integers, which give the amount of red, the
amount of green, and the amount of blue. Each integer ranges in
principle from 0 to 65535, but some displays may not use the full range. .
Several of these functions use or return @dfn{rgb values}, described
in @ref{Color Names}.
These functions accept a display (either a frame or the name of a
terminal) as an optional argument. We hope in the future to make Emacs