]> git.eshelyaron.com Git - emacs.git/commitdiff
Document isearch-wrap-pause
authorLars Ingebrigtsen <larsi@gnus.org>
Tue, 21 Sep 2021 20:01:28 +0000 (22:01 +0200)
committerLars Ingebrigtsen <larsi@gnus.org>
Tue, 21 Sep 2021 20:01:28 +0000 (22:01 +0200)
* doc/emacs/search.texi (Repeat Isearch): Document
`isearch-wrap-pause'.

doc/emacs/search.texi
etc/NEWS

index e4322e361f63b4b023bf52586653cfd55d1c4e4b..8a101f1150b5b44fc1f31ea4e571f1ff8ba98dfa 100644 (file)
@@ -222,6 +222,15 @@ going past the original starting point of the search, it changes to
 @samp{Overwrapped}, which means that you are revisiting matches that
 you have already seen.
 
+@vindex isearch-wrap-pause
+  You can control what happens when there are no more matches by
+customizing the @code{isearch-wrap-pause} user option.  If it is
+@code{t} (the default), signal an error.  (Repeating the search will
+wrap around.)  If @code{no}, issue a @code{ding} and wrap immediately
+after reaching the last match.  If @code{no-ding}, wrap immediately,
+but don't @code{ding}.  Finally, if @code{nil}, never wrap, but just
+stop at the last match.
+
 @cindex search ring
 @findex isearch-ring-advance
 @findex isearch-ring-retreat
index 7765f5a6797b48a47a227c7cac26ca02e6e1e6b0..4bdbdeae0b1044612976b67e569f414c724e56c2 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -1044,10 +1044,12 @@ achieve that.
 +++
 ** New command 'C-x C-k Q' to force redisplay in keyboard macros.
 
+---
 ** 'blink-cursor-mode' is now enabled by default regardless of the UI.
 It used to be enabled when Emacs is started in GUI mode but not when started
 in text mode.  The cursor still only actually blinks in GUI frames.
 
++++
 ** New minor mode 'show-paren-local-mode'.
 It serves as a local counterpart for 'show-paren-mode', allowing you
 to toggle it separately in different buffers.
@@ -1074,6 +1076,7 @@ distinguish between sub-expression highlighting.
 Like 'search-highlight-submatches', this is controlled by the new user option
 'query-replace-highlight-submatches'.
 
++++
 *** New user option 'isearch-wrap-pause' defines how to wrap the search.
 There are choices to disable wrapping completely and to wrap immediately.
 When wrapping immediately, it consistently handles the numeric arguments