From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: David Kastrup Newsgroups: gmane.emacs.devel Subject: Re: message's docstring Date: Sun, 12 Nov 2006 11:16:22 +0100 Message-ID: <85r6w9ynpl.fsf@lola.goethe.zz> References: NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1163326626 26213 80.91.229.2 (12 Nov 2006 10:17:06 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sun, 12 Nov 2006 10:17:06 +0000 (UTC) Cc: emacs- devel Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Nov 12 11:17:03 2006 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1GjCOa-00009V-He for ged-emacs-devel@m.gmane.org; Sun, 12 Nov 2006 11:17:00 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1GjCOZ-0006QQ-QY for ged-emacs-devel@m.gmane.org; Sun, 12 Nov 2006 05:16:59 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1GjCOA-0006Nk-QN for emacs-devel@gnu.org; Sun, 12 Nov 2006 05:16:34 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1GjCO8-0006N3-NK for emacs-devel@gnu.org; Sun, 12 Nov 2006 05:16:33 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1GjCO7-0006Mt-7c for emacs-devel@gnu.org; Sun, 12 Nov 2006 05:16:31 -0500 Original-Received: from [199.232.76.164] (helo=fencepost.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.52) id 1GjCO7-0002hy-8H for emacs-devel@gnu.org; Sun, 12 Nov 2006 05:16:31 -0500 Original-Received: from localhost ([127.0.0.1] helo=lola.goethe.zz) by fencepost.gnu.org with esmtp (Exim 4.34) id 1GjCO6-0001HY-Na; Sun, 12 Nov 2006 05:16:30 -0500 Original-Received: by lola.goethe.zz (Postfix, from userid 1002) id 747491CD9DA7; Sun, 12 Nov 2006 11:16:22 +0100 (CET) Original-To: "Juanma Barranquero" In-Reply-To: (Juanma Barranquero's message of "Sun\, 12 Nov 2006 01\:11\:02 +0100") User-Agent: Gnus/5.11 (Gnus v5.11) Emacs/22.0.90 (gnu/linux) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:62103 Archived-At: "Juanma Barranquero" writes: > Two slight inconsistencies/problems in message's docstring: > > 1) It says: > > DEFUN ("message", Fmessage, Smessage, 1, MANY, 0, > doc: /* Print a one-line message at the bottom of the screen. > > Why "a one-line message"? There's nothing stopping > > (message "line 1\nline 2") > > for working, or even > > (message "%s\n%s" "line1" "line2") > > 2) The docstring doesn't mention that the message is returned. > However, several modules do rely on it (files.el, for example, has > "(y-or-n-p (message ...))". That sounds nonsensical. Shouldn't this be (y-or-n-p (format ...)) instead? -- David Kastrup, Kriemhildstr. 15, 44793 Bochum