From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Alan Mackenzie Newsgroups: gmane.emacs.bugs Subject: elisp manual "Signalling Errors". The word "signal" is unclear Date: Thu, 9 May 2002 09:22:59 +0000 Organization: muc.de e.V. -- private internet access Sender: bug-gnu-emacs-admin@gnu.org Message-ID: NNTP-Posting-Host: localhost.gmane.org X-Trace: main.gmane.org 1020936244 12314 127.0.0.1 (9 May 2002 09:24:04 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Thu, 9 May 2002 09:24:04 +0000 (UTC) Return-path: Original-Received: from fencepost.gnu.org ([199.232.76.164]) by main.gmane.org with esmtp (Exim 3.33 #1 (Debian)) id 175k9b-0003CV-00 for ; Thu, 09 May 2002 11:24:03 +0200 Original-Received: from localhost ([127.0.0.1] helo=fencepost.gnu.org) by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian)) id 175k9j-0000CV-00; Thu, 09 May 2002 05:24:11 -0400 Original-Received: from marvin.muc.de ([193.149.48.2]) by fencepost.gnu.org with smtp (Exim 3.34 #1 (Debian)) id 175k89-00009E-00 for ; Thu, 09 May 2002 05:22:33 -0400 Original-Received: (qmail 25494 invoked by uid 8); 9 May 2002 09:21:45 -0000 Original-To: gnu-emacs-bug@prep.ai.mit.edu Original-Path: not-for-mail Original-Newsgroups: gnu.emacs.bug Original-Lines: 22 Original-NNTP-Posting-Host: acm.muc.de Original-X-Trace: marvin.muc.de 1020936105 25490 193.149.49.134 (9 May 2002 09:21:45 GMT) Original-X-Complaints-To: news-admin@muc.de Original-NNTP-Posting-Date: 9 May 2002 09:21:45 GMT User-Agent: tin/1.4.5-20010409 ("One More Nightmare") (UNIX) (Linux/2.0.35 (i686)) Errors-To: bug-gnu-emacs-admin@gnu.org X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.0.9 Precedence: bulk List-Help: List-Post: List-Subscribe: , List-Id: Bug reports for GNU Emacs, the Swiss army knife of text editors List-Unsubscribe: , List-Archive: Xref: main.gmane.org gmane.emacs.bugs:1256 X-Report-Spam: http://spam.gmane.org/gmane.emacs.bugs:1256 Elisp manual version 2.7. Page "Signalling Errors". The documentation for the function ERROR states > This function signals an error with an error message constructed by applying > `format' (*note String Conversion::) to FORMAT-STRING and ARGS. To me it is a little unclear whether "signal" just means "signal this error message to the user" (i.e. display it), or in addition "abort the currently running function." I'm pretty sure it means the latter. I think it would be useful to clarify this by inserting a paragraph near the top of the info page along these lines: "\"Signalling\" an error means aborting the running function with an error message. If you just want to report an error to the user and then carry on running the current function, use the function MESSAGE instead." -- Alan Mackenzie (Munich, Germany) Email: aacm@muuc.dee; to decode, wherever there is a repeated letter (like "aa"), remove half of them (leaving, say, "a").