emacs-diffs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Emacs-diffs] trunk r116575: Some doc about multi-monitor.


From: Xue Fuqiao
Subject: [Emacs-diffs] trunk r116575: Some doc about multi-monitor.
Date: Thu, 27 Feb 2014 10:22:20 +0000
User-agent: Bazaar (2.6b2)

------------------------------------------------------------
revno: 116575 [merge]
revision-id: address@hidden
parent: address@hidden
parent: address@hidden
committer: Xue Fuqiao <address@hidden>
branch nick: trunk
timestamp: Thu 2014-02-27 18:22:13 +0800
message:
  Some doc about multi-monitor.
  
  * doc/lispref/frames.texi (Multiple Terminals): Document
  `display-monitor-attributes-list' and `display-monitor-attributes'.
  (Display Feature Testing): Add some notes about multi-monitor.
  
  * etc/NEWS: Related edit.
modified:
  doc/lispref/ChangeLog          changelog-20091113204419-o5vbwnq5f7feedwu-6155
  doc/lispref/frames.texi        
frames.texi-20091113204419-o5vbwnq5f7feedwu-6180
=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2014-02-27 08:01:22 +0000
+++ b/doc/lispref/ChangeLog     2014-02-27 10:15:52 +0000
@@ -1,3 +1,9 @@
+2014-02-27  Xue Fuqiao  <address@hidden>
+
+       * frames.texi (Multiple Terminals): Document
+       `display-monitor-attributes-list' and `display-monitor-attributes'.
+       (Display Feature Testing): Add some notes about multi-monitor.
+
 2014-02-27  Glenn Morris  <address@hidden>
 
        * minibuf.texi (Programmed Completion):

=== modified file 'doc/lispref/frames.texi'
--- a/doc/lispref/frames.texi   2014-01-01 07:43:34 +0000
+++ b/doc/lispref/frames.texi   2014-02-27 10:15:52 +0000
@@ -266,10 +266,6 @@
 server, Emacs knows by the similarity in their names that they share a
 single keyboard.
 
-  On some ``multi-monitor'' setups, a single X display outputs to more
-than one physical monitor.  Currently, there is no way for Emacs to
-distinguish between the different physical monitors.
-
 @deffn Command make-frame-on-display display &optional parameters
 This function creates and returns a new frame on @var{display}, taking
 the other frame parameters from the alist @var{parameters}.
@@ -316,6 +312,61 @@
 on that display (@pxref{Deleting Frames}).
 @end defun
 
address@hidden multi-monitor
+  On some ``multi-monitor'' setups, a single X display outputs to more
+than one physical monitor.  @code{display-monitor-attributes-list} and
address@hidden can be used to obtain information
+about each physical monitor on multi-monitor setups.
+
address@hidden display-monitor-attributes-list &optional display
+This function returns a list of physical monitor attributes on
address@hidden  Each element of the list is an association list,
+representing the attributes of each physical monitor.  The first
+element corresponds to the primary monitor.
+
+Attributes for a physical monitor are:
+
address@hidden @samp
address@hidden geometry
+Position and size in pixels in the form of @samp{(X Y WIDTH HEIGHT)}
+
address@hidden workarea
+Position and size of the workarea in pixels in the form of @samp{(X Y
+WIDTH HEIGHT)}
+
address@hidden mm-size
+Width and height in millimeters in the form of @samp{(WIDTH HEIGHT)}
+
address@hidden frames
+List of frames dominated by the physical monitor
+
address@hidden name
+Name of the physical monitor as a string
address@hidden table
+
+where X, Y, WIDTH, and HEIGHT are integers.  @samp{name} is optional.
+
+A frame is dominated by a physical monitor when either the
+largest area of the frame resides in the monitor, or the monitor
+is the closest to the frame if the frame does not intersect any
+physical monitors.  Every non-tip frame (including invisible one)
+in a graphical display is dominated by exactly one physical
+monitor at a time, though it can span multiple (or no) physical
+monitors.
+
address@hidden defaults to the selected frame's display.
address@hidden defun
+
address@hidden frame-monitor-attributes &optional frame
+This function returns the attributes of the physical monitor
+dominating @var{frame}, which defaults to the selected frame.
+
+A frame is dominated by a physical monitor when either the
+largest area of the frame resides in the monitor, or the monitor
+is the closest to the frame if the frame does not intersect any
+physical monitors.
address@hidden defun
+
 @node Frame Parameters
 @section Frame Parameters
 @cindex frame parameters
@@ -2370,12 +2421,13 @@
 This function returns the number of screens associated with the display.
 @end defun
 
address@hidden FIXME: Document `x-display-pixel-{width, height}'?
 @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
+refers to the pixel height for all physical monitors associated with
 @var{display}.  @xref{Multiple Terminals}.
 @end defun
 
@@ -2388,14 +2440,23 @@
 @var{display}.  @xref{Multiple Terminals}.
 @end defun
 
address@hidden FIXME: Document `x-display-mm-{width, height}'?
 @defun display-mm-height &optional display
 This function returns the height of the screen in millimeters,
 or @code{nil} if Emacs cannot get that information.
+
+For graphical terminals, note that on ``multi-monitor'' setups this
+refers to the height for all physical monitors associated with
address@hidden  @xref{Multiple Terminals}.
 @end defun
 
 @defun display-mm-width &optional display
 This function returns the width of the screen in millimeters,
 or @code{nil} if Emacs cannot get that information.
+
+For graphical terminals, note that on ``multi-monitor'' setups this
+refers to the width for all physical monitors associated with
address@hidden  @xref{Multiple Terminals}.
 @end defun
 
 @defopt display-mm-dimensions-alist


reply via email to

[Prev in Thread] Current Thread [Next in Thread]