From: Chong Yidong <cyd@stupidchicken.com>
Date: Thu, 25 Mar 2010 21:14:17 +0000 (-0400)
Subject: Document comint history-search changes.
X-Git-Tag: emacs-pretest-23.1.95~37
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=f2608df3a3700ebefa1293ba0f91ec9d8cf4a9aa;p=emacs.git

Document comint history-search changes.

* misc.texi (Shell Ring): Document new M-r binding.  M-s is no longer bound.
---

diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog
index 4ed2ac129e7..741b226267d 100644
--- a/doc/emacs/ChangeLog
+++ b/doc/emacs/ChangeLog
@@ -6,6 +6,7 @@
 	* emacs.texi: Update node description.
 
 	* misc.texi (Navigation): Document doc-view-continuous.
+	(Shell Ring): Document new M-r binding.  M-s is no longer bound.
 
 2010-03-24  Glenn Morris  <rgm@gnu.org>
 
diff --git a/doc/emacs/misc.texi b/doc/emacs/misc.texi
index 29d529c2a86..808c3bfc3d3 100644
--- a/doc/emacs/misc.texi
+++ b/doc/emacs/misc.texi
@@ -966,12 +966,9 @@ Fetch the next earlier old shell command.
 Fetch the next later old shell command.
 
 @kindex M-r @r{(Shell mode)}
-@kindex M-s @r{(Shell mode)}
-@findex comint-previous-matching-input
-@findex comint-next-matching-input
-@item M-r @var{regexp} @key{RET}
-@itemx M-s @var{regexp} @key{RET}
-Search backwards or forwards for old shell commands that match @var{regexp}.
+@findex comint-history-isearch-backward-regexp
+@item M-r
+Begin an incremental regexp search of old shell commands.
 
 @item C-c C-x
 @kindex C-c C-x @r{(Shell mode)}
@@ -1004,15 +1001,15 @@ successively more recent shell commands from the buffer.
 @kbd{C-@key{UP}} works like @kbd{M-p}, and @kbd{C-@key{DOWN}} like
 @kbd{M-n}.
 
-  The history search commands @kbd{M-r} and @kbd{M-s} read a regular
-expression and search through the history for a matching command.  Aside
-from the choice of which command to fetch, they work just like @kbd{M-p}
-and @kbd{M-n}.  If you enter an empty regexp, these commands reuse the
-same regexp used last time.
-
-  When you find the previous input you want, you can resubmit it by
-typing @key{RET}, or you can edit it first and then resubmit it if you
-wish.  Any partial input you were composing before navigating the
+  The history search command @kbd{M-r} begins an incremental regular
+expression search of previous shell commands.  After typing @kbd{M-r},
+start typing the desired string or regular expression; the last
+matching shell command will be displayed in the current line.
+Incremental search commands have their usual effects---for instance,
+@kbd{C-s} and @kbd{C-r} search forward and backward for the next match
+(@pxref{Incremental Search}).  When you find the desired input, type
+@key{RET} to terminate the search.  This puts the input in the command
+line.  Any partial input you were composing before navigating the
 history list is restored when you go to the beginning or end of the
 history ring.
 
diff --git a/etc/NEWS b/etc/NEWS
index 332cc49e331..f82a3ae825e 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -274,9 +274,14 @@ experience delays when sending mail, you may wish to set this to nil.
 +++
 ** nXML mode is now the default for editing XML files.
 
-** Shell
+** Shell (and other comint modes)
 +++
-*** ansi-color is now enabled by default.
+*** M-s is no longer bound to `comint-next-matching-input'.
++++
+*** M-r is now bound to `comint-history-isearch-backward-regexp'.
+This starts an incremental search of the comint/shell input history.
++++
+*** ansi-color is now enabled by default in Shell mode.
 To disable it, set ansi-color-for-comint-mode to nil.
 
 +++
@@ -356,11 +361,6 @@ to sacrifice some accuracy for a faster startup.
 the command asynchronously without the need to manually add ampersand to
 the end of the command.  Its output appears in the buffer `*Async Shell
 Command*'.
-
-*** Isearch searches in the comint/shell input history when the new variable
-`comint-history-isearch' is non-nil.  New commands `comint-history-isearch-backward'
-and `comint-history-isearch-backward-regexp' (bound to M-r) start Isearch
-in the input history regardless of the value of `comint-history-isearch'.
 +++
 *** Interactively `multi-isearch-buffers' and `multi-isearch-buffers-regexp'
 read buffer names to search, one by one, ended with RET.  With a prefix