From: Po Lu <luangruo@yahoo.com>
Date: Sat, 21 May 2022 08:41:34 +0000 (+0800)
Subject: Improve doc for `display-monitors-changed-functions'
X-Git-Tag: emacs-29.0.90~1910^2~547
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=92fa0df30be7a4e3947cdeca89280947794ac7d6;p=emacs.git

Improve doc for `display-monitors-changed-functions'

* doc/lispref/frames.texi (Multiple Terminals): Describe how to
retrieve the new monitor configuration inside
`display-monitor-attributes-list'.
---

diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi
index 7d600b5a0c5..e8765cf958e 100644
--- a/doc/lispref/frames.texi
+++ b/doc/lispref/frames.texi
@@ -465,7 +465,9 @@ changes, which can happen if a monitor is rotated, moved, added or
 removed from a multiple-monitor setup, if the primary monitor changes,
 or if the resolution of a monitor changes.  It is called with a single
 argument consisting of the terminal on which the monitor configuration
-changed.
+changed.  Programs should call @code{display-monitor-attributes-list}
+with the terminal as the argument to retrieve the new monitor
+configuration on that terminal.
 @end defvar
 
 @node Frame Geometry