From f705df79df27ad3eb4485d0272d6325beb0d1f36 Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Sat, 5 Feb 2005 13:19:39 +0000 Subject: [PATCH] (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". --- lispref/frames.texi | 18 +++++++++++------- 1 file changed, 11 insertions(+), 7 deletions(-) diff --git a/lispref/frames.texi b/lispref/frames.texi index a33c5b356be..f50be70f473 100644 --- a/lispref/frames.texi +++ b/lispref/frames.texi @@ -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