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: Mon, 5 Aug 2019 11:22:59 +0200 Message-ID: <757e24de-24ba-bc5c-db03-4e2c2bceda1d@gmx.at> References: <97135b13-1c29-44a9-bfd9-f12966e56cd4@default> <8736ijmh50.fsf@mouse.gnus.org> <83r262ehgi.fsf@gnu.org> <4afeb793-59bf-fc35-f3ed-79995c33ad30@gmx.at> <87v9vdejia.fsf@web.de> <3a7249b5-a07a-e134-74fb-ca0b5de6aa76@gmx.at> <8736ih5gcz.fsf@web.de> 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="92400"; mail-complaints-to="usenet@blaine.gmane.org" Cc: larsi@gnus.org, 19461@debbugs.gnu.org To: Michael Heerdegen Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Aug 05 11:24:10 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 1huZDt-000NsH-2O for geb-bug-gnu-emacs@m.gmane.org; Mon, 05 Aug 2019 11:24:09 +0200 Original-Received: from localhost ([::1]:52010 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1huZDr-000885-So for geb-bug-gnu-emacs@m.gmane.org; Mon, 05 Aug 2019 05:24:07 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:59025) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1huZDn-00087j-Bx for bug-gnu-emacs@gnu.org; Mon, 05 Aug 2019 05:24:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1huZDm-0004Tz-9h for bug-gnu-emacs@gnu.org; Mon, 05 Aug 2019 05:24:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:54025) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1huZDm-0004Tv-6Y for bug-gnu-emacs@gnu.org; Mon, 05 Aug 2019 05:24:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1huZDm-0005wa-1x for bug-gnu-emacs@gnu.org; Mon, 05 Aug 2019 05:24: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: Mon, 05 Aug 2019 09:24: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.156499699322763 (code B ref 19461); Mon, 05 Aug 2019 09:24:01 +0000 Original-Received: (at 19461) by debbugs.gnu.org; 5 Aug 2019 09:23:13 +0000 Original-Received: from localhost ([127.0.0.1]:34607 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1huZCy-0005v5-Ui for submit@debbugs.gnu.org; Mon, 05 Aug 2019 05:23:13 -0400 Original-Received: from mout.gmx.net ([212.227.15.18]:36445) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1huZCw-0005uq-JU for 19461@debbugs.gnu.org; Mon, 05 Aug 2019 05:23:11 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=badeba3b8450; t=1564996982; bh=qHzgnVgpllcZ6v3E/+hx093iQXtDZJpch0kEmCgUtyY=; h=X-UI-Sender-Class:Subject:To:Cc:References:From:Date:In-Reply-To; b=g4UlbGyA0RIUS1gk/YEBv0ida5QN5nYWosyg8dUNidWdjaK36jDzVLxP3gS10W+L/ 1wqcHfaEVYV5Y8bAWvujgShrTyroJ454MkpwfFA3W+XAxKmU/zBYjuuan+oL57Puov 3JZxfn1fJrE9+6Frl7HpU1IqAYHDBCiq3KztBxQM= X-UI-Sender-Class: 01bb95c1-4bf8-414a-932a-4f6e2808ef9c Original-Received: from [192.168.1.101] ([213.162.73.205]) by mail.gmx.com (mrgmx003 [212.227.17.190]) with ESMTPSA (Nemesis) id 0MF4iR-1i96Bq3otv-00GGBW; Mon, 05 Aug 2019 11:23:02 +0200 In-Reply-To: <8736ih5gcz.fsf@web.de> Content-Language: de-DE X-Provags-ID: V03:K1:BtjlPwJY1QoKHf8Dm21VSBSeUJ2GqH+QhRUGN6MyIz7YtPMJdux C1eDa6CmTKgpaCqg2ZTO0oVZpY6s2YMj2g1rMzKLXiaOWMuLZiIZcIwmlTvdyTmkKnyzitY 833DuLj4q5o/ercou6HNeuqnFPqq0cmgmwLz/vlNk2a6U3EHYkg8y+nsFzbrRiK5rFSyhBk NdaSuPy1aAcnyv6Dw531w== X-UI-Out-Filterresults: notjunk:1;V03:K0:Z+aATrzTlyA=:QW8uLsUnkMoe7fSc+mCqC1 cqjMGwcp4iu5KbUGXD2KC7M7dfE1HYZ3wdIEEeRNLryVzTZrnJAmLwPi+ISEQF4PlZeHlgga5 jjcGjLgW5GR/dYEcULs0YOrAZ3OIyDVT00CZJg6jon/A0IQjBN5spuOxCM30dREH4YqtyNFFF sQvcBKdO0AA8Uq/bRpcEqnQ5qp/5WTnuFG1EZ3ZkbrS7gA+vI+QilPMl28lCTQMd+A3rgniF+ beoztY0Q+ROcI+muc2MiAiLzLVqFPouGjKakMq6rECVXQnO9iRCoQsfPfzr7w9zgRT29UAZeC pLAJjPJNJBu/hMwwmejNdrtY2IDjqJtL4+6SB6jADQdatVTAq7L9eSsSQbAAMxLXNfVO3601u 0saeJcjz0LsG1YkeDvDKmVBo+Wpa/bPEg9OV53TxynalqTbk7FzNSm3xWJ9NKBZphQAf8Wi4X VpIz1CZyEQhquhtEfaap25A94Ut36SRWPj9rXaC/bWxCJU1iWx9RqeYNeVYn8ryLijw1tGlzf neUFL7NJtF9xrAERuZEff0S3PvjYMNA99EDMiq2gajqqhrZV6lmvn8QbrJ1zk0McDpbQtUb9o GLYeLbkZWaIRDoAqGDhNUcinhngxzC8VilflPdxIlxZsWky3/WZFV5Ax+M88c94yM1QpV2fWS EeH8+H2OvI2CIyLEfsjvaq3CLyqITIRgkHyEfQQlBre9o2XwO/r4YpPFX/dX4+9/O6L+Tf6bj 5JCKACD5bvyv8BVYF4SLROm5C7aDWjWDIkJ5WO1IYUJLTLGw8KW2XGUlDdr7hCXwRGfRImtG 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:164622 Archived-At: >> 'display-buffer' calls it ACTION argument. A problem with this is >> that so far we do not specify what a "valid" action function is. > > Maybe that should be done. Would there be more to say than that an > action function should either return a window (success) or nil (fail), I think that's already all that can be said, maybe including the special value 'fail' for 'display-buffer-no-window'. > and respect the specified specifications in the ALIST, An action function should respect the specifications provided that's possible. But due to fact that action lists are combined from various sources, I'm quite confident that it's possible to construct an inherently invalid ALIST where an action function "inherits" an ALIST entry originally meant for another action that failed to produce a window. In such case, the display action should do its best to not respect that entry. > and what actions > are predefined? The predefined actions may vary continuously so that's probably not very feasible. >> "This is an action function for buffer display, see Info node `(elisp) >> Buffer Display Action Functions'. It should be called only by >> 'display-buffer' or a function directly or indirectly called by the >> latter." > > Sounds ok. AFAIU this covers defining new actions by using existing > ones, like in > > (defun my-display-buffer-pop-up-frame-dedicated (b alist) > (let ((w (display-buffer-pop-up-frame b alist))) > (when (windowp w) (set-window-dedicated-p w t)) > w)) > > right? You mean in the sense that you do not have to provide that text in the doc-string of 'my-display-buffer-pop-up-frame-dedicated' too? I think so. But I wonder why you don't provide a non-nil 'dedicated' entry in ALIST here. martin