From 4d49cc6547d9215da503bd84aadf946e8f2582be Mon Sep 17 00:00:00 2001 From: Glenn Morris Date: Thu, 20 Feb 2014 00:14:20 -0800 Subject: [PATCH] Some doc for search-invisible * doc/emacs/search.texi (Special Isearch): Mention invisible text. * lisp/isearch.el (search-invisible): Doc fix. * etc/NEWS: Related edit. --- doc/emacs/ChangeLog | 4 ++++ doc/emacs/search.texi | 13 +++++++++++++ etc/NEWS | 4 +--- lisp/ChangeLog | 4 ++++ lisp/isearch.el | 6 ++++++ 5 files changed, 28 insertions(+), 3 deletions(-) diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog index c16920d38df..6255f85ff09 100644 --- a/doc/emacs/ChangeLog +++ b/doc/emacs/ChangeLog @@ -1,3 +1,7 @@ +2014-02-20 Glenn Morris + + * search.texi (Special Isearch): Mention invisible text. + 2014-02-18 Glenn Morris * trouble.texi (Contributing) [WWW_GNU_ORG]: Link to diff --git a/doc/emacs/search.texi b/doc/emacs/search.texi index 35aa15ee163..057811ac55c 100644 --- a/doc/emacs/search.texi +++ b/doc/emacs/search.texi @@ -244,6 +244,18 @@ in the search string, the search becomes case-sensitive. If you delete the upper-case character from the search string, it ceases to have this effect. @xref{Search Case}. +@cindex invisible text, searching for +@kindex M-s i @r{(Incremental search)} +@findex isearch-toggle-invisible +@vindex search-invisible + Some Emacs modes hide certain text by making it invisible. For +example, Outline major mode (@pxref{Outline Mode}). By default, +incremental search will search for matches in text hidden by Outline +mode (and some other modes), and make the text visible if it finds a match. +To toggle whether or not invisible text is searched, type +@kbd{M-s i} (@code{isearch-toggle-invisible}). To change the default +for future searches, customize the option @code{search-invisible}. + To search for a newline character, type @kbd{C-j}. To search for non-@acronym{ASCII} characters, use one of the @@ -1047,6 +1059,7 @@ This variable applies to nonincremental searches also, including those performed by the replace commands (@pxref{Replace}) and the minibuffer history matching commands (@pxref{Minibuffer History}). +@c isearch-toggle-case-fold Typing @kbd{M-c} within an incremental search toggles the case sensitivity of that search. The effect does not extend beyond the current incremental search to the next one, but it does override the diff --git a/etc/NEWS b/etc/NEWS index c8f1c7f2252..4b4b405cb2a 100644 --- a/etc/NEWS +++ b/etc/NEWS @@ -766,9 +766,7 @@ symbol found near point added to the search string initially. *** `C-x 8 RET' in Isearch mode reads a character by its Unicode name and adds it to the search string. -*** `M-s i' in Isearch mode toggles the variable `isearch-invisible' -between nil and the value of the option `search-invisible' (or `open' -when it's nil). +*** `M-s i' in Isearch mode toggles whether search matches invisible text. *** `query-replace' skips invisible text when `search-invisible' is nil, and opens overlays with hidden text when `search-invisible' is `open'. diff --git a/lisp/ChangeLog b/lisp/ChangeLog index 833c089f107..9b6b370c452 100644 --- a/lisp/ChangeLog +++ b/lisp/ChangeLog @@ -1,3 +1,7 @@ +2014-02-20 Glenn Morris + + * isearch.el (search-invisible): Doc fix. + 2014-02-20 W. Trevor King (tiny change) * term/xterm.el (xterm--version-handler): Adapt to xterm-280's output diff --git a/lisp/isearch.el b/lisp/isearch.el index e4611c29f65..a158c96c06d 100644 --- a/lisp/isearch.el +++ b/lisp/isearch.el @@ -137,6 +137,12 @@ When the value is `open', if the text matched is made invisible by an overlay having an `invisible' property and that overlay has a property `isearch-open-invisible', then incremental search will show the contents. \(This applies when using `outline.el' and `hideshow.el'.) + +To temporarily change the value for an active incremental search, +use \\\\[isearch-toggle-invisible]. + +See also the related option `isearch-hide-immediately'. + See also `reveal-mode' if you want overlays to automatically be opened whenever point is in one of them." :type '(choice (const :tag "Match hidden text" t) -- 2.39.2