[Emacs-diffs] Changes to emacs/lispref/frames.texi

[Richard M. Stallman]

Index: emacs/lispref/frames.texi
diff -u emacs/lispref/frames.texi:1.104 emacs/lispref/frames.texi:1.105
--- emacs/lispref/frames.texi:1.104     Mon Feb  6 11:55:10 2006
+++ emacs/lispref/frames.texi   Tue May 23 03:02:20 2006
@@ -62,7 +62,7 @@
 * Mouse Position::             Asking where the mouse is, or moving it.
 * Pop-Up Menus::               Displaying a menu for the user to select from.
 * Dialog Boxes::                Displaying a box to ask yes or no.
-* Pointer Shapes::              Specifying the shape of the mouse pointer.
+* Pointer Shape::               Specifying the shape of the mouse pointer.
 * Window System Selections::    Transferring text to and from other X clients.
 * Drag and Drop::               Internals of Drag-and-Drop implementation.
 * Color Names::                        Getting the definitions of color names.
@@ -1564,30 +1564,49 @@
 @code{x-popup-dialog} does not return.
 @end defun
 
address@hidden Pointer Shapes
address@hidden Pointer Shapes
address@hidden Pointer Shape
address@hidden Pointer Shape
 @cindex pointer shape
 @cindex mouse pointer shape
 
-  These variables specify which shape to use for the mouse pointer in
-various situations, when using the X Window System:
+  You can specify the mouse pointer style for particular text or
+images using the @code{pointer} text property, and for images with the
address@hidden:pointer} and @code{:map} image properties.  The values you can
+use in these properties are @code{text} (or @code{nil}), @code{arrow},
address@hidden, @code{vdrag}, @code{hdrag}, @code{modeline}, and
address@hidden  @code{text} stands for the usual mouse pointer
+style used over text.
+
+  Over void parts of the window (parts that do not correspond to any
+of the buffer contents), the mouse pointer usually uses the
address@hidden style, but you can specify a different style (one of
+those above) by setting @code{void-text-area-pointer}.
+
address@hidden void-text-area-pointer
address@hidden void-text-area-pointer
+This variable specifies the mouse pointer style for void text areas.
+These include the areas after the end of a line or below the last line
+in the buffer.  The default is to use the @code{arrow} (non-text)
+pointer style.
address@hidden defvar
 
address@hidden @code
address@hidden x-pointer-shape
address@hidden x-pointer-shape
-This variable specifies the pointer shape to use ordinarily in the Emacs
-frame.
+  You can specify what the @code{text} pointer style really looks like
+by setting the variable @code{x-pointer-shape}.
+
address@hidden x-pointer-shape
+This variable specifies the pointer shape to use ordinarily in the
+Emacs frame, for the @code{text} pointer style.
address@hidden defvar
 
address@hidden x-sensitive-text-pointer-shape
address@hidden x-sensitive-text-pointer-shape
address@hidden x-sensitive-text-pointer-shape
 This variable specifies the pointer shape to use when the mouse
 is over mouse-sensitive text.
 @end table
 
   These variables affect newly created frames.  They do not normally
-affect existing frames; however, if you set the mouse color of a frame,
-that also updates its pointer shapes based on the current values of
-these variables.  @xref{Color Parameters}.
+affect existing frames; however, if you set the mouse color of a
+frame, that also installs the current value of those two variables.
address@hidden Parameters}.
 
   The values you can use, to specify either of these pointer shapes, are
 defined in the file @file{lisp/term/x-win.el}.  Use @kbd{M-x apropos