From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: martin rudalics Newsgroups: gmane.emacs.bugs Subject: bug#19461: 25.0.50; doc of `display-buffer-*' functions that take ALIST arg Date: Sat, 3 Aug 2019 09:58:18 +0200 Message-ID: References: <97135b13-1c29-44a9-bfd9-f12966e56cd4@default> <8736ijmh50.fsf@mouse.gnus.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: quoted-printable Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="120238"; mail-complaints-to="usenet@blaine.gmane.org" Cc: 19461@debbugs.gnu.org To: Lars Ingebrigtsen , Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Aug 03 09:59:09 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 1htowX-000V69-2Y for geb-bug-gnu-emacs@m.gmane.org; Sat, 03 Aug 2019 09:59:09 +0200 Original-Received: from localhost ([::1]:38858 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1htowV-00031f-Tr for geb-bug-gnu-emacs@m.gmane.org; Sat, 03 Aug 2019 03:59:07 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:37024) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1htowQ-000302-Tc for bug-gnu-emacs@gnu.org; Sat, 03 Aug 2019 03:59:03 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1htowP-0002Qt-TN for bug-gnu-emacs@gnu.org; Sat, 03 Aug 2019 03:59:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:49449) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1htowP-0002Qn-MW for bug-gnu-emacs@gnu.org; Sat, 03 Aug 2019 03:59:01 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1htowP-0008Rw-I4 for bug-gnu-emacs@gnu.org; Sat, 03 Aug 2019 03:59:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: martin rudalics Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 03 Aug 2019 07:59: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.156481911232445 (code B ref 19461); Sat, 03 Aug 2019 07:59:01 +0000 Original-Received: (at 19461) by debbugs.gnu.org; 3 Aug 2019 07:58:32 +0000 Original-Received: from localhost ([127.0.0.1]:58270 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1htovw-0008RF-9E for submit@debbugs.gnu.org; Sat, 03 Aug 2019 03:58:32 -0400 Original-Received: from mout.gmx.net ([212.227.17.22]:50177) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1htovt-0008R1-WD for 19461@debbugs.gnu.org; Sat, 03 Aug 2019 03:58:30 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=badeba3b8450; t=1564819098; bh=3/vqYlnR5pfgPb/17Z877NsnIbuMubWJNtZ6/rky6HA=; h=X-UI-Sender-Class:Subject:To:Cc:References:From:Date:In-Reply-To; b=I8xsKvHmuuKHap82KyBFA62j1Josk3F1juvCEoAb+ORo/lVFdScf+rUe1Al9Afxr2 J7yNzlnd6GY1tjnpi2Zp9w1FLwrBpQtReoUbHP8E61XTzOeU/Ae5DGcBuxI3/1W+sG uDNkFclsAK+jbsb/NOMRkThSh7OZYKIMkiYXyW9M= X-UI-Sender-Class: 01bb95c1-4bf8-414a-932a-4f6e2808ef9c Original-Received: from [192.168.1.101] ([213.162.73.33]) by mail.gmx.com (mrgmx103 [212.227.17.168]) with ESMTPSA (Nemesis) id 0LfkJC-1ij2em0W9C-00pMEW; Sat, 03 Aug 2019 09:58:18 +0200 In-Reply-To: <8736ijmh50.fsf@mouse.gnus.org> Content-Language: de-DE X-Provags-ID: V03:K1:nqvXXc/0N/D/SXbUMFTK1exi4JxMuNFG/FR3bux+MQxngLGvRnH mIZjJdEkkciU1HoH3ai1iloHZAz0LamWRs0bDem+OL6QRGVbim1Q1e6Ka08OELt1MhqIylL Xul1rJ+oWcTtgkKPTLU7qQAm9yeA088rYZj0IJbBmllVaG9XISUFlfD2CHkWiHcXSWUETHQ o5G4BGveo7/a51JzVeeXg== X-UI-Out-Filterresults: notjunk:1;V03:K0:tpRY+Tlmp7U=:g0iMGLOOepJuYoLQN9nC90 mnOZdYRmG9BgZyiGWUJ0MKVa4TwuRAvUjLfaApZQ5+O30nh+aije2hALkKLVCgAXBgUO8QZiT jBhRt9V6dIBY/tIo/1hO3REHiKeyeyHxbsy3WBbuQSendC6iIeKCUk+ZOsQmFBXUxMoWY89Vo HZx/LXEF8uesDiriNX2THBMuOXUCWD672cX9GMBZ915Tt344Lb4AWgzFVqZsCevVw/EBIsmRr Yx7488TsEVidUYjMuhMTtS8VfjnWk+nWAuo4Ce4ngS2ghlsCRGzg25kfVxg2ahW6uxp3ZEP2k rK2rkVTyPr2vYR7b8b/8Xgc9BHBQQGNaHxp5Xfe32SBhOFf50gC/LYa5bKYxEiYLpOWqnd9I2 +Y2pVJ7rHfdwuJM5xWNwGvWJRsp6c5Yc3/IqGwVE4CQhcXHK8HCVVz8Zn9AD42iS1Bq9RakmO /yleBLErn9yUAfiSCls4yN4K2NYE4xK43ZyvZbLqPr7cYOqyEXjO6yTd3XA16nDVYhRlURVN4 Li3QhQ5ZgISkM4ZHqkmSIUofbVhUShZFvhby8kkU7fqq4YvWZWOFsKIeVDJMSzWFm7xrUz3qW SWB60XUpZUUa0Jf6ilo4po1uAy5Z5vjRArRICt1GeSzpSLjFZo8OYHZ2+BRG6rWq9+e3Sl44r OqH1TlougbiTeCfTyU5Gtt3AlY+mM8gih3P0cdxEF65+AA5doxsutLptezn2YpZWM7yC6SihI FRhBJoD9TLL8ur7b3wARbOdqo/jM/Bl7+JuXmHNvpvpsW5ydH1CIerMdsrYbHI3zUP0voheo 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:164419 Archived-At: >> The doc strings say nothing about parameter ALIST, which in many case= s >> 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 s= uch >> 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. This problem is with us since day one of that buffer display code. It's probably due to the fact that the 'display-buffer-*' functions are inherently internal but never have been marked as such in order to describe them in the manual and allow users to add new ones. > Some of the functions say > things like > > --- > If ALIST contains a =E2=80=99window-min-height=E2=80=99 entry, this fu= nction > ensures that the window used is or can become at least as high as > specified by that entry=E2=80=99s value. > --- > > 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. Saying what it is is non-trivial, see section 28.13.3 of the Elisp manual. So I have no good idea how to do what you propose. martin