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 7d600b5a0c53c82622d8326f174ca4c98cb4a1c1..e8765cf958e8ad7c11faacf17f0b667c69859470 100644 (file)
--- 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