From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: martin rudalics Newsgroups: gmane.emacs.bugs Subject: bug#26233: 26.0.50; [PATCH] Improve documentation for display-buffer-alist Date: Sat, 25 Mar 2017 10:28:39 +0100 Message-ID: <58D63847.1060906@gmx.at> References: <87o9wq6c31.fsf@wi.uni-muenster.de> <58D56B7A.2080909@gmx.at> <874lyh6b25.fsf@informationelle-selbstbestimmung-im-internet.de> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-Trace: blaine.gmane.org 1490434172 28845 195.159.176.226 (25 Mar 2017 09:29:32 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sat, 25 Mar 2017 09:29:32 +0000 (UTC) Cc: 26233@debbugs.gnu.org To: Jens Lechtenboerger Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Mar 25 10:29:28 2017 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cri0h-0006fK-Ng for geb-bug-gnu-emacs@m.gmane.org; Sat, 25 Mar 2017 10:29:23 +0100 Original-Received: from localhost ([::1]:36486 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1cri0n-0004tf-Nl for geb-bug-gnu-emacs@m.gmane.org; Sat, 25 Mar 2017 05:29:29 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:49311) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1cri0N-0004fS-9j for bug-gnu-emacs@gnu.org; Sat, 25 Mar 2017 05:29:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1cri0M-00032z-HQ for bug-gnu-emacs@gnu.org; Sat, 25 Mar 2017 05:29:03 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:45049) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1cri0M-00032p-Cp for bug-gnu-emacs@gnu.org; Sat, 25 Mar 2017 05:29:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1cri0M-0001k3-7X for bug-gnu-emacs@gnu.org; Sat, 25 Mar 2017 05:29: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, 25 Mar 2017 09:29:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 26233 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 26233-submit@debbugs.gnu.org id=B26233.14904341316676 (code B ref 26233); Sat, 25 Mar 2017 09:29:02 +0000 Original-Received: (at 26233) by debbugs.gnu.org; 25 Mar 2017 09:28:51 +0000 Original-Received: from localhost ([127.0.0.1]:43248 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cri0A-0001jc-Vn for submit@debbugs.gnu.org; Sat, 25 Mar 2017 05:28:51 -0400 Original-Received: from mout.gmx.net ([212.227.15.18]:57791) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cri09-0001jP-Pg for 26233@debbugs.gnu.org; Sat, 25 Mar 2017 05:28:50 -0400 Original-Received: from [192.168.1.100] ([213.162.68.58]) by mail.gmx.com (mrgmx001 [212.227.17.190]) with ESMTPSA (Nemesis) id 0LcSAg-1cPlqX18Io-00jtR7; Sat, 25 Mar 2017 10:28:43 +0100 In-Reply-To: <874lyh6b25.fsf@informationelle-selbstbestimmung-im-internet.de> X-Provags-ID: V03:K0:/pWZiNBe3mc6gQzUuVA612BoYl62PniG+nDHewnLQF+gO6WLewq 4lBJmS67QR0RT30fnWaLsP8NlYwMKNDP7DqZqJzdRDbHEKMZdXPdxLNc09TyxdUJB1vLq+k b3vTA8z0hNNHUX7+XE3Lj7Y1kvwY2lb81jPxwbrEXCT24BQXO4fmxcSTXMqk9+wky3DnmQA y9btuhWvPtU7P+Ih+5gtA== X-UI-Out-Filterresults: notjunk:1;V01:K0:qc852wCYLFE=:Qp6Rk/pMgAZcaN0fC1Xgir RhYOum0Wq8+JqHyVxhnT5at2kTIwHCSnB8AATgaMoTWgrQdp7AVYBjLKKGgwb8sjBTkMpCZrn 9wYTrFh12o6VXt08vXSKSeDHssXs3dc1GC8qAKDnkotMg5vj+iRfzRjU1k2QuB/LSh6sC96Uj 0deMebEBtGxqEefQ4HTziEronEsC7rVaS/ULAtSW08BY9qDNL1iL0rI5ccQyVz7Sm/9sCWmj5 TtiB55jouq4zIFjga3HI/sD4h5a3Aj1/gLoatGNZ28+f6vgnJW8ZmIm4pCUBmiEFh71mHQmTJ qZETzjVF+Gl9Hl/D1IcheMOt58+KvIh43kNtDphilE6BG6+vto7MenS4/ylSbLUmYK6H4tXls GsmGNPk+TwzGtDmocl8sEv8eWpQy5cw3UQYfqsNDevifU6q6YupUwsso5DEQpf4LXOmpaTAUR Flfi5DkTCIbtm5rxujQinb5+22tRMw3MLV2X8F71t4BsUcoBR0CCGkR8GmfpUQ1cLmGzbecj9 e9Q0amuG7+NjbUwO0KDD500j2Zb+P/+5XKjZUgCOVuLb0mHj1rnjzTnzz5sn9Tuds72eTRG8f o9mNTEFdkn8PNKl+kYSqqBxMU9oqTjkythW+XK9K8R47Jn8ABlp4kSCBzo23SNzdVE78UILhN izjKdnHfX2LZaH65sKCKiMHoXCGkUB9q8xxfWwew6csDr/DH2TYscFsnnpOB/gY4+0/hSPKV5 c25HiYpzYUTStDXy3RVr6R0lbthL1hOBk0PNidZtpYf37C8QrMWC0NpO3PYEsghUyiziVGL6 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: 208.118.235.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:130920 Archived-At: >> Thanks. Personally I'd prefer having that in the Elisp manual. Either >> in a new subsection or at the end of section 27.14 Action Functions for >> `display-buffer'? Code in doc-strings is sometimes tedious to read. > > I'm surprised. I consider that information relevant to ordinary > users, not only developers. As pointed out by Drew Adams, probably > a new section in the Emacs manual is necessary. Also, she convinced > me that much more information is necessary, which I'm unable to > provide. That's why I used the term "personally". If you think that putting the information in the doc-string is better, let's do that. martin