From: Juri Linkov <juri@linkov.net>
Date: Mon, 8 Nov 2021 17:36:57 +0000 (+0200)
Subject: * doc/emacs/search.texi (Isearch Yank): Add isearch-forward-thing-at-point.
X-Git-Tag: emacs-28.0.90~99
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=818211ed8919c380742758e74ab6981dd0acf9ea;p=emacs.git

* doc/emacs/search.texi (Isearch Yank): Add isearch-forward-thing-at-point.

; * etc/NEWS: Add +++ for isearch-forward-thing-at-point, reorder (bug#51444).
---

diff --git a/doc/emacs/search.texi b/doc/emacs/search.texi
index f6d9cb3be18..fbbb1f6e682 100644
--- a/doc/emacs/search.texi
+++ b/doc/emacs/search.texi
@@ -337,6 +337,16 @@ value of the variable @code{search-upper-case} (@pxref{Lax Search,
 search-upper-case}) is other than @code{not-yanks}, that disables this
 down-casing.
 
+@kindex M-s M-.
+@findex isearch-forward-thing-at-point
+  To begin a new incremental search with the text near point yanked
+into the initial search string, type @kbd{M-s M-.} that runs the
+command @code{isearch-forward-thing-at-point}.  If the region was
+active, then it yanks the text from the region into the search string.
+Otherwise, it tries to yank a URL, a symbol or an expression found
+near point.  What to yank is defined by the user option
+@code{isearch-forward-thing-at-point}.
+
 @node Error in Isearch
 @subsection Errors in Incremental Search
 
diff --git a/etc/NEWS b/etc/NEWS
index dc1eb86c6f0..2c6c739a0ec 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -1254,6 +1254,14 @@ distinguish between sub-expression highlighting.
 Like 'search-highlight-submatches', this is controlled by the new user option
 'query-replace-highlight-submatches'.
 
++++
+*** New key 'M-s M-.' starts isearch looking for the thing at point.
+This key is bound to the new command 'isearch-forward-thing-at-point'.
+The new user option 'isearch-forward-thing-at-point' defines
+a list of symbols to try to get the "thing" at point.  By default,
+the first element of the list is 'region' that tries to yank
+the currently active region to the search string.
+
 +++
 *** New user option 'isearch-wrap-pause' defines how to wrap the search.
 There are choices to disable wrapping completely and to wrap immediately.
@@ -1267,12 +1275,17 @@ When this option is set, direction changes in Isearch move to another
 search match, if there is one, instead of moving point to the other
 end of the current match.
 
-*** New key 'M-s M-.' starts isearch looking for the thing at point.
-This key is bound to the new command 'isearch-forward-thing-at-point'.
-The new user option 'isearch-forward-thing-at-point' defines
-a list of symbols to try to get the "thing" at point.  By default,
-the first element of the list is 'region' that tries to yank
-the currently active region to the search string.
++++
+*** New user option 'isearch-allow-motion'.
+When 'isearch-allow-motion' is set, the commands 'beginning-of-buffer',
+'end-of-buffer', 'scroll-up-command' and 'scroll-down-command', when
+invoked during I-search, move respectively to the first occurrence of
+the current search string in the buffer, the last one, the first one
+after the current window, and the last one before the current window.
+Additionally, users can change the meaning of other motion commands
+during I-search by using their 'isearch-motion' property.  The user
+option 'isearch-motion-changes-direction' controls whether the
+direction of the search changes after a motion command.
 
 +++
 *** New user option 'lazy-highlight-no-delay-length'.
@@ -1384,17 +1397,6 @@ keys, add the following to your init file:
 Using it instead of 'read-char-choice' allows using 'C-x o'
 to switch to the help window displayed after typing 'C-h'.
 
-+++
-** New user option 'isearch-allow-motion'.
-When 'isearch-allow-motion' is set, the commands 'beginning-of-buffer',
-'end-of-buffer', 'scroll-up-command' and 'scroll-down-command', when
-invoked during I-search, move respectively to the first occurrence of
-the current search string in the buffer, the last one, the first one
-after the current window, and the last one before the current window.
-Additionally, users can change the meaning of other motion commands
-during I-search by using their 'isearch-motion' property.  The user
-option 'isearch-motion-changes-direction' controls whether the
-direction of the search changes after a motion command.
 
 +++
 ** Emacs 28.1 comes with Org v9.5.