[5437] NEWS: plain text splitting, --init-file, infopath-no-defaults; corresponding doc tweaks

[karl]

Revision: 5437
          http://svn.sv.gnu.org/viewvc/?view=rev&root=texinfo&revision=5437
Author:   karl
Date:     2014-04-08 23:40:40 +0000 (Tue, 08 Apr 2014)
Log Message:
-----------
NEWS: plain text splitting, --init-file, infopath-no-defaults; corresponding 
doc tweaks

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

Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog     2014-04-07 22:40:07 UTC (rev 5436)
+++ trunk/ChangeLog     2014-04-08 23:40:40 UTC (rev 5437)
@@ -1,3 +1,12 @@
+2014-04-08  Karl Berry  <address@hidden>
+
+       * NEWS,
+       * doc/texinfo.texi: mention --plaintext splitting.
+       
+       * doc/info-stnd.texi: tweak infopath-no-defaults and --init-file
+       wording.
+       * NEWS: mention these new features.
+
 2014-04-08  Patrice Dumas  <address@hidden>
 
        * tp/Texinfo/Convert/Converter.pm (_id_to_filename, 
@@ -24,7 +33,7 @@
 
 2014-04-07  Gavin Smith  <address@hidden>
 
-       * doc/info-stnd.text: Document --init-file.
+       * doc/info-stnd.texi: Document --init-file.
 
 2014-04-07  Gavin Smith  <address@hidden>
 

Modified: trunk/NEWS
===================================================================
--- trunk/NEWS  2014-04-07 22:40:07 UTC (rev 5436)
+++ trunk/NEWS  2014-04-08 23:40:40 UTC (rev 5437)
@@ -33,8 +33,14 @@
   . new customization variable INDEX_SPECIAL_CHARS_WARNING to complain
     when index entries contain a colon.
   . Docbook output no longer uses <lineannotation> for @r.
-  . -D'var val' works again.
+  . -D'var val' on the command line works as intended again.
+  . --plaintext output can be split.
 
+* info:
+  . new option --init-file allows overriding ~/.info.
+  . new variable infopath-no-defaults allows omitting the compile-time
+    Info directory from the Info search path.
+
 * install-info:
   . handle compressed input file names containing spaces.
 

Modified: trunk/doc/info-stnd.texi
===================================================================
--- trunk/doc/info-stnd.texi    2014-04-07 22:40:07 UTC (rev 5436)
+++ trunk/doc/info-stnd.texi    2014-04-08 23:40:40 UTC (rev 5437)
@@ -18,8 +18,8 @@
 (usually created from Texinfo source files).
 
 Copyright @copyright{} 1992, 1993, 1996, 1997, 1998, 1999, 2001, 2002,
-2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013 Free Software
-Foundation, Inc.
+2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014
+Free Software Foundation, Inc.
 
 @quotation
 Permission is granted to copy, distribute and/or modify this document
@@ -232,10 +232,11 @@
 If you do not define @code{INFOPATH}, Info uses a default path defined
 when Info was built as the initial list of directories.  
 
-Regardless of whether @code{INFOPATH} is defined, the default documentation
-directory defined when Info was built is added to the search path.  If you do
-not want this directory to be included, set the @code{infopath-no-defaults}
-variable to @code{On}.  (@xref{infopath-no-defaults}.)
+Regardless of whether @code{INFOPATH} is defined, the default
+documentation directory defined when Info was built is added to the
+search path.  If you do not want this directory to be included, set
+the @code{infopath-no-defaults} variable to @code{On}
+(@pxref{infopath-no-defaults}).
  
 If the list of directories contains the element @code{PATH}, that
 element is replaced by a list of directories derived from the value of
@@ -338,7 +339,7 @@
 @anchor{--init-file}
 @cindex @code{--init-file} command line option
 Read key bindings and variable settings from @var{INIT-FILE} instead
-of the @file{.info} file in your home directory. @xref{Custom Key Bindings}.
+of the @file{.info} file in your home directory.  @xref{Custom Key Bindings}.
 
 @item --node @var{nodename}
 @itemx -n @var{nodename}
@@ -2094,11 +2095,10 @@
 @item infopath-no-defaults
 @vindex infopath-no-defaults
 @anchor{infopath-no-defaults}
-Used in conjunction with the @env{INFOPATH} environment variable.
-(@xref{INFOPATH}.)
-When set to @code{On}, the default documentation directory defined
-when Info was built (usually @file{/usr/share/info}) is not added to the 
-search path for Info files.
+Used in conjunction with the @env{INFOPATH} environment variable
+(@pxref{INFOPATH}).  When set to @code{On}, the default documentation
+directory defined when Info was built (e.g., @file{/usr/share/info})
+is not added to the search path for Info files.
 
 @item ISO-Latin
 @cindex ISO Latin characters
@@ -2122,7 +2122,7 @@
 @vindex scroll-behaviour
 Control what happens when forward scrolling is requested at the end of
 a node, or when backward scrolling is requested at the beginning of a
-node.  The two variable names are synonyms.  The default value for
+node.  The two variable names are synonymous.  The default value for
 this variable is @code{Continuous}.  Possible values:
 
 @table @code
@@ -2225,31 +2225,30 @@
 @cindex @command{infokey}, program for customizing key bindings
 @cindex @file{_info} file (MS-DOS)
 
-GNU Info allows you to override the default key-to-command bindings
-and variable settings described in this
-document.  (The @option{--vi-keys} option rebinds many keys at once;
address@hidden)
+Info allows you to override the default key-to-command bindings and
+variable settings described in this document.  (The @option{--vi-keys}
+option rebinds many keys at once; @pxref{--vi-keys}.)
 
 On startup, GNU Info looks for a configuration file in the invoker's
-HOME directory called @file{.info}.
address@hidden to the limitations of DOS
-filesystems, the MS-DOS version of Info looks for a file @file{_info}
-instead.  If the @env{HOME} variable is not defined, Info additionally
-looks in the current directory.}
-If it is present and appears to have been created with the current
-version of the @code{infokey} command, then Info adopts the key
-bindings and variable settings contained therein.  To use an alternative
-configuration file, use the @option{--init-file} option
-(@pxref{--init-file}).
address@hidden directory called @file{.info}, i.e.,
address@hidden/address@hidden to the limitations of DOS filesystems,
+the MS-DOS version of Info looks for a file @file{_info} instead.  If
+the @env{HOME} variable is not defined, Info additionally looks in the
+current directory.}  If it is present and appears to have been created
+with a compatible version of the @code{infokey} command, then Info
+adopts the key bindings and variable settings contained therein.  To
+use an alternative configuration file, use the @option{--init-file}
+option (@pxref{--init-file}).
 
