emacs-31 8e33b6a059b: ; Document C-x <UP> in shell-mode.

branch: emacs-31
commit 8e33b6a059b2d938223bc1ed2d110a5771fcc55e
Author: Sean Whitton <[email protected]>
Commit: Sean Whitton <[email protected]>

    ; Document C-x <UP> in shell-mode.
---
 doc/emacs/misc.texi | 12 ++++++++++++
 etc/NEWS            |  1 +
 2 files changed, 13 insertions(+)

diff --git a/doc/emacs/misc.texi b/doc/emacs/misc.texi
index be6aa29c1c2..9067a20efd4 100644
--- a/doc/emacs/misc.texi
+++ b/doc/emacs/misc.texi
@@ -1303,6 +1303,12 @@ resubmit them or copy them to the end.  Or you can use a
 Fetch the next earlier old shell command
 (@code{comint-previous-input}).
 
+@findex comint-complete-input-ring
+@kindex C-x @key{UP} @r{(Shell mode)}
+@item C-x @key{UP}
+Complete the current input using shell command history
+(@code{comint-complete-input-ring}).
+
 @kindex M-n @r{(Shell mode)}
 @findex comint-next-input
 @item M-n
@@ -1350,6 +1356,12 @@ 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}.
 
+  @kbd{C-x @key{UP}} tries to complete (@pxref{Completion}) your current
+input against the history of old shell commands.  So, for example, you
+could type the first few words of a long and complex shell command you
+executed earlier, then invoke this command to have Emacs fill in the
+rest of it.
+
   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
diff --git a/etc/NEWS b/etc/NEWS
index 768a8dc79df..e63a04a96e9 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -2101,6 +2101,7 @@ Shell bookmarks can be loaded via the menu and by using the command
 its current directory, and creates a remote connection, if necessary.
 You can customize 'shell-bookmark-name-function'.
 
++++
 *** New command to complete the shell history.
 'comint-complete-input-ring' ('C-x <UP>') is like 'minibuffer-complete-history'
 but completes on comint inputs.