[6523] document 'follow-strategy'

[Gavin D. Smith]

Revision: 6523
          http://svn.sv.gnu.org/viewvc/?view=rev&root=texinfo&revision=6523
Author:   gavin
Date:     2015-08-13 20:50:42 +0000 (Thu, 13 Aug 2015)
Log Message:
-----------
document 'follow-strategy'

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

Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog     2015-08-13 18:58:56 UTC (rev 6522)
+++ trunk/ChangeLog     2015-08-13 20:50:42 UTC (rev 6523)
@@ -1,5 +1,9 @@
 2015-08-13  Gavin Smith  <address@hidden>
 
+       * NEWS, doc/info-stnd.texi (Variables): Document 'follow-strategy'.
+
+2015-08-13  Gavin Smith  <address@hidden>
+
        * tp/Texinfo/Convert/XSParagraph/XSParagraph.xs,
        * tp/Texinfo/Convert/XSParagraph/xspara.c: Update some comments 
        and remove some commented-out code.

Modified: trunk/NEWS
===================================================================
--- trunk/NEWS  2015-08-13 18:58:56 UTC (rev 6522)
+++ trunk/NEWS  2015-08-13 20:50:42 UTC (rev 6523)
@@ -42,6 +42,9 @@
   . new user variable `xref-rendition' enables underlining and
     highlighting of cross-references (IN PROGRESS)
   . new command M-x tree-search to search all subnodes of a node (IN PROGRESS)
+  . Now tries to find referenced manuals in the same directory as the
+    current file first, before looking in search path.  Customize this
+    with new variable `follow-strategy'.
   . internal changes to reduce memory use and increase speed of
     searches, relative to last release
 

Modified: trunk/doc/info-stnd.texi
===================================================================
--- trunk/doc/info-stnd.texi    2015-08-13 18:58:56 UTC (rev 6522)
+++ trunk/doc/info-stnd.texi    2015-08-13 20:50:42 UTC (rev 6523)
@@ -2166,6 +2166,24 @@
 @vindex errors-ring-bell
 When set to @code{On} (the default), errors cause the bell to ring.
 
address@hidden follow-strategy
address@hidden follow-strategy
+When set to @code{remain} (the default), Info tries to remain within the
+directory containing the currently displayed Info file when following a
+cross-reference to an external manual, before looking for the referenced
+manual in the search path.  The alternative value is @code{path}, which
+means to look through the search path right away.
+
address@hidden is intended to be useful for several Texinfo manuals that
+all reference each other and whose versions should match each other.
+(For example, various manuals relating to a particular version of
+Emacs.)
+
+The alternative behaviour, with @code{path}, may be useful when your
+Info file search path parallels your command shell's search path, and
+you always want to find documentation of the version of the program that
+the shell would execute.
+
 @item gc-compressed-files
 @vindex gc-compressed-files
 When set to @code{On}, Info garbage collects files which had to be