From debbugs-submit-bounces@debbugs.gnu.org Sun Oct 05 15:05:56 2014 Received: (at submit) by debbugs.gnu.org; 5 Oct 2014 19:05:56 +0000 Received: from localhost ([127.0.0.1]:34910 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Xar7z-0005Dt-G0 for submit@debbugs.gnu.org; Sun, 05 Oct 2014 15:05:55 -0400 Received: from eggs.gnu.org ([208.118.235.92]:42325) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Xar7w-0005Dj-VF for submit@debbugs.gnu.org; Sun, 05 Oct 2014 15:05:53 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Xar7m-0002M2-E3 for submit@debbugs.gnu.org; Sun, 05 Oct 2014 15:05:52 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:37436) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xar7m-0002Ly-Bn for submit@debbugs.gnu.org; Sun, 05 Oct 2014 15:05:42 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:44020) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xar7d-0003tN-K8 for bug-gnu-emacs@gnu.org; Sun, 05 Oct 2014 15:05:42 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Xar7U-0002DR-Ps for bug-gnu-emacs@gnu.org; Sun, 05 Oct 2014 15:05:33 -0400 Received: from userp1040.oracle.com ([156.151.31.81]:45907) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xar7U-0002D5-EK for bug-gnu-emacs@gnu.org; Sun, 05 Oct 2014 15:05:24 -0400 Received: from acsinet22.oracle.com (acsinet22.oracle.com [141.146.126.238]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id s95J5MwD008249 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Sun, 5 Oct 2014 19:05:23 GMT Received: from userz7021.oracle.com (userz7021.oracle.com [156.151.31.85]) by acsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id s95J5LwF019447 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL) for ; Sun, 5 Oct 2014 19:05:22 GMT Received: from abhmp0014.oracle.com (abhmp0014.oracle.com [141.146.116.20]) by userz7021.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id s95J5L8i025041 for ; Sun, 5 Oct 2014 19:05:21 GMT MIME-Version: 1.0 Message-ID: <2382b3a5-6047-4b89-b211-3fef04714ae4@default> Date: Sun, 5 Oct 2014 12:05:19 -0700 (PDT) From: Drew Adams To: bug-gnu-emacs@gnu.org Subject: 24.4.50; doc of `display-monitor-attributes-list' - DISPLAY? FRAME? X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8.2 (807160) [OL 12.0.6691.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: acsinet22.oracle.com [141.146.126.238] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.0 (----) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -4.0 (----) I find it unclear that the optional parameter of `display-monitor-attributes-list' is named DISPLAY, and is referred to as a display in the doc string, and yet in `frame-monitor-attributes' it is arg FRAME that is passed to `display-monitor-attributes-list'. Is the argument of `display-monitor-attributes-list' a display or a frame? What about other functions, such as `display-pixel-height', which call `display-monitor-attributes-list'? They seem to pass their DISPLAY arg to it. Is this arg too something that can be (or is always?) a frame? The doc string of `display-pixel-height' (for example) says: "If DISPLAY is omitted or nil, it defaults to the selected frame's display." That would seem to suggest that a frame is not a display, but rather it _has_ a display. And there is a frame parameter `display', whose value is "The display on which to open this frame. It should be a string of the form `"HOST:DPY.SCREEN"', just like the `DISPLAY' environment variable. This suggests that a display is not a frame. So how is it that `frame-monitor-attributes' passes a FRAME to `display-monitor-attributes-list', which supposedly expects a display instead? Please try to clear up some of this confusion in the doc and doc strings. In GNU Emacs 24.4.50.1 (i686-pc-mingw32) of 2014-09-15 on LEG570 Bzr revision: 117884 dancol@dancol.org-20140915050944-sqsajysnwef51f9m Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --enable-checking 'CFLAGS=3D-O0 -g3' CPPFLAGS=3D-DGLYPH_DEBUG= =3D1' From debbugs-submit-bounces@debbugs.gnu.org Sun Oct 05 15:27:02 2014 Received: (at 18636) by debbugs.gnu.org; 5 Oct 2014 19:27:02 +0000 Received: from localhost ([127.0.0.1]:34920 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1XarSP-0005jP-O1 for submit@debbugs.gnu.org; Sun, 05 Oct 2014 15:27:02 -0400 Received: from mtaout25.012.net.il ([80.179.55.181]:50798) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1XarSM-0005iy-An for 18636@debbugs.gnu.org; Sun, 05 Oct 2014 15:26:59 -0400 Received: from conversion-daemon.mtaout25.012.net.il by mtaout25.012.net.il (HyperSendmail v2007.08) id <0NCZ00P00KAF7D00@mtaout25.012.net.il> for 18636@debbugs.gnu.org; Sun, 05 Oct 2014 22:22:07 +0300 (IDT) Received: from HOME-C4E4A596F7 ([87.69.4.28]) by mtaout25.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0NCZ00H5VKGVV270@mtaout25.012.net.il>; Sun, 05 Oct 2014 22:22:07 +0300 (IDT) Date: Sun, 05 Oct 2014 22:27:03 +0300 From: Eli Zaretskii Subject: Re: bug#18636: 24.4.50; doc of `display-monitor-attributes-list' - DISPLAY? FRAME? In-reply-to: <2382b3a5-6047-4b89-b211-3fef04714ae4@default> X-012-Sender: halo1@inter.net.il To: Drew Adams Message-id: <83wq8emi60.fsf@gnu.org> References: <2382b3a5-6047-4b89-b211-3fef04714ae4@default> X-Spam-Score: 1.0 (+) X-Debbugs-Envelope-To: 18636 Cc: 18636@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list Reply-To: Eli Zaretskii List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 1.0 (+) > Date: Sun, 5 Oct 2014 12:05:19 -0700 (PDT) > From: Drew Adams > > I find it unclear that the optional parameter of > `display-monitor-attributes-list' is named DISPLAY, and is referred to > as a display in the doc string, and yet in `frame-monitor-attributes' > it is arg FRAME that is passed to `display-monitor-attributes-list'. > > Is the argument of `display-monitor-attributes-list' a display or a > frame? It can be either. > What about other functions, such as `display-pixel-height', which call > `display-monitor-attributes-list'? They seem to pass their DISPLAY arg > to it. Is this arg too something that can be (or is always?) a frame? > The doc string of `display-pixel-height' (for example) says: > > "If DISPLAY is omitted or nil, it defaults to the selected frame's > display." > > That would seem to suggest that a frame is not a display, but rather it > _has_ a display. A frame is not a display, but these functions accept either one. If you make a list of the functions where the doc string is not explicit about this fact, I will fix them. From debbugs-submit-bounces@debbugs.gnu.org Sun Oct 05 22:41:34 2014 Received: (at 18636) by debbugs.gnu.org; 6 Oct 2014 02:41:34 +0000 Received: from localhost ([127.0.0.1]:35126 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1XayEv-0002jk-TZ for submit@debbugs.gnu.org; Sun, 05 Oct 2014 22:41:34 -0400 Received: from aserp1040.oracle.com ([141.146.126.69]:25775) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1XayEs-0002jb-QP for 18636@debbugs.gnu.org; Sun, 05 Oct 2014 22:41:31 -0400 Received: from acsinet22.oracle.com (acsinet22.oracle.com [141.146.126.238]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id s962fRnD032726 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Mon, 6 Oct 2014 02:41:29 GMT Received: from userz7022.oracle.com (userz7022.oracle.com [156.151.31.86]) by acsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id s962fQ3e026978 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Mon, 6 Oct 2014 02:41:27 GMT Received: from abhmp0014.oracle.com (abhmp0014.oracle.com [141.146.116.20]) by userz7022.oracle.com (8.14.5+Sun/8.14.4) with ESMTP id s962fPA9021107; Mon, 6 Oct 2014 02:41:26 GMT MIME-Version: 1.0 Message-ID: <2cb10ab0-7eb3-43a8-9fc2-72374602b55f@default> Date: Sun, 5 Oct 2014 19:41:21 -0700 (PDT) From: Drew Adams To: Eli Zaretskii , Drew Adams Subject: RE: bug#18636: 24.4.50; doc of `display-monitor-attributes-list' - DISPLAY? FRAME? References: <<2382b3a5-6047-4b89-b211-3fef04714ae4@default>> <<83wq8emi60.fsf@gnu.org>> In-Reply-To: <<83wq8emi60.fsf@gnu.org>> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8.2 (807160) [OL 12.0.6691.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: acsinet22.oracle.com [141.146.126.238] X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 18636 Cc: 18636@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.3 (--) > > I find it unclear that the optional parameter of > > `display-monitor-attributes-list' is named DISPLAY, and is > > referred to as a display in the doc string, and yet in > > `frame-monitor-attributes' it is arg FRAME that is passed > > to `display-monitor-attributes-list'. > > > > Is the argument of `display-monitor-attributes-list' a > > display or a frame? >=20 > It can be either. OK. Then the doc should say so. And it should call out the relation between the two. For example, if a frame is passed and its display is used (=3D its `display' frame parameter), then say so. > > What about other functions, such as `display-pixel-height', which > > call `display-monitor-attributes-list'? They seem to pass their > > DISPLAY arg to it. Is this arg too something that can be (or > > is always?) a frame? The doc string of `display-pixel-height' > > (for example) says: > > > > "If DISPLAY is omitted or nil, it defaults to the selected > > frame's display." > > > > That would seem to suggest that a frame is not a display, but > > rather it _has_ a display. >=20 > A frame is not a display, but these functions accept either one. Their doc should say so. > If you make a list of the functions where the doc string is not > explicit about this fact, I will fix them. Thank you. I think this is the case for all of the 20 functions described in (elisp) `Display Feature Testing', but there might be others as well. From debbugs-submit-bounces@debbugs.gnu.org Wed Oct 08 06:23:53 2014 Received: (at 18636-done) by debbugs.gnu.org; 8 Oct 2014 10:23:54 +0000 Received: from localhost ([127.0.0.1]:37426 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1XboPR-0001XB-8T for submit@debbugs.gnu.org; Wed, 08 Oct 2014 06:23:53 -0400 Received: from mtaout23.012.net.il ([80.179.55.175]:62975) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1XboPN-0001Wz-Vz for 18636-done@debbugs.gnu.org; Wed, 08 Oct 2014 06:23:51 -0400 Received: from conversion-daemon.a-mtaout23.012.net.il by a-mtaout23.012.net.il (HyperSendmail v2007.08) id <0ND400500F8HG700@a-mtaout23.012.net.il> for 18636-done@debbugs.gnu.org; Wed, 08 Oct 2014 13:23:48 +0300 (IDT) Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout23.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0ND4005A6FJNBQ90@a-mtaout23.012.net.il>; Wed, 08 Oct 2014 13:23:48 +0300 (IDT) Date: Wed, 08 Oct 2014 13:24:01 +0300 From: Eli Zaretskii Subject: Re: bug#18636: 24.4.50; doc of `display-monitor-attributes-list' - DISPLAY? FRAME? In-reply-to: <2cb10ab0-7eb3-43a8-9fc2-72374602b55f@default> X-012-Sender: halo1@inter.net.il To: Drew Adams Message-id: <83oatmkgfy.fsf@gnu.org> References: <2cb10ab0-7eb3-43a8-9fc2-72374602b55f@default> X-Spam-Score: 1.0 (+) X-Debbugs-Envelope-To: 18636-done Cc: 18636-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list Reply-To: Eli Zaretskii List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 1.0 (+) > Date: Sun, 5 Oct 2014 19:41:21 -0700 (PDT) > From: Drew Adams > Cc: 18636@debbugs.gnu.org > > > > I find it unclear that the optional parameter of > > > `display-monitor-attributes-list' is named DISPLAY, and is > > > referred to as a display in the doc string, and yet in > > > `frame-monitor-attributes' it is arg FRAME that is passed > > > to `display-monitor-attributes-list'. > > > > > > Is the argument of `display-monitor-attributes-list' a > > > display or a frame? > > > > It can be either. > > OK. Then the doc should say so. Done on the emacs-24 branch (revision 117559). > And it should call out the > relation between the two. For example, if a frame is passed > and its display is used (= its `display' frame parameter), > then say so. That's not what happens, though. Each function extracts the info it needs from whatever kind of argument it is passed, and then uses that info. > > > What about other functions, such as `display-pixel-height', which > > > call `display-monitor-attributes-list'? They seem to pass their > > > DISPLAY arg to it. Is this arg too something that can be (or > > > is always?) a frame? The doc string of `display-pixel-height' > > > (for example) says: > > > > > > "If DISPLAY is omitted or nil, it defaults to the selected > > > frame's display." > > > > > > That would seem to suggest that a frame is not a display, but > > > rather it _has_ a display. > > > > A frame is not a display, but these functions accept either one. > > Their doc should say so. Done. > > If you make a list of the functions where the doc string is not > > explicit about this fact, I will fix them. > > Thank you. I think this is the case for all of the 20 functions > described in (elisp) `Display Feature Testing', but there might > be others as well. Done. > > > In (elisp) `Basic Parameters' I see this description of frame > > > parameter `display': > > > > > > The display on which to open this frame. It should be a string > > > of the form `"HOST:DPY.SCREEN"', just like the `DISPLAY' > > > environment variable. > > > > > > But if I evaluate `(frame-parameters)' on MS Windows I see this > > > value for parameter `display': "w32". > > > > > > "w32" does not seem to fit the form `"HOST:DPY.SCREEN"'. What > > > gives? > > > > Emacs on MS-Windows doesn't support the notion of 'display', so all > > frames return the same value of that parameter. > > OK, then the doc should mention this, or at least say that the > string might not take the form "HOST:DPY.SCREEN" on some platforms, > and preferably say something about what to expect on the > exceptional platforms (and perhaps give some idea of what use the > exceptional value is - what it can be used for, or what info it > conveys). Done. > > > And why is that string surrounded by `...'? > > > > An artifact of Texinfo markup. > > I see. Is that then correct, or should the `...' be absent? > There are strings in the manual that are not surrounded by `...'. I fixed the markup. > > > And why aren't the components of that "form" described: What are > > > acceptable values for HOST, DPY, and SCREEN? > > > > Users on X already know what they are; users on other systems don't > > need to know, because this is not supported. Either way, this > > notion is not an Emacs invention, it is a feature of the X > > window system. > > Then please say that. E.g., say that the value is useful only for > X Window, or only relevant for it. If the function itself has no > use beyond X Window, then please make that clear. Done, and also improved the description of the X form. > From: Andy Moreton > Date: Tue, 07 Oct 2014 19:35:28 +0100 > > > Oh, and I think this is no longer about the docs, so probably a new > > bug report is in order, specifically about restoring frames on > > multi-monitor displays. > True, as long as the meaning of geometry/workarea and the coordinate > system are given a little more detail in the docs. Done. I'm closing this bug. From debbugs-submit-bounces@debbugs.gnu.org Wed Oct 08 06:45:30 2014 Received: (at submit) by debbugs.gnu.org; 8 Oct 2014 10:45:30 +0000 Received: from localhost ([127.0.0.1]:37441 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1XbokM-00028M-3N for submit@debbugs.gnu.org; Wed, 08 Oct 2014 06:45:30 -0400 Received: from eggs.gnu.org ([208.118.235.92]:45696) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1XbokH-00028B-F2 for submit@debbugs.gnu.org; Wed, 08 Oct 2014 06:45:26 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Xbok6-0006pi-T9 for submit@debbugs.gnu.org; Wed, 08 Oct 2014 06:45:24 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50,FREEMAIL_FROM autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:44014) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xbok6-0006pe-RC for submit@debbugs.gnu.org; Wed, 08 Oct 2014 06:45:14 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:47345) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xbojz-00035W-Aq for bug-gnu-emacs@gnu.org; Wed, 08 Oct 2014 06:45:14 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Xbojr-0006TT-RI for bug-gnu-emacs@gnu.org; Wed, 08 Oct 2014 06:45:07 -0400 Received: from plane.gmane.org ([80.91.229.3]:56916) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xbojr-0006TB-LP for bug-gnu-emacs@gnu.org; Wed, 08 Oct 2014 06:44:59 -0400 Received: from list by plane.gmane.org with local (Exim 4.69) (envelope-from ) id 1Xbojo-0005KY-Pq for bug-gnu-emacs@gnu.org; Wed, 08 Oct 2014 12:44:56 +0200 Received: from uk.solarflare.com ([193.34.186.16]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Wed, 08 Oct 2014 12:44:56 +0200 Received: from andrewjmoreton by uk.solarflare.com with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Wed, 08 Oct 2014 12:44:56 +0200 X-Injected-Via-Gmane: http://gmane.org/ To: bug-gnu-emacs@gnu.org From: Andy Moreton Subject: Re: bug#18636: 24.4.50; doc of `display-monitor-attributes-list' - DISPLAY? FRAME? Date: Wed, 08 Oct 2014 11:44:45 +0100 Lines: 15 Message-ID: References: <2cb10ab0-7eb3-43a8-9fc2-72374602b55f@default> <83oatmkgfy.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain X-Complaints-To: usenet@ger.gmane.org X-Gmane-NNTP-Posting-Host: uk.solarflare.com User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.50 (windows-nt) Cancel-Lock: sha1:6gT2w5nx5OaY78MWyJu7Xeu7diM= X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.1 (----) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -4.1 (----) On Wed 08 Oct 2014, Eli Zaretskii wrote: > Done on the emacs-24 branch (revision 117559). Thanks for doing this Eli. The lisp example you added for 'display-monitor-attributes-list' contains a typo from my email: (((geometry 0 0 1920 1080) ;; Left hand monitor (workarea 0 0 1920 1050) ;; Bottom of screen used for task bar task bar The third line containing "task bar" should be removed as it should have been part of the comment on the previous line. Sorry! AndyM From debbugs-submit-bounces@debbugs.gnu.org Wed Oct 08 07:17:33 2014 Received: (at 18636) by debbugs.gnu.org; 8 Oct 2014 11:17:34 +0000 Received: from localhost ([127.0.0.1]:37456 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1XbpFN-0002uP-Ax for submit@debbugs.gnu.org; Wed, 08 Oct 2014 07:17:33 -0400 Received: from mtaout25.012.net.il ([80.179.55.181]:48899) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1XbpFJ-0002uE-PG for 18636@debbugs.gnu.org; Wed, 08 Oct 2014 07:17:31 -0400 Received: from conversion-daemon.mtaout25.012.net.il by mtaout25.012.net.il (HyperSendmail v2007.08) id <0ND400O00HHF5K00@mtaout25.012.net.il> for 18636@debbugs.gnu.org; Wed, 08 Oct 2014 14:12:40 +0300 (IDT) Received: from HOME-C4E4A596F7 ([87.69.4.28]) by mtaout25.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0ND400JN9HT4XU50@mtaout25.012.net.il>; Wed, 08 Oct 2014 14:12:40 +0300 (IDT) Date: Wed, 08 Oct 2014 14:17:41 +0300 From: Eli Zaretskii Subject: Re: bug#18636: 24.4.50; doc of `display-monitor-attributes-list' - DISPLAY? FRAME? In-reply-to: X-012-Sender: halo1@inter.net.il To: Andy Moreton Message-id: <83k34akdyi.fsf@gnu.org> References: <2cb10ab0-7eb3-43a8-9fc2-72374602b55f@default> <83oatmkgfy.fsf@gnu.org> X-Spam-Score: 1.0 (+) X-Debbugs-Envelope-To: 18636 Cc: 18636@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list Reply-To: Eli Zaretskii List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 1.0 (+) > From: Andy Moreton > Date: Wed, 08 Oct 2014 11:44:45 +0100 > > On Wed 08 Oct 2014, Eli Zaretskii wrote: > > > Done on the emacs-24 branch (revision 117559). > > Thanks for doing this Eli. The lisp example you added for > 'display-monitor-attributes-list' contains a typo from my email: > > (((geometry 0 0 1920 1080) ;; Left hand monitor > (workarea 0 0 1920 1050) ;; Bottom of screen used for task bar > task bar > > The third line containing "task bar" should be removed as it should have > been part of the comment on the previous line. Sorry! Thanks, fixed. From debbugs-submit-bounces@debbugs.gnu.org Wed Oct 08 09:20:56 2014 Received: (at 18636-done) by debbugs.gnu.org; 8 Oct 2014 13:20:56 +0000 Received: from localhost ([127.0.0.1]:37550 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1XbrAl-0007C7-Ha for submit@debbugs.gnu.org; Wed, 08 Oct 2014 09:20:55 -0400 Received: from userp1040.oracle.com ([156.151.31.81]:29984) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1XbrAj-0007Bz-IT for 18636-done@debbugs.gnu.org; Wed, 08 Oct 2014 09:20:54 -0400 Received: from ucsinet22.oracle.com (ucsinet22.oracle.com [156.151.31.94]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id s98DKqwK001790 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Wed, 8 Oct 2014 13:20:52 GMT Received: from aserz7021.oracle.com (aserz7021.oracle.com [141.146.126.230]) by ucsinet22.oracle.com (8.14.5+Sun/8.14.5) with ESMTP id s98DKoSO024131 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Wed, 8 Oct 2014 13:20:51 GMT Received: from abhmp0014.oracle.com (abhmp0014.oracle.com [141.146.116.20]) by aserz7021.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id s98DKnJ7029758; Wed, 8 Oct 2014 13:20:49 GMT MIME-Version: 1.0 Message-ID: <986f56fa-af7e-4843-a0fa-047b2f49fb18@default> Date: Wed, 8 Oct 2014 06:20:49 -0700 (PDT) From: Drew Adams To: Eli Zaretskii Subject: RE: bug#18636: 24.4.50; doc of `display-monitor-attributes-list' - DISPLAY? FRAME? References: <<2cb10ab0-7eb3-43a8-9fc2-72374602b55f@default>> <<83oatmkgfy.fsf@gnu.org>> In-Reply-To: <<83oatmkgfy.fsf@gnu.org>> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8.2 (807160) [OL 12.0.6691.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: ucsinet22.oracle.com [156.151.31.94] X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 18636-done Cc: 18636-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.3 (--) > > > > Is the argument of `display-monitor-attributes-list' a > > > > display or a frame? > > > > > > It can be either. > > OK. Then the doc should say so. > Done on the emacs-24 branch (revision 117559). Thanks. > > And it should call out the > > relation between the two. For example, if a frame is passed > > and its display is used (=3D its `display' frame parameter), > > then say so. >=20 > That's not what happens, though. Each function extracts the info it > needs from whatever kind of argument it is passed, and then uses > that info. I said, "For example". Whatever the actual relation between the two is, it should be described. (Descriptions like "the information it needs" and "that info" are OK for here, but would not be helpful in the doc string.) > Done. > Done. > Done. > I fixed the markup. > Done, and also improved the description of the X form. > Done. Thx * 6. > I'm closing this bug. Great. Thanks. (Haven't seen the result yet, but I'm sure it's good.) From debbugs-submit-bounces@debbugs.gnu.org Wed Oct 08 09:32:34 2014 Received: (at 18636) by debbugs.gnu.org; 8 Oct 2014 13:32:34 +0000 Received: from localhost ([127.0.0.1]:37558 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1XbrM1-0007Su-CC for submit@debbugs.gnu.org; Wed, 08 Oct 2014 09:32:33 -0400 Received: from mtaout29.012.net.il ([80.179.55.185]:56054) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1XbrLv-0007Se-DV for 18636@debbugs.gnu.org; Wed, 08 Oct 2014 09:32:28 -0400 Received: from conversion-daemon.mtaout29.012.net.il by mtaout29.012.net.il (HyperSendmail v2007.08) id <0ND400N00NHJLW00@mtaout29.012.net.il> for 18636@debbugs.gnu.org; Wed, 08 Oct 2014 16:31:34 +0300 (IDT) Received: from HOME-C4E4A596F7 ([87.69.4.28]) by mtaout29.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0ND400JVVO8MBP60@mtaout29.012.net.il>; Wed, 08 Oct 2014 16:31:34 +0300 (IDT) Date: Wed, 08 Oct 2014 16:32:38 +0300 From: Eli Zaretskii Subject: Re: bug#18636: 24.4.50; doc of `display-monitor-attributes-list' - DISPLAY? FRAME? In-reply-to: <986f56fa-af7e-4843-a0fa-047b2f49fb18@default> X-012-Sender: halo1@inter.net.il To: Drew Adams Message-id: <83a956k7pl.fsf@gnu.org> References: <2cb10ab0-7eb3-43a8-9fc2-72374602b55f@default> <83oatmkgfy.fsf@gnu.org> <986f56fa-af7e-4843-a0fa-047b2f49fb18@default> X-Spam-Score: 1.0 (+) X-Debbugs-Envelope-To: 18636 Cc: 18636@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list Reply-To: Eli Zaretskii List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 1.0 (+) > Date: Wed, 8 Oct 2014 06:20:49 -0700 (PDT) > From: Drew Adams > Cc: 18636-done@debbugs.gnu.org > > > > And it should call out the > > > relation between the two. For example, if a frame is passed > > > and its display is used (= its `display' frame parameter), > > > then say so. > > > > That's not what happens, though. Each function extracts the info it > > needs from whatever kind of argument it is passed, and then uses > > that info. > > I said, "For example". Whatever the actual relation between the > two is, it should be described. (Descriptions like "the information > it needs" and "that info" are OK for here, but would not be helpful > in the doc string.) I'm not sure what you think the documentation should tell about this, and why. Each function needs something different from its argument; surely, describing all that in the doc string is counter-productive. Whoever needs those details, should read the code. IOW, what other details are required to correctly invoke and use these functions? From debbugs-submit-bounces@debbugs.gnu.org Wed Oct 08 10:05:00 2014 Received: (at 18636) by debbugs.gnu.org; 8 Oct 2014 14:05:01 +0000 Received: from localhost ([127.0.0.1]:38140 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1XbrrP-0008LQ-TX for submit@debbugs.gnu.org; Wed, 08 Oct 2014 10:05:00 -0400 Received: from aserp1040.oracle.com ([141.146.126.69]:17087) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1XbrrN-0008LH-Jc for 18636@debbugs.gnu.org; Wed, 08 Oct 2014 10:04:58 -0400 Received: from acsinet22.oracle.com (acsinet22.oracle.com [141.146.126.238]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id s98E4ts3013435 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Wed, 8 Oct 2014 14:04:56 GMT Received: from userz7022.oracle.com (userz7022.oracle.com [156.151.31.86]) by acsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id s98E4q32018892 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Wed, 8 Oct 2014 14:04:54 GMT Received: from abhmp0014.oracle.com (abhmp0014.oracle.com [141.146.116.20]) by userz7022.oracle.com (8.14.5+Sun/8.14.4) with ESMTP id s98E4pKc018268; Wed, 8 Oct 2014 14:04:52 GMT MIME-Version: 1.0 Message-ID: Date: Wed, 8 Oct 2014 07:04:51 -0700 (PDT) From: Drew Adams To: Eli Zaretskii Subject: RE: bug#18636: 24.4.50; doc of `display-monitor-attributes-list' - DISPLAY? FRAME? References: <<2cb10ab0-7eb3-43a8-9fc2-72374602b55f@default>> <<83oatmkgfy.fsf@gnu.org>> <<986f56fa-af7e-4843-a0fa-047b2f49fb18@default>> <<83a956k7pl.fsf@gnu.org>> In-Reply-To: <<83a956k7pl.fsf@gnu.org>> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8.2 (807160) [OL 12.0.6691.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: acsinet22.oracle.com [141.146.126.238] X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 18636 Cc: 18636@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.3 (--) > > > > And it should call out the > > > > relation between the two. For example, if a frame is passed > > > > and its display is used (=3D its `display' frame parameter), > > > > then say so. > > > > > > That's not what happens, though. Each function extracts the > > > info it needs from whatever kind of argument it is passed, and > > > then uses that info. > > > > I said, "For example". Whatever the actual relation between the > > two is, it should be described. (Descriptions like "the > > information it needs" and "that info" are OK for here, but would > > not be helpful in the doc string.) >=20 > I'm not sure what you think the documentation should tell about > this, and why. Each function needs something different from its argument= ; > surely, describing all that in the doc string is counter-productive. > Whoever needs those details, should read the code. >=20 > IOW, what other details are required to correctly invoke and use > these functions? Dunno what other details are needed to understand these functions. That was the point. I'm not looking for implementation details. I'm guessing that a description of the function, and a good understanding of it, involves some description/understanding of the argument and what it means to the function. What the function needs it for - not in terms of just what it does with it, but in logical terms - why it is required. Maybe no more info is needed - dunno. But usually a user can tell why a given argument might have a value of different types, e.g. a buffer or a string that names a buffer. The connection here, between a frame arg value and a display arg value, is not obvious. I was guessing that what the function needs, ultimately, is a display, and that if given a frame it uses the frame's display. But apparently=20 that is not the connection. I'm in the dark on this. Use your own judgment. If you think nothing is unclear or missing, that's good enough for me. From debbugs-submit-bounces@debbugs.gnu.org Wed Oct 08 10:10:23 2014 Received: (at 18636) by debbugs.gnu.org; 8 Oct 2014 14:10:23 +0000 Received: from localhost ([127.0.0.1]:38155 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Xbrwc-0008Ta-Ig for submit@debbugs.gnu.org; Wed, 08 Oct 2014 10:10:23 -0400 Received: from mtaout23.012.net.il ([80.179.55.175]:36874) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1XbrwZ-0008TR-FG for 18636@debbugs.gnu.org; Wed, 08 Oct 2014 10:10:20 -0400 Received: from conversion-daemon.a-mtaout23.012.net.il by a-mtaout23.012.net.il (HyperSendmail v2007.08) id <0ND400600PGE4P00@a-mtaout23.012.net.il> for 18636@debbugs.gnu.org; Wed, 08 Oct 2014 17:10:17 +0300 (IDT) Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout23.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0ND4005XWQ15UX70@a-mtaout23.012.net.il>; Wed, 08 Oct 2014 17:10:17 +0300 (IDT) Date: Wed, 08 Oct 2014 17:10:31 +0300 From: Eli Zaretskii Subject: Re: bug#18636: 24.4.50; doc of `display-monitor-attributes-list' - DISPLAY? FRAME? In-reply-to: X-012-Sender: halo1@inter.net.il To: Drew Adams Message-id: <8338ayk5yg.fsf@gnu.org> References: X-Spam-Score: 1.0 (+) X-Debbugs-Envelope-To: 18636 Cc: 18636@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list Reply-To: Eli Zaretskii List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 1.0 (+) > Date: Wed, 8 Oct 2014 07:04:51 -0700 (PDT) > From: Drew Adams > Cc: 18636@debbugs.gnu.org > > > IOW, what other details are required to correctly invoke and use > > these functions? > > Dunno what other details are needed to understand these functions. > That was the point. > > I'm not looking for implementation details. I'm guessing that a > description of the function, and a good understanding of it, involves > some description/understanding of the argument and what it means > to the function. What the function needs it for - not in terms of > just what it does with it, but in logical terms - why it is required. > > Maybe no more info is needed - dunno. But usually a user can tell > why a given argument might have a value of different types, e.g. a > buffer or a string that names a buffer. The connection here, between > a frame arg value and a display arg value, is not obvious. I was > guessing that what the function needs, ultimately, is a display, and > that if given a frame it uses the frame's display. But apparently > that is not the connection. > > I'm in the dark on this. Use your own judgment. If you think > nothing is unclear or missing, that's good enough for me. In my judgment, nothing else is needed. Most functions just need the type of the frames on display, which can be gleaned from any of the possible argument types. The other need the screen used by the display, which again can be gotten from any argument type. IOW, these arguments serve as proxies to the information needed by the functions. From unknown Sat Aug 16 21:22:46 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Thu, 06 Nov 2014 12:24:03 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator