(Display Feature Testing): Try to explain what all the visual classes mean

Fixes: debbugs:3042

2 files changed, 12 insertions, 4 deletions

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index c265b9e878d..9c8a76faf7c 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,8 @@
+2011-07-11  Lars Magne Ingebrigtsen  <larsi@gnus.org>
+
+        * frames.texi (Display Feature Testing): Try to explain what all
+        the visual classes mean (bug#3042).
+
 2011-07-10  Lars Magne Ingebrigtsen  <larsi@gnus.org>
 
         * modes.texi (Mode Line Variables): Document `mode-line-remote'
diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi
index ee765a7e1d0..7dc6934c7d9 100644
--- a/doc/lispref/frames.texi
+++ b/doc/lispref/frames.texi
@@ -2446,10 +2446,13 @@ For a tty display, it is log to base two of the number of colors supported.
 @end defun
 
 @defun display-visual-class &optional display
-This function returns the visual class for the screen.  The value is one
-of the symbols @code{static-gray}, @code{gray-scale},
-@code{static-color}, @code{pseudo-color}, @code{true-color}, and
-@code{direct-color}.
+This function returns the visual class for the screen.  The value is
+one of the symbols @code{static-gray} (a limited, unchangeable number
+of grays), @code{gray-scale} (a full range of grays),
+@code{static-color} (a limited, unchangeable number of colors),
+@code{pseudo-color} (a limited number of colors), @code{true-color} (a
+full range of colors), and @code{direct-color} (a full range of
+colors).
 @end defun
 
 @defun display-color-cells &optional display