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: Sun, 4 Aug 2019 10:01:05 +0200 Message-ID: <3a7249b5-a07a-e134-74fb-ca0b5de6aa76@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> 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="24117"; 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 Sun Aug 04 10:02:16 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 1huBT5-00069I-Ir for geb-bug-gnu-emacs@m.gmane.org; Sun, 04 Aug 2019 10:02:15 +0200 Original-Received: from localhost ([::1]:43138 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1huBT4-0007nN-LG for geb-bug-gnu-emacs@m.gmane.org; Sun, 04 Aug 2019 04:02:14 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:43097) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1huBSt-0007n5-9K for bug-gnu-emacs@gnu.org; Sun, 04 Aug 2019 04:02:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1huBSs-00087A-97 for bug-gnu-emacs@gnu.org; Sun, 04 Aug 2019 04:02:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:51571) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1huBSs-000875-5b for bug-gnu-emacs@gnu.org; Sun, 04 Aug 2019 04:02:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1huBSs-0002sW-1w for bug-gnu-emacs@gnu.org; Sun, 04 Aug 2019 04:02: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: Sun, 04 Aug 2019 08:02: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.156490567411011 (code B ref 19461); Sun, 04 Aug 2019 08:02:01 +0000 Original-Received: (at 19461) by debbugs.gnu.org; 4 Aug 2019 08:01:14 +0000 Original-Received: from localhost ([127.0.0.1]:60392 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1huBS5-0002rX-R4 for submit@debbugs.gnu.org; Sun, 04 Aug 2019 04:01:14 -0400 Original-Received: from mout.gmx.net ([212.227.15.18]:37731) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1huBS4-0002rK-8s for 19461@debbugs.gnu.org; Sun, 04 Aug 2019 04:01:12 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=badeba3b8450; t=1564905666; bh=sH1wqa3FLMg7SA8V8hsoy7XTEm70bMgIGFRTQafj1TE=; h=X-UI-Sender-Class:Subject:To:Cc:References:From:Date:In-Reply-To; b=jAustK/nH6sLmRwOux7RPbmf5lHQorMJh+d8ZmvHVo7vCu8vU1b1leNAMXC6Unlzq F6hbbs9lCkuNtELwT9FP+e7SQ+MnW58yqcHrYin2ElYwQO3brJTPDCr4jPkmBpZWKx PPlm4gzREPxzQhUdRsVzvED+7bDFa3KOKyaIiMZk= X-UI-Sender-Class: 01bb95c1-4bf8-414a-932a-4f6e2808ef9c Original-Received: from [192.168.1.101] ([213.142.96.135]) by mail.gmx.com (mrgmx003 [212.227.17.190]) with ESMTPSA (Nemesis) id 0Luxaj-1iKp5X0wWv-0108W0; Sun, 04 Aug 2019 10:01:06 +0200 In-Reply-To: <87v9vdejia.fsf@web.de> Content-Language: de-DE X-Provags-ID: V03:K1:Q94NYpKXnaDwRYQpoz0T2Ez/nVV8zC3c20kGHOBR7hLFKDuZ11w HpuVFx3qRU2kPVRc3lYQ5E81e+RW7uNTs0BSpeK8K/sLvq+/9g8m951Wid+/3oZhSuanGRH vPUYNppkg7WA98/e4BsCFyzrCWeuVwKpOx16ur91El18LokLDP48dTvOC+gfOVcVGEsT+Tz hBk/9+LZZwNrTh5TZFVaQ== X-UI-Out-Filterresults: notjunk:1;V03:K0:QRRYpQBu2iE=:aStpAi/Oq5JdrydT1VwCG3 z9ml6vjPWtpOrMFZu3k4lZwj80fETJbk/7/OHBImutvuNQUJUOdIE/wu5zWwekqEHTs4bl/cZ IQpTHATkbyBNI9loF0wtTTjo/+yQoCZMANo2QEgFZcOyhwW+Fp312lyy+3kcXAgd6seC8PQ1R FgtObV/3KWl/Uw3ScRgfLqZIkgXZfM0LmFcxEAlFjoxAZPcEDALEJN515oCmAEKv5tYi2H856 ksa3N1LMxN7yJF8jWlOI06x/d5QKSegwb0A2w3p7w/gGNxAH0Tm4QQPpXCIOuCHWvIr4GRCW7 9y7D4wDPAl+bw5vEGfGQjKM436BW9HLS2w9Cn2cd1kgMcFsFs3p7EsfkWyoJAxeDhxDOu0eXX sS7IlIczH1iiPjI9lVm1pUvqe5KISXZSrTP/tdi9lnVOz8zF63qw55DeCBIll3b9HbfmHNBXM lp/d5gP92l9RJincPX0J/+oUcj2Pi+F4KSsvWBJ7ZIJAf9KnwYUwmzCltUpia5P/HPEJdwmiB V1U4ivs+3OyHkmJ67mFd5XQFwNTDku0OKd/BXoQernRtxiE8Mf1BF/G8jgUdujpjT6DqHxHQ8 20LX3syie7dClalSLSz5u5bpoIXhT2vMXSTArDsn02SYMRBT9vL+AtFswZ4XMFisAioBTuh3/ Ef6gO9tFl2/bPwhv4o2/WVAzBzV80tjhOJEU7/Y4hOsd6wU1nt/9K8rxLzhxhxCVNGJLatG+H RLLJ3INFVv5QcVK0GREm86HEsjizjiIGLdzGI3p7ZQmBm+nG3NkcAyrjGEoUjCpS/OogTUCI 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:164535 Archived-At: > 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. > - it > is valid as an action function in the ALIST argument of > display-buffer 'display-buffer' calls it ACTION argument. A problem with this is that so far we do not specify what a "valid" action function is. > ...don't call it directly" or so? 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." > Problematic in this regard is that there _are_ other functions like that > that are not internal AFAIK - `pop-to-buffer' for example. How can one > distinguish them? I see no problems since these would not provide such an explanation. martin