; Fix documentation of last change.

* src/xdisp.c (syms_of_xdisp):
* src/dispnew.c (syms_of_display):
* doc/lispref/commands.texi (Accessing Mouse): Fix documentation
of last change.

diff --git a/doc/lispref/commands.texi b/doc/lispref/commands.texi
index ad7ba1e8a826d505dd65ceab6b1d08f79e50740f..82dca3548a6ab02154903f5c03dbd4ead0dde084 100644 (file)
--- a/doc/lispref/commands.texi
+++ b/doc/lispref/commands.texi
@@ -2758,12 +2758,13 @@ to the entire window area including scroll bars, margins and fringes.
 
 @defopt mouse-prefer-closest-glyph
 If this variable is non-@code{nil}, the @code{posn-point} of a mouse
-position list will be set to the position of the glyph whose left most
-position is closest to the mouse pointer, as opposed to the position of
+position list will be set to the position of the glyph whose leftmost
+edge is the closest to the mouse click, as opposed to the position of
 the glyph underneath the mouse pointer itself.  For example, if
 @code{posn-at-x-y} is called with @var{x} set to @code{9}, which is
-contained within a character of width 10 positioned at column 0, the
-point saved within the mouse position list will be after that character.
+contained within a character of width 10 displayed at column 0, the
+point saved within the mouse position list will be @emph{after} that
+character, not @emph{before} it.
 @end defopt
 
 @node Accessing Scroll

diff --git a/src/dispnew.c b/src/dispnew.c
index 821357c51c102e8f39a27f5f048e6cbafa2bf896..28f0eaeaa95fd9bce235f55d7bf959f5a6b5036e 100644 (file)
--- a/src/dispnew.c
+++ b/src/dispnew.c
@@ -6823,12 +6823,11 @@ predicates which report frame's specific UI-related capabilities.  */);
               doc: /* Non-nil means put cursor in minibuffer, at end of any message there.  */);
 
   DEFVAR_BOOL ("mouse-prefer-closest-glyph", mouse_prefer_closest_glyph,
-              doc: /* Non-nil means mouse position lists are reported relative
-to the glyph closest to their coordinates.
+              doc: /* Non-nil means mouse click position is taken from glyph closest to click.
 
- When non-nil, mouse position lists will be reported with their
-`posn-point' set to the position of the glyph closest to the mouse
-pointer, instead of the glyph immediately under.  */);
+When non-nil, mouse position lists will report buffer position set to
+the position of the glyph that is the closest to the mouse pointer
+at the time of the click, instead of the glyph immediately under it.  */);
   mouse_prefer_closest_glyph = false;
 
   DEFVAR_LISP ("glyph-table", Vglyph_table,

diff --git a/src/xdisp.c b/src/xdisp.c
index 1de6fcfd172e7eb7126324f86cefa83290f546ae..540fdbb0b07a836e75701d4ab77f616e9407d994 100644 (file)
--- a/src/xdisp.c
+++ b/src/xdisp.c
@@ -37513,10 +37513,10 @@ may be more familiar to users.  */);
   display_raw_bytes_as_hex = false;
 
   DEFVAR_BOOL ("mouse-fine-grained-tracking", mouse_fine_grained_tracking,
-    doc: /* Non-nil for pixel-wise mouse-movement.
+    doc: /* Non-nil for pixelwise mouse-movement.
 When nil, mouse-movement events will not be generated as long as the
 mouse stays within the extent of a single glyph (except for images).
-When nil and mouse-prefer-closest-glyph is non-nil, mouse-movement
+When nil and `mouse-prefer-closest-glyph' is non-nil, mouse-movement
 events will instead not be generated as long as the mouse stays within
 the extent of a single left/right half glyph (except for images).  */);
   mouse_fine_grained_tracking = false;