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: Sun, 04 Aug 2019 13:48:14 +0200 Message-ID: <87d0hlb18h.fsf@mouse.gnus.org> 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="122848"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) Cc: Michael Heerdegen , 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:49:15 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 1huF0l-000VeS-EE for geb-bug-gnu-emacs@m.gmane.org; Sun, 04 Aug 2019 13:49:15 +0200 Original-Received: from localhost ([::1]:43764 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1huF0e-00039r-T7 for geb-bug-gnu-emacs@m.gmane.org; Sun, 04 Aug 2019 07:49:08 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:38950) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1huF0a-00039Z-55 for bug-gnu-emacs@gnu.org; Sun, 04 Aug 2019 07:49:05 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1huF0Y-0003HE-R4 for bug-gnu-emacs@gnu.org; Sun, 04 Aug 2019 07:49:04 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:51877) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1huF0Y-0003Gu-2j for bug-gnu-emacs@gnu.org; Sun, 04 Aug 2019 07:49:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1huF0Y-0002CE-0K for bug-gnu-emacs@gnu.org; Sun, 04 Aug 2019 07:49:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 04 Aug 2019 11:49: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.15649193038398 (code B ref 19461); Sun, 04 Aug 2019 11:49:01 +0000 Original-Received: (at 19461) by debbugs.gnu.org; 4 Aug 2019 11:48:23 +0000 Original-Received: from localhost ([127.0.0.1]:60698 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1huEzu-0002BN-Ol for submit@debbugs.gnu.org; Sun, 04 Aug 2019 07:48:22 -0400 Original-Received: from quimby.gnus.org ([80.91.231.51]:36224) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1huEzs-0002BF-GG for 19461@debbugs.gnu.org; Sun, 04 Aug 2019 07:48:20 -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 1huEzn-000711-I0; Sun, 04 Aug 2019 13:48:17 +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-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:164551 Archived-At: martin rudalics writes: >> I think the docstrings must tell that. Because the names suggest the >> opposite. Something like "this function is for internal use only > > Readers might then ask why it does not use the "--" notation. And the answer is the same as with all the other internal functions that don't -- historical reasons. > "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 good to me. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no