[Emacs-diffs] Changes to emacs/doc/lispref/minibuf.texi,v

[Eli Zaretskii]

CVSROOT:        /cvsroot/emacs
Module name:    emacs
Changes by:     Eli Zaretskii <eliz>    08/10/21 11:23:57

Index: minibuf.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/doc/lispref/minibuf.texi,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -b -r1.14 -r1.15
--- minibuf.texi        20 Oct 2008 10:41:50 -0000      1.14
+++ minibuf.texi        21 Oct 2008 11:23:57 -0000      1.15
@@ -1267,6 +1267,28 @@
 @end example
 @end defun
 
address@hidden Command read-color &optional prompt convert allow-empty display
+This function reads a string that is a color specification, either the
+color's name or an RGB hex value such as @code{#RRRGGGBBB}.  It
+prompts with @var{prompt} (default: @code{"Color (name or #R+G+B+):"})
+and provides completion for color names, but not for hex RGB values.
+In addition to names of standard colors, completion candidates include
+the foreground and background colors at point.
+
+Valid RGB values are described in @ref{Color Names}.
+
+The function's return value is the color name typed by the user in the
+minibuffer.  However, when called interactively or if the optional
+argument @var{convert} is address@hidden, it converts the name into
+the color's RGB value and returns that value as a string.  If an
+invalid color name was specified, this function signals an error,
+except that empty color names are allowed when @code{allow-empty} is
address@hidden and the user enters null input.
+
+Interactively, or when @var{display} is address@hidden, the return
+value is also displayed in the echo area.
address@hidden deffn
+
   See also the functions @code{read-coding-system} and
 @code{read-non-nil-coding-system}, in @ref{User-Chosen Coding Systems},
 and @code{read-input-method-name}, in @ref{Input Methods}.