From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Sebastian Wiesner Newsgroups: gmane.emacs.bugs Subject: bug#22210: 25.0.50; display-message-or-buffer docstring refers to wrong argument in display-buffer Date: Sat, 19 Dec 2015 10:15:56 +0100 Message-ID: <5B958F32-EA39-487C-822A-EDCE157ECCB9@lunaryorn.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 (Mac OS X Mail 9.2 \(3112\)) Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1450516644 18819 80.91.229.3 (19 Dec 2015 09:17:24 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 19 Dec 2015 09:17:24 +0000 (UTC) To: 22210@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Dec 19 10:17:12 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 1aADdX-00079g-SZ for geb-bug-gnu-emacs@m.gmane.org; Sat, 19 Dec 2015 10:17:12 +0100 Original-Received: from localhost ([::1]:36617 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aADdW-0003iF-Mb for geb-bug-gnu-emacs@m.gmane.org; Sat, 19 Dec 2015 04:17:10 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:52582) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aADdS-0003cv-19 for bug-gnu-emacs@gnu.org; Sat, 19 Dec 2015 04:17:06 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aADdO-0000Ow-RY for bug-gnu-emacs@gnu.org; Sat, 19 Dec 2015 04:17:05 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:48625) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aADdO-0000Os-OM for bug-gnu-emacs@gnu.org; Sat, 19 Dec 2015 04:17:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84) (envelope-from ) id 1aADdO-0003O8-IG for bug-gnu-emacs@gnu.org; Sat, 19 Dec 2015 04:17:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Sebastian Wiesner Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 19 Dec 2015 09:17:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 22210 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.145051657212958 (code B ref -1); Sat, 19 Dec 2015 09:17:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 19 Dec 2015 09:16:12 +0000 Original-Received: from localhost ([127.0.0.1]:56227 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1aADca-0003Mw-MY for submit@debbugs.gnu.org; Sat, 19 Dec 2015 04:16:12 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:33060) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1aADcY-0003Mj-RO for submit@debbugs.gnu.org; Sat, 19 Dec 2015 04:16:11 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aADcS-0000Fv-Fb for submit@debbugs.gnu.org; Sat, 19 Dec 2015 04:16:05 -0500 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:35119) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aADcS-0000Fr-CS for submit@debbugs.gnu.org; Sat, 19 Dec 2015 04:16:04 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:52264) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aADcR-0003Ya-GY for bug-gnu-emacs@gnu.org; Sat, 19 Dec 2015 04:16:04 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aADcO-0000FK-Ak for bug-gnu-emacs@gnu.org; Sat, 19 Dec 2015 04:16:03 -0500 Original-Received: from mx1.mailbox.org ([80.241.60.212]:59180) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aADcO-0000F6-4h for bug-gnu-emacs@gnu.org; Sat, 19 Dec 2015 04:16:00 -0500 Original-Received: from smtp1.mailbox.org (smtp1.mailbox.org [80.241.60.240]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.mailbox.org (Postfix) with ESMTPS id 51C414344C for ; Sat, 19 Dec 2015 10:15:58 +0100 (CET) X-Virus-Scanned: amavisd-new at heinlein-support.de Original-Received: from smtp1.mailbox.org ([80.241.60.240]) by hefe.heinlein-support.de (hefe.heinlein-support.de [91.198.250.172]) (amavisd-new, port 10030) with ESMTP id eXaOP69uxheg for ; Sat, 19 Dec 2015 10:15:57 +0100 (CET) X-Mailer: Apple Mail (2.3112) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x 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-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:110162 Archived-At: The docstring of `display-message-or-buffer' reads as follows: ---- (display-message-or-buffer MESSAGE &optional BUFFER-NAME NOT-THIS-WINDOW = FRAME) [=E2=80=A6] Optional arguments NOT-THIS-WINDOW and FRAME are as for = =E2=80=98display-buffer=E2=80=99, and only used if a buffer is displayed. ---- However, display-buffer does not actually have a NOT-THIS-WINDOW = argument: (display-buffer BUFFER-OR-NAME &optional ACTION FRAME) The source of display-message-or-buffer reveals that NOT-THIS-WINDOW is = actually=20 passed in the ACTION argument. I think the argument of display-message-or-buffer should be renamed to = ACTION=20 as well. Currently it's pretty confusing and may lead to wrong guesses = about the semantics of this argument. Greetings, Sebastian=