[5763] doc updates for info searching

[Gavin D. Smith]

Revision: 5763
          http://svn.sv.gnu.org/viewvc/?view=rev&root=texinfo&revision=5763
Author:   gavin
Date:     2014-08-20 16:11:08 +0000 (Wed, 20 Aug 2014)
Log Message:
-----------
doc updates for info searching

Modified Paths:
--------------
    trunk/ChangeLog
    trunk/doc/info-stnd.texi

Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog     2014-08-20 13:48:06 UTC (rev 5762)
+++ trunk/ChangeLog     2014-08-20 16:11:08 UTC (rev 5763)
@@ -1,5 +1,14 @@
 2014-08-20  Gavin Smith  <address@hidden>
 
+       * doc/info-stnd.texi (Searching Commands): Consistent formatting
+       for commands without key bindings.  Mention alternative for searching
+       backwards.  Remove reference to Emacs regular expressions, as those
+       are slightly different.  Mention what happens if you don't give a
+       string for 'i'.  Mention 'highlight-searches' variable.
+       (Variables): Add 'highlight-searches'.
+
+2014-08-20  Gavin Smith  <address@hidden>
+
        * info/session.c (info_search_next, info_search_previous): Call
        info_search_internal directly instead of via info_search_1.
        <search-skip-screen=On>: Scroll up or down by a whole number of

Modified: trunk/doc/info-stnd.texi
===================================================================
--- trunk/doc/info-stnd.texi    2014-08-20 13:48:06 UTC (rev 5762)
+++ trunk/doc/info-stnd.texi    2014-08-20 16:11:08 UTC (rev 5763)
@@ -1143,7 +1143,8 @@
 predefined limit.  By default, this limit is set to 1 character.
 @xref{min-search-length}, for more information on this.
 
address@hidden @kbd{?} (@code{search-backward}, vi-like operation)
address@hidden @kbd{M-x search-backward}
address@hidden @kbd{?}, vi-like operation
 @kindex ?, vi-like operation
 @findex search-backward
 Read a string in the echo area and search backward through the Info file
@@ -1152,13 +1153,19 @@
 case.  With a numeric argument of @var{N}, search for @var{N}th
 occurrence of the string.  Negative arguments search forward.
 
+If you do not have a convenient key sequence bound to this command, an
+alternative is to first perform a forward search, and then use the
address@hidden command, described below.
+
 @item @kbd{R} (@code{toggle-regexp})
 @kindex R
 @findex toggle-regexp
 Toggle between using regular expressions and literal strings for
-searching.  Info uses so-called `extended' regular expression syntax,
-similar to Emacs (@pxref{Regexps, , Using Regular Expressions, emacs,
-The GNU Emacs Manual}).
+searching.  Info uses so-called `extended' regular expression syntax.
address@hidden We should reference a Texinfo manual where extended regular 
expressions
address@hidden are described.  Extended regular expressions are different to 
those
address@hidden of Emacs (e.g., "(" and ")" are equivalent to "\(" and "\)" in 
Emacs).
address@hidden The best reference may be "man 7 regex" from the Linux manpages.
 
 @item @kbd{S} (@code{search-case-sensitively}
 @kindex S
@@ -1227,11 +1234,9 @@
 @cindex index, searching
 @cindex searching, in the indices
 Look up a string in the indices for this Info file, and select a node
-to which the found index entry points.
+to which the found index entry points.  If you press @key{RET} without
+giving a string, Info takes you to an index node in the file.
 
-The search string should not be shorter than a predefined limit, set
-to 1 character by default (@pxref{min-search-length}).
-
 @item @kbd{I} (@code{virtual-index})
 @kindex I
 @findex virtual-index
@@ -1258,10 +1263,15 @@
 it is selected, and the cursor is left positioned at the start of the
 found string.  Subsequent @samp{s} commands show you the default search
 string within @samp{[} and @samp{]}; pressing @key{RET} instead of
-typing a new string will use the default search string.  Under
address@hidden (@pxref{--vi-keys}), using the @samp{n} or @samp{N}
-commands is a faster way of searching for the same string.
+typing a new string will use the default search string.
 
+Using the @address@hidden or @address@hidden commands (or the @samp{n} or 
@samp{N}
+commands under @samp{--vi-keys}; @pxref{--vi-keys}), is a faster way of
+searching for the same string.
+
+If the @code{highlight-searches} variable is set, matches from search
+commands will be highlighted.  @xref{Variables,, @code{highlight-searches}}.
+
 @dfn{Incremental searching} is similar to basic searching, but the
 string is looked up while you are typing it, instead of waiting until
 the entire search string has been specified.
@@ -2142,6 +2152,11 @@
 tells Info it is okay to garbage collect the text of the nodes of a
 file which was compressed on disk.
 
address@hidden highlight-searches
address@hidden highlight-searches
+When set to @code{On}, highlight matches from searching commands
+(@pxref{Searching Commands}).
+
 @item infopath-no-defaults
 @vindex infopath-no-defaults
 @anchor{infopath-no-defaults}