From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Richard Stallman Newsgroups: gmane.emacs.devel Subject: Re: Document that failed search/match preserves match data Date: Sat, 10 May 2003 13:15:24 -0400 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: References: <87d6isi4wi.fsf@tleepslib.sk.tsukuba.ac.jp> Reply-To: rms@gnu.org NNTP-Posting-Host: main.gmane.org X-Trace: main.gmane.org 1052586987 6530 80.91.224.249 (10 May 2003 17:16:27 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Sat, 10 May 2003 17:16:27 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Sat May 10 19:16:25 2003 Return-path: Original-Received: from quimby.gnus.org ([80.91.224.244]) by main.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 19EXxR-0001hB-00 for ; Sat, 10 May 2003 19:16:25 +0200 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.12 #1 (Debian)) id 19EY2y-0005Wh-00 for ; Sat, 10 May 2003 19:22:08 +0200 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.10.13) id 19EXyE-0000PC-06 for emacs-devel@quimby.gnus.org; Sat, 10 May 2003 13:17:14 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.10.13) id 19EXwf-0008V4-00 for emacs-devel@gnu.org; Sat, 10 May 2003 13:15:37 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.10.13) id 19EXwU-000835-00 for emacs-devel@gnu.org; Sat, 10 May 2003 13:15:29 -0400 Original-Received: from fencepost.gnu.org ([199.232.76.164]) by monty-python.gnu.org with esmtp (Exim 4.10.13) id 19EXwT-00082B-00 for emacs-devel@gnu.org; Sat, 10 May 2003 13:15:25 -0400 Original-Received: from rms by fencepost.gnu.org with local (Exim 4.10) id 19EXwS-00086q-00; Sat, 10 May 2003 13:15:24 -0400 Original-To: "Stephen J. Turnbull" In-reply-to: <87d6isi4wi.fsf@tleepslib.sk.tsukuba.ac.jp> (stephen@xemacs.org) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1b5 Precedence: list List-Id: Emacs development discussions. List-Help: List-Post: List-Subscribe: , List-Archive: List-Unsubscribe: , Errors-To: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:13794 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:13794 "On success, a search or match sets the match data for the whole expression and any matched subexpressions. If the search or match fails, the match data from the most recent successful search will be preserved. (You should not depend on the match data being preserved in case of an error in the search function.)"[1] That text looks good for the manual, except that I would interpret "fails" as including the error case. That is the first case that came to my mind when I read those words--only after reading the last sentence did I realize you must mean only when the search function returns nil. It would be better to say "when the function returns nil".