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#26233: 26.0.50; [PATCH] Improve documentation for display-buffer-alist Date: Mon, 24 Jun 2019 18:54:42 +0200 Message-ID: References: <87o9wq6c31.fsf@wi.uni-muenster.de> <58D56B7A.2080909@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="200091"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) Cc: Jens Lechtenboerger , 26233@debbugs.gnu.org To: martin rudalics Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Jun 24 18:55:29 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 1hfSFd-000pw6-Cv for geb-bug-gnu-emacs@m.gmane.org; Mon, 24 Jun 2019 18:55:29 +0200 Original-Received: from localhost ([::1]:53144 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hfSFc-0006YX-ED for geb-bug-gnu-emacs@m.gmane.org; Mon, 24 Jun 2019 12:55:28 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:38382) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hfSFE-0006Vf-G8 for bug-gnu-emacs@gnu.org; Mon, 24 Jun 2019 12:55:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hfSFD-0000cq-7z for bug-gnu-emacs@gnu.org; Mon, 24 Jun 2019 12:55:04 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:44294) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hfSFC-0000bw-Df for bug-gnu-emacs@gnu.org; Mon, 24 Jun 2019 12:55:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hfSFC-00018b-B2 for bug-gnu-emacs@gnu.org; Mon, 24 Jun 2019 12:55: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: Mon, 24 Jun 2019 16:55: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.15613952894335 (code B ref 26233); Mon, 24 Jun 2019 16:55:02 +0000 Original-Received: (at 26233) by debbugs.gnu.org; 24 Jun 2019 16:54:49 +0000 Original-Received: from localhost ([127.0.0.1]:57835 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hfSEy-00017q-QD for submit@debbugs.gnu.org; Mon, 24 Jun 2019 12:54:49 -0400 Original-Received: from quimby.gnus.org ([80.91.231.51]:33500) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hfSEx-00017h-2n for 26233@debbugs.gnu.org; Mon, 24 Jun 2019 12:54:47 -0400 Original-Received: from cm-84.212.202.86.getinternet.no ([84.212.202.86] helo=stories) by quimby.gnus.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1hfSEs-0005UC-J4; Mon, 24 Jun 2019 18:54:44 +0200 In-Reply-To: <58D56B7A.2080909@gmx.at> (martin rudalics's message of "Fri, 24 Mar 2017 19:54:50 +0100") 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:161251 Archived-At: martin rudalics writes: >> in Bug#25946 we discussed how to replace the obsolete variables >> special-display-buffer-names and special-display-regexps. The >> attached patch extends the doc string of display-buffer-alist based >> on that discussion. > > 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. Very short (like a couple of lines) I think is fine in doc strings, but more than that should go in the manual (with, perhaps, links from the doc string). But in this case we're talking about adding pointers to variables that were obsoleted six years ago (four at the time of this bug report), so I don't think either is really worth doing at this point. So I'm closing this bug report; please reopen if you disagree. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no