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.

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  <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 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  <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 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-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)