From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#18636: 24.4.50; doc of `display-monitor-attributes-list' - DISPLAY? FRAME? Date: Sun, 05 Oct 2014 22:27:03 +0300 Message-ID: <83wq8emi60.fsf@gnu.org> References: <2382b3a5-6047-4b89-b211-3fef04714ae4@default> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1412537304 22120 80.91.229.3 (5 Oct 2014 19:28:24 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 5 Oct 2014 19:28:24 +0000 (UTC) Cc: 18636@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Oct 05 21:28:17 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 1XarTd-0005Yc-7J for geb-bug-gnu-emacs@m.gmane.org; Sun, 05 Oct 2014 21:28:17 +0200 Original-Received: from localhost ([::1]:48479 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XarTc-0006o1-JP for geb-bug-gnu-emacs@m.gmane.org; Sun, 05 Oct 2014 15:28:16 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:46878) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XarTV-0006nt-26 for bug-gnu-emacs@gnu.org; Sun, 05 Oct 2014 15:28:14 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XarTP-0002VR-2A for bug-gnu-emacs@gnu.org; Sun, 05 Oct 2014 15:28:09 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:43356) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XarTO-0002VL-VY for bug-gnu-emacs@gnu.org; Sun, 05 Oct 2014 15:28:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1XarTO-0005ki-FO for bug-gnu-emacs@gnu.org; Sun, 05 Oct 2014 15:28:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 05 Oct 2014 19:28: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.141253722222039 (code B ref 18636); Sun, 05 Oct 2014 19:28:02 +0000 Original-Received: (at 18636) by debbugs.gnu.org; 5 Oct 2014 19:27:02 +0000 Original-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 Original-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 Original-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) Original-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) In-reply-to: <2382b3a5-6047-4b89-b211-3fef04714ae4@default> X-012-Sender: halo1@inter.net.il 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:94183 Archived-At: > 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.