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#18636: 24.4.50; doc of `display-monitor-attributes-list' - DISPLAY? FRAME? Date: Sun, 5 Oct 2014 19:41:21 -0700 (PDT) Message-ID: <2cb10ab0-7eb3-43a8-9fc2-72374602b55f@default> References: <<2382b3a5-6047-4b89-b211-3fef04714ae4@default>> <<83wq8emi60.fsf@gnu.org>> 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 1412563351 4321 80.91.229.3 (6 Oct 2014 02:42:31 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 6 Oct 2014 02:42:31 +0000 (UTC) Cc: 18636@debbugs.gnu.org To: Eli Zaretskii , Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Oct 06 04:42:24 2014 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 1XayFj-0002RE-K5 for geb-bug-gnu-emacs@m.gmane.org; Mon, 06 Oct 2014 04:42:23 +0200 Original-Received: from localhost ([::1]:49717 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XayFj-0001bh-9I for geb-bug-gnu-emacs@m.gmane.org; Sun, 05 Oct 2014 22:42:23 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:46689) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XayFX-0001bX-Q6 for bug-gnu-emacs@gnu.org; Sun, 05 Oct 2014 22:42:20 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XayFP-0000Nb-2u for bug-gnu-emacs@gnu.org; Sun, 05 Oct 2014 22:42:11 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:43562) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XayFO-0000NV-V7 for bug-gnu-emacs@gnu.org; Sun, 05 Oct 2014 22:42:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1XayFO-0002kQ-J9 for bug-gnu-emacs@gnu.org; Sun, 05 Oct 2014 22:42: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: Mon, 06 Oct 2014 02:42:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 18636 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 18636-submit@debbugs.gnu.org id=B18636.141256329410529 (code B ref 18636); Mon, 06 Oct 2014 02:42:02 +0000 Original-Received: (at 18636) by debbugs.gnu.org; 6 Oct 2014 02:41:34 +0000 Original-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 Original-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 Original-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 Original-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 Original-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 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)] X-Source-IP: acsinet22.oracle.com [141.146.126.238] 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:94193 Archived-At: > > 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.