# HG changeset patch
# User stephent
# Date 1084172674 0
# Node ID 7dc50bbd7a39a10356de0fc8a95664a1628878e1
# Parent  0750eca4d23a2a917b78e1abcff3935c1bb74298
[xemacs-hg @ 2004-05-10 07:04:34 by stephent]
docstring tweaks <87zn8g3gt7.fsf_-_@tleepslib.sk.tsukuba.ac.jp>

diff -r 0750eca4d23a -r 7dc50bbd7a39 lisp/ChangeLog
--- a/lisp/ChangeLog	Mon May 10 06:26:31 2004 +0000
+++ b/lisp/ChangeLog	Mon May 10 07:04:34 2004 +0000
@@ -1,3 +1,8 @@
+2004-05-10  Stephen J. Turnbull  <stephen@xemacs.org>
+
+	* isearch-mode.el (isearch-forward, isearch-abort): Document that our
+	behavior of `isearch-abort' differs from that of GNU Emacs.
+
 2004-05-08  Sven Grundmann  <sven@xemacs.org>
 
 	* etags.el:
diff -r 0750eca4d23a -r 7dc50bbd7a39 lisp/isearch-mode.el
--- a/lisp/isearch-mode.el	Mon May 10 06:26:31 2004 +0000
+++ b/lisp/isearch-mode.el	Mon May 10 07:04:34 2004 +0000
@@ -431,7 +431,10 @@
  back to what has
  been found successfully.
 \\[isearch-abort] when search is successful aborts and moves point to\
- starting point.
+ starting point,
+ leaving the search string at the head of the search ring.  Note that this
+ behavior differs from GNU Emacs, which forgets the current search string
+ on abort regardless of success or failure.
 
 Also supported is a search ring of the previous 16 search strings.
 Type \\[isearch-ring-advance] to search for the next item in the search ring.
@@ -864,6 +867,11 @@
 
 (defun isearch-abort ()
   "Abort incremental search mode if searching is successful, signaling quit.
+Leave the search string at the head of the search ring.  Note that this
+behavior differs from GNU Emacs, which forgets the current search string
+on abort regardless of success or failure.  Use `isearch-cancel' to abort
+and forget regardless of success or failure.
+
 Otherwise, revert to previous successful search and continue searching.
 Use `isearch-exit' to quit without signaling."
   (interactive)