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 12:59:14 +0200 Message-ID: <4afeb793-59bf-fc35-f3ed-79995c33ad30@gmx.at> References: <97135b13-1c29-44a9-bfd9-f12966e56cd4@default> <8736ijmh50.fsf@mouse.gnus.org> <83r262ehgi.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="86701"; mail-complaints-to="usenet@blaine.gmane.org" Cc: larsi@gnus.org, 19461@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Aug 03 13:00:21 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 1htrlt-000MMK-Bz for geb-bug-gnu-emacs@m.gmane.org; Sat, 03 Aug 2019 13:00:21 +0200 Original-Received: from localhost ([::1]:39294 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1htrlr-0008Jn-Q0 for geb-bug-gnu-emacs@m.gmane.org; Sat, 03 Aug 2019 07:00:19 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:38024) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1htrlb-0008Hj-DK for bug-gnu-emacs@gnu.org; Sat, 03 Aug 2019 07:00:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1htrla-00009Y-C2 for bug-gnu-emacs@gnu.org; Sat, 03 Aug 2019 07:00:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:49510) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1htrla-00009P-8S for bug-gnu-emacs@gnu.org; Sat, 03 Aug 2019 07:00:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1htrla-0004ct-2p for bug-gnu-emacs@gnu.org; Sat, 03 Aug 2019 07:00:02 -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 11:00:02 +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.156482997717716 (code B ref 19461); Sat, 03 Aug 2019 11:00:02 +0000 Original-Received: (at 19461) by debbugs.gnu.org; 3 Aug 2019 10:59:37 +0000 Original-Received: from localhost ([127.0.0.1]:58331 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1htrlA-0004bg-Vp for submit@debbugs.gnu.org; Sat, 03 Aug 2019 06:59:37 -0400 Original-Received: from mout.gmx.net ([212.227.15.15]:51431) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1htrl8-0004bT-HN for 19461@debbugs.gnu.org; Sat, 03 Aug 2019 06:59:35 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=badeba3b8450; t=1564829958; bh=3mJ//lZQKAzCFcaWjL+vwaglVXzIxsRZAIOpb1sM+TQ=; h=X-UI-Sender-Class:Subject:To:Cc:References:From:Date:In-Reply-To; b=FT/+dwXotNL8MdzTRN56ir1oRgYcGSIdm1hkZWNWKSHf8dNpc1NOQk9u+RVnPqQqR 0snzKpGHzkMiqetqa7vb4qmPx5ot5BLfvyHcqFdGZC4MRN2QMBCtVTo8zSmVALmnVf rQfPC+6dMy2/2sqze1piSiIK0J30l61Pj1Wp2iHY= X-UI-Sender-Class: 01bb95c1-4bf8-414a-932a-4f6e2808ef9c Original-Received: from [192.168.1.100] ([213.162.73.185]) by mail.gmx.com (mrgmx005 [212.227.17.190]) with ESMTPSA (Nemesis) id 1MOiDd-1hhzHF1ndn-00QFwP; Sat, 03 Aug 2019 12:59:18 +0200 In-Reply-To: <83r262ehgi.fsf@gnu.org> Content-Language: de-DE X-Provags-ID: V03:K1:Wz6AAtAPvgCuEvmLk5ta1xN3zf6zvAu07uG9DM+ZgStzf5GLtdO 3zYv+gYytQ093wwPFAQGGn21sav2RFwir7gNNnwoht+KLC87r1kot9O3fg9pAt743SVh8yw c8itvH6vNYytBeq8yQ80ilr3N8d7AMAUvzl3r9+QZR1teK7z6GLM1ARYDEQSKmq0qaNSfwP /lUA87s03S8Jgi+4Tqh5A== X-UI-Out-Filterresults: notjunk:1;V03:K0:GiXXlAY1rB8=:R1ceNuCM7Ji4KTEOq8IReV vxfHqS0hTle9JFwtZ2ugz1MPt4tNUOYpbDaKkQkb2ebv0JX4Fo/Iuc1HVwof2bOB80B/DByVi 5BRTDgFWe/pve/joWY0WyU3bD6D7funFpyoX4AZ9A56VSG9sJricnCjzaVWJ5jBayXeBOocwq vKiqL4sxgjUCgS4Do8/z1h8Gv+Bml60q7hFtWALoilqKjiVXAcED+QH/txmu1vONQIHe+s2HZ xcprG+4GBSvAlZGjXI82i/9vN/hPvCpCicfb9ULrqLhaZ3u541IcAdQYLzHNEp4j53nldYF+f RLEpFTYfLInusqrK0oPZSkK5JScD/QPHrdfuPAOgMBQvUkBm18cuH5qetbX9AuRcu8r+18Ofx cpJylFucNLgZ9YBTTn3HDF6z8x6My9cZOs+0AtwgNX+TVtKAXPvSq+QqtH2DvTKzDRxX0cB5E TVYtJn8S2rxJUAyX3ePBHrr2VcqG61ghXNJtW9kNm/5rdpatxmQMCYI5sdV0YvAWsDoVQbX6o BqJsBFjevEdTZWodsQdeD0US4t5FzE5/xTPz0pXcw0ExcFB3ZsYHXeON/Ld+rntaq42Zqs1B+ D2UeLyKZLm70cYdJADOkt8zHMguWrz7RxpZOf4cFr+l0kkf6x4po41EXuTDutn1ecmjG4AUw3 2bx0VgISOGjn1Rv/X3a2ZlLZvdUYZHjZcZvbRIC57mdw1jyOsguZWtisWhoQFduaMSdsxvp/y FrQ3OTeDP20qikGLz+irVUD/M2+1B8YVm/rBzPbN699TNHtjnvg4A9C1/wU8Txyok+2cequL 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:164425 Archived-At: >> 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. > > What are the non-internal functions which should be called instead of > these ones (and will call these ones when needed)? There is just one and that is 'display-buffer' itself. Functions like 'display-buffer-pop-up-window' or 'display-buffer-same-window' should never get called by anyone but 'display-buffer' or a function (in-)directly called by 'display-buffer'. 'display-buffer' is the only function that can handle precedences correctly and knows how to build ALIST from its various ingredients. In fact, one can rewrite any 'display-buffer-*' function with the help of 'display-buffer' and an appropriate ACTION argument. >> 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. > > I gave it a go on the master branch, please take a look. Good! Referring to the Elisp manual seems like the only way to add something useful. Thanks, martin