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: Mon, 5 Aug 2019 11:23:51 +0200 Message-ID: <5ae3125c-1c5c-ebd1-7ddc-48e82f2bc7aa@gmx.at> References: <97135b13-1c29-44a9-bfd9-f12966e56cd4@default> <8736ijmh50.fsf@mouse.gnus.org> 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="97485"; mail-complaints-to="usenet@blaine.gmane.org" Cc: 19461@debbugs.gnu.org To: Drew Adams , Lars Ingebrigtsen Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Aug 05 11:25:18 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 1huZEz-000PBV-B8 for geb-bug-gnu-emacs@m.gmane.org; Mon, 05 Aug 2019 11:25:17 +0200 Original-Received: from localhost ([::1]:52026 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1huZEy-0000NP-0U for geb-bug-gnu-emacs@m.gmane.org; Mon, 05 Aug 2019 05:25:16 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:59262) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1huZEk-0000NJ-Ub for bug-gnu-emacs@gnu.org; Mon, 05 Aug 2019 05:25:03 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1huZEj-0004uE-Tg for bug-gnu-emacs@gnu.org; Mon, 05 Aug 2019 05:25:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:54031) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1huZEj-0004u8-Pr for bug-gnu-emacs@gnu.org; Mon, 05 Aug 2019 05:25:01 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1huZEj-0005yO-Jy for bug-gnu-emacs@gnu.org; Mon, 05 Aug 2019 05:25:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: martin rudalics Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 05 Aug 2019 09:25: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.156499704522894 (code B ref 19461); Mon, 05 Aug 2019 09:25:01 +0000 Original-Received: (at 19461) by debbugs.gnu.org; 5 Aug 2019 09:24:05 +0000 Original-Received: from localhost ([127.0.0.1]:34619 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1huZDo-0005xC-S6 for submit@debbugs.gnu.org; Mon, 05 Aug 2019 05:24:05 -0400 Original-Received: from mout.gmx.net ([212.227.15.15]:48971) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1huZDn-0005wN-Cl for 19461@debbugs.gnu.org; Mon, 05 Aug 2019 05:24:03 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=badeba3b8450; t=1564997032; bh=NWpVF2PQcapmDHH/IBrIeCkR+Hy52sedVK7RGrxHa+s=; h=X-UI-Sender-Class:Subject:To:Cc:References:From:Date:In-Reply-To; b=Pb7CqOp+JTsWQ7WdBuXVaF0kyQr4w/3+sq3i7mbJxlqFZudJfuhb0VvcRK/fsbXsx suvQn2zZA3xjsfvJPCTG5BJPGFNX7ZRzHdIl7jLyGgFV9WvZ77+8bfGHbuKiXZFhPn ncCUO/yXZL6uMRSd68MhxrWQT5/JTqqCn7MkdwHg= X-UI-Sender-Class: 01bb95c1-4bf8-414a-932a-4f6e2808ef9c Original-Received: from [192.168.1.101] ([213.162.73.205]) by mail.gmx.com (mrgmx005 [212.227.17.190]) with ESMTPSA (Nemesis) id 1MzQkE-1iGLGa1x3o-00vST5; Mon, 05 Aug 2019 11:23:52 +0200 In-Reply-To: Content-Language: de-DE X-Provags-ID: V03:K1:cyGxsTKUMnG9zUBZU31JyHYOMoMiSw4rQEUobLqhjGQw0E0sIK3 huQsT1P4bzb7JHxPAJghJfacET6j3hifdd4Gli/d6mfQtGndHRrWL97wdov0u/f3FIjj5Vp KWvZ+hAj1DSN0VdwYZsbWGNYCQTqym7DzIe1p/YelYPahzzQlxqdt15KzYCHCM7TCwDHOAf P8taqL0A7PkG3r1QhR03A== X-UI-Out-Filterresults: notjunk:1;V03:K0:jYMJZoi5awE=:BQnrHbjLCBXhJQDEBqir6T coRu/xDCaLOd+6QfUv6UlgFoigy9cxCeVuHFTtc2Au8ZmqZ96QBHZA1kooa1DS4jDOR8gWpLp g0oiGvbsZzvKEZsQdf3p8pts6vMXNtWZtTsztGzDDB9ObGkAfTG5WsaxGAAvtB1eTUM/uv7kv /YWxkLKNIFJWwZIrl0Ahrh32UlXR6O1013wZOz9n1ceoTBkE0kcaH+U1u5WPkr7H2MG1tPxjY g5J3FOnYQ/PlHozGc5spbZzaF5xy9Y2vPX08n6pqGLAXeupdf7c/n8J8Kjq1MY3vlabklrZlH AhtOm9FzzjfEVabPWAh1ElkMtBxeTki9OKXyTRm1xiG3tYQsx4rx8WY+OGjMk7PytTlDuMIeI Tui1Ir4B9JzLOlWg974msozmDMPlwHDsbv8Fmu1FWqS858lxiKWihPLubQ+mis3tUN2ick5AJ eJToZs9zET5hxcO6/bL9KIPFKuWKa+6BC1E5iH73ElsIssjSH+ebHEXzG6kSTUsptgXe7og26 fzbO3MzUs0+V2FcqE4ahq0T+oQLX+DQbI8wYhhUyXxRHLdh78oGqMYLD2l3e7XBRIM7yFBtG2 Yt4Y8mUAlYBMSOaSwqaFQIPYC1x2L4QMgaXB2NQSPXV48fV3X6DSunJTAwT06ELRWRSeuNxv7 x/12vYYHYJKPHetZQoj/hoRH2bF4I31+lgzqXUc4/c2/xDMwzez8MbAm/JFW0SyprrWl6ni4X WWjWcou+F1cvoH1e+7Mn8Bp44tkZclrCuuC6BqRK5co6NKHMMGvx5xbvNHMH+8dWVx+kdQ85 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:164625 Archived-At: >> Saying what it is is non-trivial, see section 28.13.3 of the Elisp >> manual. So I have no good idea how to do what you propose. > > If saying what it is is non-trivial for the > maintainers, and I'm sure you're right about > that, then imagine the difficulty of a user to > understand what it is, especially if we do not > say what it is. Non-trivial means that it would require some twenty or more lines of text to describe the construction of the ALIST argument from its various sources not even counting a listing of its potential constituents. And this would then have to be duplicated among the doc-strings of all these functions. > If it can be said only in the manual, then the > doc string can, I guess, just punt with a link > to the appropriate section of the manual. Eli has done that now. martin