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#19461: 25.0.50; doc of `display-buffer-*' functions that take ALIST arg Date: Sun, 28 Dec 2014 12:50:04 -0800 (PST) Message-ID: <97135b13-1c29-44a9-bfd9-f12966e56cd4@default> 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 1419799880 18947 80.91.229.3 (28 Dec 2014 20:51:20 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 28 Dec 2014 20:51:20 +0000 (UTC) To: 19461@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Dec 28 21:51:13 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 1Y5Knx-00019K-4R for geb-bug-gnu-emacs@m.gmane.org; Sun, 28 Dec 2014 21:51:13 +0100 Original-Received: from localhost ([::1]:59417 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Y5Knw-0005dV-IS for geb-bug-gnu-emacs@m.gmane.org; Sun, 28 Dec 2014 15:51:12 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:35774) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Y5Kns-0005b2-3h for bug-gnu-emacs@gnu.org; Sun, 28 Dec 2014 15:51:08 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Y5Knm-00024A-DX for bug-gnu-emacs@gnu.org; Sun, 28 Dec 2014 15:51:08 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:50599) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Y5Knm-000241-9s for bug-gnu-emacs@gnu.org; Sun, 28 Dec 2014 15:51:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1Y5Knl-0000MM-VZ for bug-gnu-emacs@gnu.org; Sun, 28 Dec 2014 15:51:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 28 Dec 2014 20:51:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 19461 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.14197998151319 (code B ref -1); Sun, 28 Dec 2014 20:51:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 28 Dec 2014 20:50:15 +0000 Original-Received: from localhost ([127.0.0.1]:59965 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Y5Kn0-0000LD-P9 for submit@debbugs.gnu.org; Sun, 28 Dec 2014 15:50:15 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:33786) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Y5Kmz-0000L4-3U for submit@debbugs.gnu.org; Sun, 28 Dec 2014 15:50:13 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Y5Kmx-0001tG-RX for submit@debbugs.gnu.org; Sun, 28 Dec 2014 15:50:12 -0500 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:48742) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Y5Kmx-0001tB-JQ for submit@debbugs.gnu.org; Sun, 28 Dec 2014 15:50:11 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:35506) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Y5Kmw-0005VI-GB for bug-gnu-emacs@gnu.org; Sun, 28 Dec 2014 15:50:11 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Y5Kmr-0001mY-HE for bug-gnu-emacs@gnu.org; Sun, 28 Dec 2014 15:50:10 -0500 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:35667) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Y5Kmr-0001j6-Bi for bug-gnu-emacs@gnu.org; Sun, 28 Dec 2014 15:50:05 -0500 Original-Received: from ucsinet22.oracle.com (ucsinet22.oracle.com [156.151.31.94]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id sBSKo3nb006321 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Sun, 28 Dec 2014 20:50:04 GMT Original-Received: from userz7022.oracle.com (userz7022.oracle.com [156.151.31.86]) by ucsinet22.oracle.com (8.14.5+Sun/8.14.5) with ESMTP id sBSKo3Dm012346 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Sun, 28 Dec 2014 20:50:03 GMT Original-Received: from abhmp0015.oracle.com (abhmp0015.oracle.com [141.146.116.21]) by userz7022.oracle.com (8.14.5+Sun/8.14.4) with ESMTP id sBSKo2uH012284 for ; Sun, 28 Dec 2014 20:50:02 GMT 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: ucsinet22.oracle.com [156.151.31.94] 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-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:97792 Archived-At: The doc strings say nothing about parameter ALIST, which in many cases is the most important parameter. One can guess that it is an alist. And one can guess, for the doc strings that mention `inhibit-switch-frame' or `pop-up-frame-parameters', that one or more of its entries can have such a key, but that's all. No guessing helps for `display-buffer-(below-selected|at-bottom|in-previous-window| use-some-window|no-window|same-window|assq-regexp)'. Likewise, some of the "internal" functions. Please describe what ALIST is for, and anything else that might be important about its value, for each function. Function doc strings should describe all parameters. You can refer to the doc of another function, if that is appropriate. But you must not leave users hanging, with no explanation. In GNU Emacs 25.0.50.1 (i686-pc-mingw32) of 2014-10-20 on LEG570 Bzr revision: 118168 rgm@gnu.org-20141020195941-icp42t8ttcnud09g Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --enable-checking=3Dyes,glyphs CPPFLAGS=3D-DGLYPH_DEBUG=3D1'