Improve documentation of 'display-monitor-attributes-

* doc/lispref/frames.texi (Multiple Terminals):
* lisp/frame.el (display-monitor-attributes-list): Better
documentation of what the 'source' key means on X.  (Bug#75936)
This commit is contained in:
Eli Zaretskii 2025-02-02 15:58:18 +02:00
parent ba27193895
commit 6d7e7899d8
2 changed files with 10 additions and 1 deletions

View file

@ -420,7 +420,12 @@ Name of the physical monitor as @var{string}.
@item source
Source of the multi-monitor information as @var{string};
e.g., @samp{XRandR 1.5}, @samp{XRandr} or @samp{Xinerama}.
on X, it could be @samp{XRandR 1.5}, @samp{XRandr}, @samp{Xinerama},
@samp{Gdk}, or @samp{fallback}. The last value of @samp{source} means
that Emacs was built without GTK and without XRandR or Xinerama
extensions, in which case the information about multiple physical
monitors will be provided as if they all as a whole formed a single
monitor.
@end table
@var{x}, @var{y}, @var{width}, and @var{height} are integers.

View file

@ -2465,6 +2465,10 @@ details depend on the platform and environment.
The `source' attribute describes the source from which the
information was obtained. On X, this may be one of: \"Gdk\",
\"XRandR 1.5\", \"XRandr\", \"Xinerama\", or \"fallback\".
If it is \"fallback\", it means Emacs was built without GTK
and without XrandR or Xinerama extensions, in which case the
information about multiple physical monitors will be provided
as if they all as a whole formed a single monitor.
A frame is dominated by a physical monitor when either the
largest area of the frame resides in the monitor, or the monitor