From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Lars Ingebrigtsen Newsgroups: gmane.emacs.bugs Subject: bug#19461: 25.0.50; doc of `display-buffer-*' functions that take ALIST arg Date: Fri, 02 Aug 2019 22:44:43 +0200 Message-ID: <8736ijmh50.fsf@mouse.gnus.org> References: <97135b13-1c29-44a9-bfd9-f12966e56cd4@default> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="220752"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) Cc: 19461@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Aug 02 22:45:29 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1hteQb-000vLn-6X for geb-bug-gnu-emacs@m.gmane.org; Fri, 02 Aug 2019 22:45:29 +0200 Original-Received: from localhost ([::1]:37478 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hteQa-0001B1-27 for geb-bug-gnu-emacs@m.gmane.org; Fri, 02 Aug 2019 16:45:28 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:37144) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hteQG-00018H-1y for bug-gnu-emacs@gnu.org; Fri, 02 Aug 2019 16:45:09 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hteQE-0002Ol-3I for bug-gnu-emacs@gnu.org; Fri, 02 Aug 2019 16:45:07 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:49069) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hteQ9-0002MH-S7 for bug-gnu-emacs@gnu.org; Fri, 02 Aug 2019 16:45:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hteQ9-0001Rm-KY for bug-gnu-emacs@gnu.org; Fri, 02 Aug 2019 16:45:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 02 Aug 2019 20:45:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 19461 X-GNU-PR-Package: emacs Original-Received: via spool by 19461-submit@debbugs.gnu.org id=B19461.15647786915530 (code B ref 19461); Fri, 02 Aug 2019 20:45:01 +0000 Original-Received: (at 19461) by debbugs.gnu.org; 2 Aug 2019 20:44:51 +0000 Original-Received: from localhost ([127.0.0.1]:57890 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1htePy-0001R8-PX for submit@debbugs.gnu.org; Fri, 02 Aug 2019 16:44:50 -0400 Original-Received: from quimby.gnus.org ([80.91.231.51]:35814) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1htePx-0001R1-O8 for 19461@debbugs.gnu.org; Fri, 02 Aug 2019 16:44:50 -0400 Original-Received: from 77.18.62.220.tmi.telenormobil.no ([77.18.62.220] helo=sandy) by quimby.gnus.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1htePs-0005tR-7L; Fri, 02 Aug 2019 22:44:46 +0200 In-Reply-To: <97135b13-1c29-44a9-bfd9-f12966e56cd4@default> (Drew Adams's message of "Sun, 28 Dec 2014 12:50:04 -0800 (PST)") X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.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" Xref: news.gmane.org gmane.emacs.bugs:164398 Archived-At: Drew Adams writes: > 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. It is indeed pretty obscure what ALIST is. Some of the functions say things like --- If ALIST contains a =E2=80=99window-min-height=E2=80=99 entry, this function ensures that the window used is or can become at least as high as specified by that entry=E2=80=99s value.=20 --- but looking at the code, it passes ALIST around a lot. So is ALIST a general buffer/window property thing? At least one of these doc strings should say what it is, and the rest could refer to it. I've Cc'd Martin. --=20 (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no