--- 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:

--- 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)