[6610] document TEXI2DVI_USE_RECORDER

[Gavin D. Smith]

Revision: 6610
          http://svn.sv.gnu.org/viewvc/?view=rev&root=texinfo&revision=6610
Author:   gavin
Date:     2015-09-10 13:29:16 +0000 (Thu, 10 Sep 2015)
Log Message:
-----------
document TEXI2DVI_USE_RECORDER

Modified Paths:
--------------
    trunk/ChangeLog
    trunk/doc/texinfo.texi

Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog     2015-09-10 13:01:34 UTC (rev 6609)
+++ trunk/ChangeLog     2015-09-10 13:29:16 UTC (rev 6610)
@@ -1,6 +1,8 @@
 2015-09-10  Gavin Smith  <address@hidden>
 
        * util/texi2dvi (usage): Add reference to "info texi2dvi".
+       * doc/texinfo.texi (Format with texi2dvi): Document 
+       TEXI2DVI_USE_RECORDER.
 
 2015-09-10  Gavin Smith  <address@hidden>
 

Modified: trunk/doc/texinfo.texi
===================================================================
--- trunk/doc/texinfo.texi      2015-09-10 13:01:34 UTC (rev 6609)
+++ trunk/doc/texinfo.texi      2015-09-10 13:29:16 UTC (rev 6610)
@@ -15086,7 +15086,36 @@
 same, but we still run @command{pdfetex} to cater to ancient @TeX{}
 installations.)
 
address@hidden filename recorder for @TeX{}
address@hidden @samp{\openout} line in log file
address@hidden attempts to detect auxiliary files output by @TeX{}, 
+either by using the @option{-recorder} option, or by scanning for 
address@hidden in the log file that a run of @TeX{} produces.  You may
+control how @command{texi2dvi} does this with the @env{TEXI2DVI_USE_RECORDER}
+environment variable.  Valid values are:
 
address@hidden @samp
address@hidden yes
+use the @option{-recorder} option, no checks.
+
address@hidden no
+scan for @samp{\openout} in the log file, no checks.
+
address@hidden yesmaybe
+check whether @option{-recorder} option is supported, and if yes
+use it, otherwise check for tracing @samp{\openout} in the log file is 
+supported, and if yes use it, else it is an error.
+
address@hidden nomaybe
+same as @samp{yesmaybe}, except that the @samp{\openout} trace in log 
+file is checked first.
address@hidden table
+
+The default behaviour is that specified by @samp{yesmaybe}.
+This environment variable is provided for troubleshooting purposes, and 
+may change or disappear in the future.
+
+
 @node Format with @command{tex}/@command{texindex}
 @section Format with @command{tex}/@command{texindex}