[5876] document info "(file)node" invocation

[Gavin D. Smith]

Revision: 5876
          http://svn.sv.gnu.org/viewvc/?view=rev&root=texinfo&revision=5876
Author:   gavin
Date:     2014-10-15 15:49:49 +0000 (Wed, 15 Oct 2014)
Log Message:
-----------
document info "(file)node" invocation

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

Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog     2014-10-15 15:26:58 UTC (rev 5875)
+++ trunk/ChangeLog     2014-10-15 15:49:49 UTC (rev 5876)
@@ -1,6 +1,20 @@
+2014-10-15  Gavin Smith  <address@hidden>
+
+       * info/info.c (add_initial_nodes): FILE_BUFFER argument removed.
+       <--usage>: Display an error meesage if there is no node to give 
+       a file to look for an invocation node.
+       (initial_fb): Variable removed.
+
+       * info/info.c (info_short_help),
+       * doc/info-stnd.texi (Invoking Info): Document "info 
+       '(file)node'" invocation.
+       * doc/info-stnd.texi (Invoking Info): Refer to "search path" 
+       instead of "INFOPATH".
+       (Node Commands): Add "vi-like operation" for a binding.
+
 2014-10-14  Gavin Smith  <address@hidden>
 
-       * info.c (get_initial_file) <file name lookup>,
+       * info/info.c (get_initial_file) <file name lookup>,
        (main) <--file>, <'(file)node' as first argument>: Add a node to 
        ref_list from the file we found.
        (add_initial_nodes): Don't fall back to a "Top" node as it 

Modified: trunk/doc/info-stnd.texi
===================================================================
--- trunk/doc/info-stnd.texi    2014-10-15 15:26:58 UTC (rev 5875)
+++ trunk/doc/info-stnd.texi    2014-10-15 15:49:49 UTC (rev 5876)
@@ -188,12 +188,14 @@
 by @code{gunzip}.}
 
 You can specify the name of a node to visit with the @code{--node} or 
address@hidden option.  For example, here are two equivalent ways to load the
address@hidden node within the @samp{emacs} manual:
address@hidden option.  Alternatively, you can specify the file and node 
+together using the same format that occurs in Info cross-references.  
+These two examples both load the @samp{Files} node within the 
address@hidden manual:
 
 @example
 info emacs -n Files
-info -n '(emacs)Files'
+info '(emacs)Files'
 @end example
 
 @cindex absolute Info file names
@@ -214,7 +216,7 @@
 
 @noindent
 Info looks for @var{manual} only in the explicitly specified
-directory, and adds that directory to the value of @code{INFOPATH}.
+directory, and adds that directory to its search path.
 
 @anchor{command-line menu items}
 @cindex menu, following
@@ -1037,7 +1039,7 @@
 
 @anchor{goto-invocation}
 @item @kbd{O} (@code{goto-invocation})
address@hidden @kbd{I}
address@hidden @kbd{I}, vi-like operation
 @kindex O
 @kindex I, vi-like operation
 @findex goto-invocation

Modified: trunk/info/info.c
===================================================================
--- trunk/info/info.c   2014-10-15 15:26:58 UTC (rev 5875)
+++ trunk/info/info.c   2014-10-15 15:49:49 UTC (rev 5876)
@@ -976,7 +976,7 @@
   info emacs                 start at emacs node from top-level dir\n\
   info emacs buffers         select buffers menu entry in emacs manual\n\
   info emacs -n Files        start at Files node within emacs manual\n\
-  info -n '(emacs)Files'     alternative way to start at Files node\n\
+  info '(emacs)Files'        alternative way to start at Files node\n\
   info --show-options emacs  start at node with emacs' command line options\n\
   info --subnodes -o out.txt emacs  dump entire manual to out.txt\n\
   info -f ./foo.info         show file ./foo.info, not searching dir"));