[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] emacs-24 r117508: Clarify the doc strings of mouse-positio
From: |
Eli Zaretskii |
Subject: |
[Emacs-diffs] emacs-24 r117508: Clarify the doc strings of mouse-position and set-mouse-position. |
Date: |
Thu, 18 Sep 2014 17:21:37 +0000 |
User-agent: |
Bazaar (2.6b2) |
------------------------------------------------------------
revno: 117508
revision-id: address@hidden
parent: address@hidden
fixes bug: http://debbugs.gnu.org/18493
committer: Eli Zaretskii <address@hidden>
branch nick: emacs-24
timestamp: Thu 2014-09-18 20:20:57 +0300
message:
Clarify the doc strings of mouse-position and set-mouse-position.
src/frame.c (Fmouse_position, Fset_mouse_position): Clarify the
units in which the position is measured. (Bug#18493)
modified:
src/ChangeLog changelog-20091113204419-o5vbwnq5f7feedwu-1438
src/frame.c frame.c-20091113204419-o5vbwnq5f7feedwu-243
=== modified file 'src/ChangeLog'
--- a/src/ChangeLog 2014-09-18 15:10:33 +0000
+++ b/src/ChangeLog 2014-09-18 17:20:57 +0000
@@ -1,5 +1,8 @@
2014-09-18 Eli Zaretskii <address@hidden>
+ * frame.c (Fmouse_position, Fset_mouse_position): Clarify the
+ units in which the position is measured. (Bug#18493)
+
* xdisp.c (redisplay_internal): Force redisplay of all windows
that show a buffer whose narrowing has changed. (Bug#18490)
=== modified file 'src/frame.c'
--- a/src/frame.c 2014-06-30 16:45:38 +0000
+++ b/src/frame.c 2014-09-18 17:20:57 +0000
@@ -1524,9 +1524,9 @@
DEFUN ("mouse-position", Fmouse_position, Smouse_position, 0, 0, 0,
doc: /* Return a list (FRAME X . Y) giving the current mouse frame and
position.
-The position is given in character cells, where (0, 0) is the
-upper-left corner of the frame, X is the horizontal offset, and Y is
-the vertical offset.
+The position is given in canonical character cells, where (0, 0) is the
+upper-left corner of the frame, X is the horizontal offset, and Y is the
+vertical offset, measured in units of the frame's default character size.
If Emacs is running on a mouseless terminal or hasn't been programmed
to read the mouse position, it returns the selected frame for FRAME
and nil for X and Y.
@@ -1609,9 +1609,10 @@
so the coordinates of the top left character in the frame
may be nonzero due to left-hand scroll bars or the menu bar.
-The position is given in character cells, where (0, 0) is the
-upper-left corner of the frame, X is the horizontal offset, and Y is
-the vertical offset.
+The position is given in canonical character cells, where (0, 0) is
+the upper-left corner of the frame, X is the horizontal offset, and
+Y is the vertical offset, measured in units of the frame's default
+character size.
This function is a no-op for an X frame that is not visible.
If you have just created a frame, you must wait for it to become visible
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Emacs-diffs] emacs-24 r117508: Clarify the doc strings of mouse-position and set-mouse-position.,
Eli Zaretskii <=