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.

diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog
index c16920d38dfbb3af5789d6d6b4918ffa9767fad4..6255f85ff09916fc0b774a70c4b1965164b28582 100644 (file)
--- a/doc/emacs/ChangeLog
+++ b/doc/emacs/ChangeLog
@@ -1,3 +1,7 @@
+2014-02-20  Glenn Morris  <rgm@gnu.org>
+
+       * search.texi (Special Isearch): Mention invisible text.
+
 2014-02-18  Glenn Morris  <rgm@gnu.org>
 
        * trouble.texi (Contributing) [WWW_GNU_ORG]: Link to

diff --git a/doc/emacs/search.texi b/doc/emacs/search.texi
index 35aa15ee163058a6b29e2fbb1e9831a53ec105da..057811ac55c5659a9e64f0ecfec15937d3ee3734 100644 (file)
--- 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 c8f1c7f225261145d95216b16ab0590f2d503568..4b4b405cb2a9343b9f407e58cd9ee814db7d64d9 100644 (file)
--- 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 833c089f10722a4e858f4a0bd40f43b333d1cfae..9b6b370c45234e60d8b4903ae8246bfb2561cff5 100644 (file)
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,3 +1,7 @@
+2014-02-20  Glenn Morris  <rgm@gnu.org>
+
+       * isearch.el (search-invisible): Doc fix.
+
 2014-02-20  W. Trevor King  <wking@tremily.us>  (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 e4611c29f65737ff441efbd82d117d786e094abc..a158c96c06de2d69e028381abc29f301025b2563 100644 (file)
--- 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-mode-map>\\[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)