From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Michael Heerdegen Newsgroups: gmane.emacs.bugs Subject: bug#19461: 25.0.50; doc of `display-buffer-*' functions that take ALIST arg Date: Sun, 04 Aug 2019 13:18:04 +0200 Message-ID: <8736ih5gcz.fsf@web.de> 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> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="4152"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) Cc: larsi@gnus.org, 19461@debbugs.gnu.org To: martin rudalics Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Aug 04 13:19:11 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 1huEXd-0000t5-22 for geb-bug-gnu-emacs@m.gmane.org; Sun, 04 Aug 2019 13:19:09 +0200 Original-Received: from localhost ([::1]:43578 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1huEXb-0004ZE-GF for geb-bug-gnu-emacs@m.gmane.org; Sun, 04 Aug 2019 07:19:07 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:35617) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1huEXX-0004Z6-Ii for bug-gnu-emacs@gnu.org; Sun, 04 Aug 2019 07:19:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1huEXW-0000N5-M0 for bug-gnu-emacs@gnu.org; Sun, 04 Aug 2019 07:19:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:51686) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1huEXW-0000Mw-Iw for bug-gnu-emacs@gnu.org; Sun, 04 Aug 2019 07:19:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1huEXW-0007aq-CQ for bug-gnu-emacs@gnu.org; Sun, 04 Aug 2019 07:19:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Michael Heerdegen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 04 Aug 2019 11:19: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.156491750429144 (code B ref 19461); Sun, 04 Aug 2019 11:19:02 +0000 Original-Received: (at 19461) by debbugs.gnu.org; 4 Aug 2019 11:18:24 +0000 Original-Received: from localhost ([127.0.0.1]:60507 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1huEWu-0007a0-Lq for submit@debbugs.gnu.org; Sun, 04 Aug 2019 07:18:24 -0400 Original-Received: from mout.web.de ([212.227.15.14]:49547) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1huEWq-0007Zk-GC for 19461@debbugs.gnu.org; Sun, 04 Aug 2019 07:18:23 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=web.de; s=dbaedf251592; t=1564917487; bh=McR/nBMeA/E9DK8/Q5Rq+rLnob8jlaK8ZbvCifwnUoM=; h=X-UI-Sender-Class:From:To:Cc:Subject:References:Date:In-Reply-To; b=DsKpL5MiJeN2v1hIlrd4yCwGFRCrBYk/SBiFsOKOpggDaRLJxoyq1ClaWAeuXmAWF kO2kqb470+SEk2LxAMBNUCBy4H1fK+wPtCjwAcqe18oc7fnFiqNkFhEIl0xNjA4blY cyj5MAsGyHxgUlNYpIhJV1lIAGOAM5xccffF9JZE= X-UI-Sender-Class: c548c8c5-30a9-4db5-a2e7-cb6cb037b8f9 Original-Received: from drachen.dragon ([92.208.178.242]) by smtp.web.de (mrweb003 [213.165.67.108]) with ESMTPSA (Nemesis) id 0MV4hR-1hrDIQ2xAr-00YRa5; Sun, 04 Aug 2019 13:18:07 +0200 In-Reply-To: <3a7249b5-a07a-e134-74fb-ca0b5de6aa76@gmx.at> (martin rudalics's message of "Sun, 4 Aug 2019 10:01:05 +0200") X-Provags-ID: V03:K1:6mlmzfKxOxZUtGjGP0mDN+Xt1Iz6aoPxWS/WRyTBqMxVbvdC+ew hPYZiBfJRuXX/Vo6H51Rnc8PYsAk2Af/ARQ61IcuOuK8rFwrv6IJzh/5i/bl8G77J4nhBBX odxeowqXtkulB9f10EXIhOQzY98LQE1YM3C6D6PwgRfG40laBzpCFWHznFEa4qf6QYK+AJg NqpZC34cYB4IE6eAIzgmg== X-UI-Out-Filterresults: notjunk:1;V03:K0:0eo0mEheU2k=:jyr0h8tBuvUzl7wpSAAsW4 CTa99/3ZburGPjxHXqjkuol2FZM4lXeBllb0X+fxuzbl4mCwmUtSA/oG2RoImxcyL6CUW5KvV xIKsEnTFJiFL286ZC5FtsZ8mwrniKgtYlKQ/m5OdRM/yxzCT7+eu5U8ER7v9iQEZwBW2Lue32 knyB3YsrQh5rzVgZ6jo8eGW1qua1Ojmi/a781hLYABDw0lphRyDqO+6uEEwIP/61p/33o14EP 3FIvFqKt0DZlgyL6lJdQCd5hl/LS7wqFPBG5wvWBa6ukU0/cmDyRa33TiSdSZDt3M3GtwmSyH wSg4YQAc+aay6wE5hEuD+Vod9Uh2FiWbHVNERFCdm+4Rk2AUgAnxuAhthcWAyyc5aOMOu56+a +cmQTa6AVavldesh+Cj3p0d/x7nBT4Yj1KZQwds1YdgbAyS9A9KmRbmeMN/dXReZcts6oTXQ1 3yqzgZDwVK0UUe5YQ8Kyk98kvhyo97sr7E1XyPo2LwhFQKoILMWfUPUp89/C/J/7Q90Zy14t2 gCve1dQhK1QyOYTrjG46aNeBujoX4HY/Oe44/cxdht5YoaD00hzew7SzqFIrIyJSZwhnCGwhE vp2nK19RrgD86g/5gr4HMCLJa2/r34pITEJ7ZtuooJbWmsSGubpkOBHVo+a+Uh0ppBPXhMwUv bO12jfNwRunfS7Re3w1yrYteT1bgWzFpa0SMSVRuTLFGXxgGDGQKNbBZJ9s4tY9Hew1Ora+XT EgYQxuVY3NcPYwP0CfHH7pMcoAx+dNv9br3CbCICD6qME8wnz8+86eLqD2lab4mc6WAt+SFb 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:164548 Archived-At: martin rudalics writes: > '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), and respect the specified specifications in the ALIST, and what actions are predefined? > A possible text would be: > > "This is an action function for buffer display. It should be called > only by 'display-buffer' or a function directly or indirectly called > by the latter." > > Or with a reference to the Elisp manual: > > "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? Michael.