# HG changeset patch
# User Chong Yidong <cyd@stupidchicken.com>
# Date 1176666087 0
# Node ID b5eba5af1ddd314561c84f9d5333fe0deb4baf5d
# Parent  da6fb52789db42dc8d2673975913d7bf1806d6cd
(Multiple Displays): Add note about "multi-monitor" setups.
(Display Feature Testing): Note that display refers to all
physical monitors for multi-monitor setups.

diff -r da6fb52789db -r b5eba5af1ddd lispref/frames.texi
--- a/lispref/frames.texi	Sun Apr 15 19:40:28 2007 +0000
+++ b/lispref/frames.texi	Sun Apr 15 19:41:27 2007 +0000
@@ -150,6 +150,13 @@
 names that they share a single keyboard, and it treats them as a single
 terminal.
 
+  Note that some graphical terminals can output to more than a one
+monitor (or other output device) at the same time.  On these
+``multi-monitor'' setups, a single @var{display} value controls the
+output to all the physical monitors.  In this situation, there is
+currently no platform-independent way for Emacs to distinguish between
+the different physical monitors.
+
 @deffn Command make-frame-on-display display &optional parameters
 This creates and returns a new frame on display @var{display}, taking
 the other frame parameters from @var{parameters}.  Aside from the
@@ -2089,11 +2096,19 @@
 @defun display-pixel-height &optional display
 This function returns the height of the screen in pixels.
 On a character terminal, it gives the height in characters.
+
+For graphical terminals, note that on ``multi-monitor'' setups this
+refers to the pixel width for all physical monitors associated with
+@var{display}.  @xref{Multiple Displays}.
 @end defun
 
 @defun display-pixel-width &optional display
 This function returns the width of the screen in pixels.
 On a character terminal, it gives the width in characters.
+
+For graphical terminals, note that on ``multi-monitor'' setups this
+refers to the pixel width for all physical monitors associated with
+@var{display}.  @xref{Multiple Displays}.
 @end defun
 
 @defun display-mm-height &optional display