[Emacs-diffs] trunk r116487: Some doc for search-invisible

[Glenn Morris]

------------------------------------------------------------
revno: 116487
revision-id: address@hidden
parent: address@hidden
committer: Glenn Morris <address@hidden>
branch nick: trunk
timestamp: Thu 2014-02-20 00:14:20 -0800
message:
  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.
modified:
  doc/emacs/ChangeLog            changelog-20091113204419-o5vbwnq5f7feedwu-6227
  doc/emacs/search.texi          
search.texi-20091113204419-o5vbwnq5f7feedwu-6276
  etc/NEWS                       news-20100311060928-aoit31wvzf25yr1z-1
  lisp/ChangeLog                 changelog-20091113204419-o5vbwnq5f7feedwu-1432
  lisp/isearch.el                isearch.el-20091113204419-o5vbwnq5f7feedwu-486

=== modified file 'doc/emacs/ChangeLog'
--- a/doc/emacs/ChangeLog       2014-02-18 18:15:29 +0000
+++ b/doc/emacs/ChangeLog       2014-02-20 08:14:20 +0000
@@ -1,3 +1,7 @@
+2014-02-20  Glenn Morris  <address@hidden>
+
+       * search.texi (Special Isearch): Mention invisible text.
+
 2014-02-18  Glenn Morris  <address@hidden>
 
        * trouble.texi (Contributing) [WWW_GNU_ORG]: Link to

=== modified file 'doc/emacs/search.texi'
--- a/doc/emacs/search.texi     2014-02-08 06:51:42 +0000
+++ b/doc/emacs/search.texi     2014-02-20 08:14:20 +0000
@@ -244,6 +244,18 @@
 delete the upper-case character from the search string, it ceases to
 have this effect.  @xref{Search Case}.
 
address@hidden invisible text, searching for
address@hidden M-s i @r{(Incremental search)}
address@hidden isearch-toggle-invisible
address@hidden 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
address@hidden 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 address@hidden characters, use one of the
@@ -1047,6 +1059,7 @@
 performed by the replace commands (@pxref{Replace}) and the minibuffer
 history matching commands (@pxref{Minibuffer History}).
 
address@hidden 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

=== modified file 'etc/NEWS'
--- a/etc/NEWS  2014-02-20 07:38:47 +0000
+++ b/etc/NEWS  2014-02-20 08:14:20 +0000
@@ -766,9 +766,7 @@
 *** `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'.

=== modified file 'lisp/ChangeLog'
--- a/lisp/ChangeLog    2014-02-20 04:45:19 +0000
+++ b/lisp/ChangeLog    2014-02-20 08:14:20 +0000
@@ -1,3 +1,7 @@
+2014-02-20  Glenn Morris  <address@hidden>
+
+       * isearch.el (search-invisible): Doc fix.
+
 2014-02-20  W. Trevor King  <address@hidden>  (tiny change)
 
        * term/xterm.el (xterm--version-handler): Adapt to xterm-280's output

=== modified file 'lisp/isearch.el'
--- a/lisp/isearch.el   2014-02-10 01:34:22 +0000
+++ b/lisp/isearch.el   2014-02-20 08:14:20 +0000
@@ -137,6 +137,12 @@
 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)