-The @file{.info} file contains compact, non-textual data for reasons of
-efficiency and because its design was lifted wholesale from the GNU Less
-program, which also does it that way.  It must be created by compiling a
-textual source file using the @code{infokey} command.
+The @file{.info} file contains compact, non-textual data for reasons
+of efficiency---and because its design was lifted wholesale from the
+GNU Less program, which does it that way.  It must be created by
+compiling a textual source file using the @code{infokey} command.
 
 Variables may also be set on the command line with the
address@hidden option; @pxref{variable-assignment}.  Variable
-settings on the command line override settings from the @file{.info} file.
address@hidden option (@pxref{variable-assignment}).  Variable
+settings on the command line override settings from the @file{.info}
+file.
 
 @menu
 * Invoking @t{infokey}::

Modified: trunk/doc/texinfo.texi
===================================================================
--- trunk/doc/texinfo.texi      2014-04-07 22:40:07 UTC (rev 5436)
+++ trunk/doc/texinfo.texi      2014-04-08 23:40:40 UTC (rev 5437)
@@ -17539,6 +17539,10 @@
 The output is split at every node.  This is the default.
 @end table
 
+Plain text output can be split similarly to HTML.  This may be useful
+for extracting sections from a Texinfo document and making them
+available as separate files.
+
 @item address@hidden
 @opindex address@hidden
 Keep Info files to at most @var{num} characters if possible; default