[5881] document that texi2any --pdf (etc.) parses input before calling texi2dvi

[karl]

Revision: 5881
          http://svn.sv.gnu.org/viewvc/?view=rev&root=texinfo&revision=5881
Author:   karl
Date:     2014-10-21 17:07:12 +0000 (Tue, 21 Oct 2014)
Log Message:
-----------
document that texi2any --pdf (etc.) parses input before calling texi2dvi

Modified Paths:
--------------
    trunk/ChangeLog
    trunk/doc/texinfo.texi
    trunk/tp/texi2any.pl

Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog     2014-10-19 21:36:42 UTC (rev 5880)
+++ trunk/ChangeLog     2014-10-21 17:07:12 UTC (rev 5881)
@@ -1,3 +1,11 @@
+2014-10-21  Karl Berry  <address@hidden>
+
+       * tp/texi2any.pl (makeinfo_help),
+       * doc/texinfo.texi (@t{texi2any} Printed Output): mention
+       that texi2any parse the input purely for error-checking purposes
+       before handing off to texi2dvi.
+       Suggestion from Ken Brown18 Oct 2014 13:58:38.
+
 2014-10-19  Patrice Dumas  <address@hidden>
 
        * tp/Texinfo/Parser.pm (_parse_def): on @def* lines, consider 

Modified: trunk/doc/texinfo.texi
===================================================================
--- trunk/doc/texinfo.texi      2014-10-19 21:36:42 UTC (rev 5880)
+++ trunk/doc/texinfo.texi      2014-10-21 17:07:12 UTC (rev 5881)
@@ -17620,8 +17620,12 @@
 To justify the name address@hidden, @command{texi2any} has
 basic support for creating printed output in the various formats:
 @TeX{} DVI, PDF, and PostScript.  This is done via the simple method
-of executing the @command{texi2dvi} program when those outputs are
-requested.
+of executing the @command{texi2dvi} program when those output formats
+are requested, after checking the validity of the input to give users
+the benefit of @command{texi2any}'s error checking.  If you don't want
+such error checking, perhaps because your manual plays advanced @TeX{}
+tricks together with @file{texinfo.tex}, just invoke
address@hidden directly.
 
 The output format options for this are @option{--dvi},
 @option{--dvipdf}, @option{--pdf}, and @option{--ps}.  @xref{Format
@@ -17647,6 +17651,8 @@
 texi2dvi -t @@a4paper --pdf foo.texi
 @end example
 
address@hidden except for the validity check.
+
 Although one might wish that other options to @command{texi2any} would
 take effect, they don't.  For example, running @samp{texi2any
 --no-number-sections --dvi foo.texi} still results in a DVI file with
@@ -17657,8 +17663,8 @@
 @code{TEXI2DVI} customization variable (@pxref{Other Customization
 Variables}).  As you might guess, the default is @samp{texi2dvi}.
 
address@hidden itself does not generate any output when it invokes
address@hidden
address@hidden itself does not generate any normal output when it
+invokes @command{texi2dvi}, only diagnostic messages.
 
 
 @node Pointer Validation

Modified: trunk/tp/texi2any.pl
===================================================================
--- trunk/tp/texi2any.pl        2014-10-19 21:36:42 UTC (rev 5880)
+++ trunk/tp/texi2any.pl        2014-10-21 17:07:12 UTC (rev 5881)
@@ -747,7 +747,7 @@
       --conf-dir=DIR          search also for initialization files in DIR.
       --init-file=FILE        load FILE to modify the default behavior.
   -c, --set-customization-variable VAR=VAL  set customization variable VAR 
-                                to VAL.
+                                to value VAL.
   -v, --verbose               explain what is being done.
       --version               display version information and exit.\n"), 
get_conf('ERROR_LIMIT'))
 ."\n";
@@ -756,7 +756,8 @@
       --html                  output HTML rather than Info.
       --plaintext             output plain text rather than Info.
       --xml                   output Texinfo XML rather than Info.
-      --dvi, --dvipdf, --ps, --pdf  call texi2dvi to generate given output.\n")
+      --dvi, --dvipdf, --ps, --pdf  call texi2dvi to generate given output,
+                                after checking validity of TEXINFO-FILE.\n")
 
 ."\n";
   $makeinfo_help .= __("General output options:
@@ -766,7 +767,7 @@
                                 from Info output (thus producing plain text)
                                 or from HTML (thus producing shorter output).
                                 Also, if producing Info, write to
-                                standard output by default 
+                                standard output by default.
       --no-split              suppress any splitting of the output;
                                 generate only one output file.
       --[no-]number-sections  output chapter and sectioning numbers;
@@ -1067,6 +1068,14 @@
   document_warn(__('--Xopt option without printed output')); 
 }
 
+if ($call_texi2dvi) {
+  if (get_conf('DEBUG') or get_conf('VERBOSE')) {
+    print STDERR "EXEC ".join('|', (get_conf('TEXI2DVI'), @texi2dvi_args, 
@ARGV)) 
+       ."\n";
+  }
+  exec { get_conf('TEXI2DVI') } (get_conf('TEXI2DVI'), @texi2dvi_args, @ARGV);
+}
+
 my %tree_transformations;
 if (get_conf('TREE_TRANSFORMATIONS')) {
   my @transformations = split /,/, get_conf('TREE_TRANSFORMATIONS');
@@ -1416,12 +1425,4 @@
   }
 }
 
-if ($call_texi2dvi) {
-  if (get_conf('DEBUG') or get_conf('VERBOSE')) {
-    print STDERR "EXEC ".join('|', (get_conf('TEXI2DVI'), @texi2dvi_args, 
@ARGV)) 
-       ."\n";
-  }
-  exec { get_conf('TEXI2DVI') } (get_conf('TEXI2DVI'), @texi2dvi_args, @ARGV);
-}
-
 1;