From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Lars Ingebrigtsen Newsgroups: gmane.emacs.bugs Subject: bug#45688: 28.0.50; New action for display-buffer? Date: Thu, 07 Jan 2021 15:47:45 +0100 Message-ID: <87sg7c3isu.fsf@gnus.org> References: <87im8a1dff.fsf@gnus.org> <6d33f679-925e-78ee-2055-0520538f48f5@gmx.at> <87ble217jy.fsf@gnus.org> <8bc28c07-a4af-f58d-97f5-9d0a89ff58fe@gmx.at> <87h7ntynpx.fsf@gnus.org> <616655cc-9b87-cb93-6787-11e7037e8cbc@gmx.at> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="27757"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) Cc: 45688@debbugs.gnu.org To: martin rudalics Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Jan 07 15:48:27 2021 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1kxWaQ-00076n-ML for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 07 Jan 2021 15:48:26 +0100 Original-Received: from localhost ([::1]:56898 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kxWaP-00083d-E7 for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 07 Jan 2021 09:48:25 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:58952) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kxWa3-00083B-Iw for bug-gnu-emacs@gnu.org; Thu, 07 Jan 2021 09:48:03 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:35385) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kxWa1-00049k-Ra for bug-gnu-emacs@gnu.org; Thu, 07 Jan 2021 09:48:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1kxWa1-0006dZ-Nt for bug-gnu-emacs@gnu.org; Thu, 07 Jan 2021 09:48:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 07 Jan 2021 14:48:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 45688 X-GNU-PR-Package: emacs Original-Received: via spool by 45688-submit@debbugs.gnu.org id=B45688.161003088125506 (code B ref 45688); Thu, 07 Jan 2021 14:48:01 +0000 Original-Received: (at 45688) by debbugs.gnu.org; 7 Jan 2021 14:48:01 +0000 Original-Received: from localhost ([127.0.0.1]:46931 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kxWa0-0006dK-Mz for submit@debbugs.gnu.org; Thu, 07 Jan 2021 09:48:00 -0500 Original-Received: from quimby.gnus.org ([95.216.78.240]:38538) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kxWZv-0006d3-Nz for 45688@debbugs.gnu.org; Thu, 07 Jan 2021 09:47:59 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnus.org; s=20200322; h=Content-Type:MIME-Version:Message-ID:In-Reply-To:Date: References:Subject:Cc:To:From:Sender:Reply-To:Content-Transfer-Encoding: Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender: Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=/7pELpIIGRkcAqZQMEDg9mh5+HCkkhJ6E6pws1KLJmw=; b=mbPuJ1k5GKYVFtqkFdqv0++uzI oDQT/MXyf6N9SVFHef9lvl9K8PKLk+LKVRNiquXRpZQzWMmvpIAKkQialiH2HNYJlEmvJO0I+yrl/ doGrvJlSB50rlmywHeiz0wNG/MOMOhOwjLQC6vP1jXWvfuozHoSjDPz4ywgODT4SM1kw=; Original-Received: from cm-84.212.202.86.getinternet.no ([84.212.202.86] helo=xo) by quimby.gnus.org with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1kxWZm-00041R-Qj; Thu, 07 Jan 2021 15:47:49 +0100 Face: iVBORw0KGgoAAAANSUhEUgAAADAAAAAwBAMAAAClLOS0AAAABGdBTUEAALGPC/xhBQAAACBj SFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAAG1BMVEWtp5nl3ci0rqPN vq+alYyRf2dbUFETCgz///+G0CkAAAAAAWJLR0QIht6VegAAAAd0SU1FB+UBBw4tCuCLr2MAAAFc SURBVDjLldTdboMgFAdwykx67Zrd02Oz3baebrvtBcYH8OveVniBTl5/gCJKNNn+iTHyywH5ULKL 10OOf4YDmmg4UDBhxIXrlDHZHQhdtFu5GaABRBMEBXNgQU+cu8FDuG3BVAFBOx/HqGyKdJhQ5KEW NuOtm+DUC9mrnpeNMvmZgAkhhWzxU9/7WgQgksR2FVQIecezaZchiBQxZTyTqnssoAW7D9h0VbcA SEwzwVrUzzk8UgN71eZSPE8DgAVIri+oVL/X16ICk7xI9ezyEAjmxaVR/UcIlQbU0Dg4zkHatfIA erYa7huwv1/FHGILPYf34kstACyAnvr3GhANb1uQrgLVi9WsjsEysVZhtk6NrxtNkFUuJedZ6QER fNyBi8dHG+YOqQcrw/E2cPEAlFlgQVdAGB0/0iioAPeVLrtihLoSV5EMJw3PzFdkBtzf5BX8+0UG Nv4l/4ZfnCnXdaRaFEoAAAAldEVYdGRhdGU6Y3JlYXRlADIwMjEtMDEtMDdUMTQ6NDU6MTArMDA6 MDD2Q0mnAAAAJXRFWHRkYXRlOm1vZGlmeQAyMDIxLTAxLTA3VDE0OjQ1OjEwKzAwOjAwhx7xGwAA AABJRU5ErkJggg== X-Now-Playing: Blaine L. Reininger's _Live in Brussels_: "track" In-Reply-To: <616655cc-9b87-cb93-6787-11e7037e8cbc@gmx.at> (martin rudalics's message of "Thu, 7 Jan 2021 14:18:04 +0100") X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list 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-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:197485 Archived-At: martin rudalics writes: > By no means. `display-buffer-overriding-action' is _not_ intended for > the user. It's an emergency exit for applications. Better not even > mention it in the user manual and the doc-string. See, I didn't even get that bit from the doc string. :-) > In every other regard, feel free to change it in a way that sounds less > imitating. For example, listing the action functions and alist entries > in the doc-string is merely distracting. We started out with small sets > and every time a new function or entry was added, we also added it to > those lists. It's an overwhelming doc string, but I think listing the action functions is one of the best bits about it. :-) I've now shuffled it to the front, and given a bit more introductory text to make it sound less intimidating. > And while you're there you could try to make the Emacs > manual entry more amenable for its audience. IIUC that's what the blog > you mentioned criticized even more than the doc-string. Yeah, the manual is rather abrupt here, too, but the entire thing is really complicated, and caters for many different use cases, so I don't really even know where to begin. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no