JezK
Edit File: texi2any-Environment-Variables.html
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ --> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <!-- This manual is for GNU Texinfo (version 6.8, 8 June 2021), a documentation system that can produce both online information and a printed manual from a single source using semantic markup. Copyright (C) 1988, 1990-1993, 1995-1999, 2001-2021 Free Software Foundation, Inc. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License". --> <title>texi2any Environment Variables (GNU Texinfo 6.8)</title> <meta name="description" content="texi2any Environment Variables (GNU Texinfo 6.8)"> <meta name="keywords" content="texi2any Environment Variables (GNU Texinfo 6.8)"> <meta name="resource-type" content="document"> <meta name="distribution" content="global"> <meta name="Generator" content="texi2any"> <meta name="viewport" content="width=device-width,initial-scale=1"> <link href="index.html" rel="start" title="Top"> <link href="Command-and-Variable-Index.html" rel="index" title="Command and Variable Index"> <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> <link href="Generic-Translator-texi2any.html" rel="up" title="Generic Translator texi2any"> <link href="texi2any-Printed-Output.html" rel="next" title="texi2any Printed Output"> <link href="Invoking-texi2any.html" rel="prev" title="Invoking texi2any"> <style type="text/css"> <!-- a.copiable-anchor {visibility: hidden; text-decoration: none; line-height: 0em} a.summary-letter {text-decoration: none} blockquote.indentedblock {margin-right: 0em} div.display {margin-left: 3.2em} div.example {margin-left: 3.2em} kbd {font-style: oblique} pre.display {font-family: inherit} pre.format {font-family: inherit} pre.menu-comment {font-family: serif} pre.menu-preformatted {font-family: serif} span.nolinebreak {white-space: nowrap} span.roman {font-family: initial; font-weight: normal} span.sansserif {font-family: sans-serif; font-weight: normal} span:hover a.copiable-anchor {visibility: visible} ul.no-bullet {list-style: none} --> </style> </head> <body lang="en"> <div class="section" id="texi2any-Environment-Variables"> <div class="header"> <p> Next: <a href="texi2any-Printed-Output.html" accesskey="n" rel="next"><code>texi2any</code> Printed Output</a>, Previous: <a href="Invoking-texi2any.html" accesskey="p" rel="prev">Invoking <code>texi2any</code>/<code>makeinfo</code> from a Shell</a>, Up: <a href="Generic-Translator-texi2any.html" accesskey="u" rel="up"><code>texi2any</code>: The Generic Translator for Texinfo</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Command-and-Variable-Index.html" title="Index" rel="index">Index</a>]</p> </div> <hr> <span id="Environment-Variables-Recognized-by-texi2any"></span><h3 class="section">19.2 Environment Variables Recognized by <code>texi2any</code></h3> <span id="index-TEXINFO_005fOUTPUT_005fFORMAT"></span> <span id="index-Environment-variable-TEXINFO_005fOUTPUT_005fFORMAT"></span> <p><code>makeinfo</code> also reads the environment variable <code>TEXINFO_OUTPUT_FORMAT</code> to determine the output format, if not overridden by a command line option. The value should be one of: </p> <div class="example"> <pre class="example">docbook dvi dvipdf html info pdf plaintext ps xml </pre></div> <p>If not set or otherwise specified, Info output is the default. </p> <p>The customization variable of the same name is also read; if set, that overrides an environment variable setting, but not a command-line option. See <a href="Customization-Variables-and-Options.html">Customization Variables and Options</a>. </p> <span id="index-TEXINFO_005fXS"></span> <span id="index-Perl-extension-modules-_0028XS_0029"></span> <p>You can control <code>texi2any</code>’s use of Perl extension modules by setting the <code>TEXINFO_XS</code> environment variable. These modules are compiled native code that the interpreted Perl code can use. Ideally, these extension modules should just work, and the only noticeable difference they should make is that <code>texi2any</code> finishes running sooner. However, you can use this environment variable for the purposes of troubleshooting: for example, if you have problems with the output of <code>texi2any</code> varying depending on whether the extension modules are in use. </p> <p>The following values of <code>TEXINFO_XS</code> are recognized by <code>texi2any</code>: </p> <dl compact="compact"> <dt><span>‘<samp>default</samp>’</span></dt> <dd><p>The default behavior. Try to load extension modules, and silently fall back to the interpreted Perl implementations if this fails. </p> </dd> <dt><span>‘<samp>warn</samp>’</span></dt> <dd><p>Try to load extension modules, and if this fails, give a warning message before falling back to the interpreted Perl implementations. </p> </dd> <dt><span>‘<samp>debug</samp>’</span></dt> <dd><p>Try to load extension modules, printing many messages while doing so. </p> </dd> <dt><span>‘<samp>omit</samp>’</span></dt> <dd><p>Do not use extension modules. </p> </dd> </dl> <span id="index-TEXINFO_005fXS_005fPARSER"></span> <p>Set <code>TEXINFO_XS_PARSER</code> to ‘<samp>0</samp>’ to disable the use of the native code implementation of the parser module. This is the part of <code>texi2any</code> that converts Texinfo input into an internal tree format used for further processing into output formats. This may be useful for working around bugs or incompatibilities between the native code implementation and the implementation in pure Perl code. </p> </div> <hr> <div class="header"> <p> Next: <a href="texi2any-Printed-Output.html"><code>texi2any</code> Printed Output</a>, Previous: <a href="Invoking-texi2any.html">Invoking <code>texi2any</code>/<code>makeinfo</code> from a Shell</a>, Up: <a href="Generic-Translator-texi2any.html"><code>texi2any</code>: The Generic Translator for Texinfo</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Command-and-Variable-Index.html" title="Index" rel="index">Index</a>]</p> </div> </body> </html>