From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#14801: 24.3.50; Document monitor attributes (e.g., `workarea' and `mm-size') Date: Fri, 5 Jul 2013 18:39:42 -0700 (PDT) Message-ID: <4e440cf0-eec8-485a-a00f-7710263e6677@default> References: NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1373074810 12399 80.91.229.3 (6 Jul 2013 01:40:10 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 6 Jul 2013 01:40:10 +0000 (UTC) Cc: 14801@debbugs.gnu.org To: YAMAMOTO Mitsuharu Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Jul 06 03:40:11 2013 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1UvHTt-0002z5-0F for geb-bug-gnu-emacs@m.gmane.org; Sat, 06 Jul 2013 03:40:09 +0200 Original-Received: from localhost ([::1]:41740 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UvHTs-000591-8m for geb-bug-gnu-emacs@m.gmane.org; Fri, 05 Jul 2013 21:40:08 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:47017) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UvHTp-00057G-0y for bug-gnu-emacs@gnu.org; Fri, 05 Jul 2013 21:40:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UvHTn-0004hc-MH for bug-gnu-emacs@gnu.org; Fri, 05 Jul 2013 21:40:04 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:38867) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UvHTn-0004gI-Hn for bug-gnu-emacs@gnu.org; Fri, 05 Jul 2013 21:40:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1UvHTm-00011N-Oh for bug-gnu-emacs@gnu.org; Fri, 05 Jul 2013 21:40:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 06 Jul 2013 01:40:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 14801 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 14801-submit@debbugs.gnu.org id=B14801.13730747953899 (code B ref 14801); Sat, 06 Jul 2013 01:40:02 +0000 Original-Received: (at 14801) by debbugs.gnu.org; 6 Jul 2013 01:39:55 +0000 Original-Received: from localhost ([127.0.0.1]:33183 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1UvHTe-00010n-Rg for submit@debbugs.gnu.org; Fri, 05 Jul 2013 21:39:55 -0400 Original-Received: from userp1040.oracle.com ([156.151.31.81]:28954) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1UvHTd-00010X-0l for 14801@debbugs.gnu.org; Fri, 05 Jul 2013 21:39:53 -0400 Original-Received: from ucsinet21.oracle.com (ucsinet21.oracle.com [156.151.31.93]) by userp1040.oracle.com (Sentrion-MTA-4.3.1/Sentrion-MTA-4.3.1) with ESMTP id r661dkSf028663 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sat, 6 Jul 2013 01:39:47 GMT Original-Received: from userz7021.oracle.com (userz7021.oracle.com [156.151.31.85]) by ucsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id r661djL5007551 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Sat, 6 Jul 2013 01:39:45 GMT Original-Received: from abhmt106.oracle.com (abhmt106.oracle.com [141.146.116.58]) by userz7021.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id r661diFq007542; Sat, 6 Jul 2013 01:39:45 GMT In-Reply-To: X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.7 (607090) [OL 12.0.6668.5000 (x86)] X-Source-IP: ucsinet21.oracle.com [156.151.31.93] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:75973 Archived-At: > > Monitor attributes are partially documented in `C-h f > > display-monitor-attributes-list'. They should also be (fully) > > documented in the Elisp manual. >=20 > Actually I was preparing for that. Great. Thanks for working on it. > See the bottom of this mail. >=20 > > Even in the doc string of d-m-a-l, the description is incomplete and > > needs to be filled out. >=20 > > Attribute `workareas' is described only in terms of "the workarea". > > There is no explanation of what is meant by "workarea" (which should > > presumably be two words, BTW). >=20 > While I was creating the docstring, I actually looked for the > definition of "workarea" in EWMH on which the implementation is based. > Unfortunately, it only says as "work area". >=20 > http://standards.freedesktop.org/wm-spec/1.3/ar01s03.html#id3075721 >=20 > But I've just found the GDK documentation has some explanation: "The > work area should be considered when positioning menus and similar > popups, to avoid placing them below panels, docks or other desktop > components." >=20 > https://developer.gnome.org/gdk3/3.8/GdkScreen.html#gdk-screen-get- > monitor-workarea >=20 > If it is allowed to use "panels", "docks" or "desktop components" > without their definitions, probably similar explanation of "work area" > can be provided. Thanks for trying to find out what it is. I don't understand, myself, but I'm not going to spend the time necessary to study this. What you might want to do, especially if things will remain only partly explained, is to refer readers to some such external reference for more info. I had no idea, for example, that this involved something called a work area that is defined externally (e.g. as part of a standard or similar). I thought it was just an Emacs thing. If it is only Emacs then we really need to specify it. But if it is defined elsewhere then we can just summarize and point to the external description for more information. > > Attribute `mm-size' is described only as "the width and height in > > millimeters". It's all very nice to say what the units are, but > > what is it that is being measured? The width & height of what? If > > it is the "work area" (whatever that might be) then say so > > explicitly. >=20 > Of the monitor. I thought it was obvious from the context. But I can > add "of the physical monitor" for clarity. Yes, thanks. > > Beyond all this, what on Earth IS a monitor "attribute"? Is it > > supposed to be the same thing as a frame parameter? >=20 > No. It is an alist describing some kinds of information about current > configuration of each physical monitor. I named it after "file > attributes". That's fine. Please just say that then: it is an alist of... And give a little more information to give a better idea. Just substituting "some kinds of information" for "attribute" won't get us very far. > The current draft of the Elisp manual begins like this: >=20 > @node Multiple Physical Monitors > @section Multiple Physical Monitors > @cindex multiple physical monitors >=20 > On some ``multi-monitor'' setups, a single graphical display outputs > to more than one physical monitor. You can get some kinds of > information on each physical monitor to examine the current monitor > configuration. Because the monitor configuration can be changed > dynamically in general, you should avoid reusing the information > obtained some time ago. >=20 > Information on each physical monitor is represented as > ``attributes'', an alist of attribute keys and values as follows: Sounds better already. Call them "monitor attributes", to be even clearer. Thx.