[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
emacs-29 e0bf2da3db6: ; More accurate doc strings for 'window-at' and 'w
From: |
Eli Zaretskii |
Subject: |
emacs-29 e0bf2da3db6: ; More accurate doc strings for 'window-at' and 'window-at-x-y'. |
Date: |
Sat, 4 Mar 2023 03:45:05 -0500 (EST) |
branch: emacs-29
commit e0bf2da3db69d074e16ceda3f2b5323f2d22d34b
Author: Eli Zaretskii <eliz@gnu.org>
Commit: Eli Zaretskii <eliz@gnu.org>
; More accurate doc strings for 'window-at' and 'window-at-x-y'.
* lisp/window.el (window-at-x-y):
* src/window.c (Fwindow_at): Doc fix. (Bug#61948)
---
lisp/window.el | 4 ++++
src/window.c | 7 +++++--
2 files changed, 9 insertions(+), 2 deletions(-)
diff --git a/lisp/window.el b/lisp/window.el
index 083fa9bfd2f..f6ddae854ad 100644
--- a/lisp/window.el
+++ b/lisp/window.el
@@ -4134,6 +4134,10 @@ X and Y are FRAME-relative pixel coordinates. A
coordinate on an
edge shared by two windows is attributed to the window on the
right (or below). Return nil if no such window can be found.
+Tool-bar and tab-bar pseudo-windows are ignored by this function:
+if the specified coordinates are in any of these two windows, this
+function returns nil.
+
Optional argument FRAME must specify a live frame and defaults to
the selected one. Optional argument NO-OTHER non-nil means to
return nil if the window located at the specified coordinates has
diff --git a/src/window.c b/src/window.c
index a94e1d611c7..0efd6813f8d 100644
--- a/src/window.c
+++ b/src/window.c
@@ -1729,8 +1729,11 @@ window_from_coordinates (struct frame *f, int x, int y,
DEFUN ("window-at", Fwindow_at, Swindow_at, 2, 3, 0,
doc: /* Return window containing coordinates X and Y on FRAME.
FRAME must be a live frame and defaults to the selected one.
-The top left corner of the frame is considered to be row 0,
-column 0. */)
+X and Y are measured in units of canonical columns and rows.
+The top left corner of the frame is considered to be column 0, row 0.
+Tool-bar and tab-bar pseudo-windows are ignored by this function: if
+the specified coordinates are in any of these two windows, this
+function returns nil. */)
(Lisp_Object x, Lisp_Object y, Lisp_Object frame)
{
struct frame *f = decode_live_frame (frame);
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- emacs-29 e0bf2da3db6: ; More accurate doc strings for 'window-at' and 'window-at-x-y'.,
Eli Zaretskii <=