From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#19571: 25.0.50; `display-buffer-alist': ALIST is completely undefined Date: Mon, 19 Jan 2015 18:07:22 +0200 Message-ID: <83vbk2ycsl.fsf@gnu.org> References: <5526ae92-4543-48d1-b553-7524dd9ff984@default> <834mrw6542.fsf@gnu.org> <83387g56f4.fsf@gnu.org> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1421683698 10481 80.91.229.3 (19 Jan 2015 16:08:18 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 19 Jan 2015 16:08:18 +0000 (UTC) Cc: 19571-done@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Jan 19 17:08:13 2015 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1YDEs9-00013N-98 for geb-bug-gnu-emacs@m.gmane.org; Mon, 19 Jan 2015 17:08:13 +0100 Original-Received: from localhost ([::1]:38280 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YDEs8-0007GT-MG for geb-bug-gnu-emacs@m.gmane.org; Mon, 19 Jan 2015 11:08:12 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:34678) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YDEs4-0007FO-LE for bug-gnu-emacs@gnu.org; Mon, 19 Jan 2015 11:08:09 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YDEry-0008Pk-W9 for bug-gnu-emacs@gnu.org; Mon, 19 Jan 2015 11:08:08 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:52728) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YDEry-0008OL-TS for bug-gnu-emacs@gnu.org; Mon, 19 Jan 2015 11:08:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1YDEry-0002MZ-IV for bug-gnu-emacs@gnu.org; Mon, 19 Jan 2015 11:08:02 -0500 Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-To: bug-gnu-emacs@gnu.org Resent-Date: Mon, 19 Jan 2015 16:08:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: cc-closed 19571 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Mail-Followup-To: 19571@debbugs.gnu.org, eliz@gnu.org, drew.adams@oracle.com Original-Received: via spool by 19571-done@debbugs.gnu.org id=D19571.14216836639050 (code D ref 19571); Mon, 19 Jan 2015 16:08:02 +0000 Original-Received: (at 19571-done) by debbugs.gnu.org; 19 Jan 2015 16:07:43 +0000 Original-Received: from localhost ([127.0.0.1]:33355 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YDEre-0002Lt-FV for submit@debbugs.gnu.org; Mon, 19 Jan 2015 11:07:42 -0500 Original-Received: from mtaout29.012.net.il ([80.179.55.185]:42489) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YDEra-0002LZ-Qv for 19571-done@debbugs.gnu.org; Mon, 19 Jan 2015 11:07:40 -0500 Original-Received: from conversion-daemon.mtaout29.012.net.il by mtaout29.012.net.il (HyperSendmail v2007.08) id <0NIF00300LT3YB00@mtaout29.012.net.il> for 19571-done@debbugs.gnu.org; Mon, 19 Jan 2015 18:04:12 +0200 (IST) Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by mtaout29.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0NIF004RELZ0RB10@mtaout29.012.net.il>; Mon, 19 Jan 2015 18:04:12 +0200 (IST) In-reply-to: X-012-Sender: halo1@inter.net.il X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 140.186.70.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-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:98476 Archived-At: > Date: Sun, 18 Jan 2015 13:12:03 -0800 (PST) > From: Drew Adams > Cc: 19571@debbugs.gnu.org > > > > > > ALIST is mentioned only here: > > > > > > > > > > ACTION is a cons cell (FUNCTION . ALIST), where FUNCTION is a > > > > > function or a list of functions. Each such function should > > > > > accept two arguments: a buffer to display and an alist of the > > > > > same form as ALIST. See `display-buffer' for details. > > > > > > > > > > "of the same form as ALIST"? Really? What form is that? Where is > > > > > *anything* said about the form of ALIST? > > > > > > > > It's an alist. And you are referred to the documentation of > > > > 'display-buffer' for details. I see nothing wrong with that. > > > > > > No, you are referred to `display-buffer' for ACTION - for info about > > > everything in the ACTION paragraph. > > > > Since (see above) "ACTION is a cons cell (FUNCTION . ALIST)", > > describing ACTION also describes ALIST, which is part of ACTION. IOW, > > "everything in the ACTION paragraph" includes ALIST. > > The very next sentence I wrote is key: > > Nothing says that the ALIST here is related to the ALIST mentioned > for `display-buffer', at all. > > That's the point. If ALIST here is the same as ALIST in the > `display-buffer' description, then it is sufficient to refer > to the latter. It's the same word, and there are no other ALISTs around, so why wouldn't it be? We use the same word for the same thing all over the place, and the last thing I'd imagine is that someone could not understand they mean the same. > See above. If it helps, great. If not, so be it. To repeat: > > But do with the doc string what you like. If you find it perfectly > clear, more power to you. I'm just reporting that I find it > confusing and not so helpful. HTH. OK, closing.