JezK
Edit File: texi2any-Printed-Output.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 Printed Output (GNU Texinfo 6.8)</title> <meta name="description" content="texi2any Printed Output (GNU Texinfo 6.8)"> <meta name="keywords" content="texi2any Printed Output (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="Customization-Variables.html" rel="next" title="Customization Variables"> <link href="texi2any-Environment-Variables.html" rel="prev" title="texi2any Environment Variables"> <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-Printed-Output"> <div class="header"> <p> Next: <a href="Customization-Variables.html" accesskey="n" rel="next">Customization Variables</a>, Previous: <a href="texi2any-Environment-Variables.html" accesskey="p" rel="prev">Environment Variables Recognized by <code>texi2any</code></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="texi2any-Printed-Output-1"></span><h3 class="section">19.3 <code>texi2any</code> Printed Output</h3> <span id="index-Printed-output_002c-through-texi2any"></span> <span id="index-Output_002c-printed-through-texi2any"></span> <p>To justify the name Texinfo-to-<em>any</em>, <code>texi2any</code> 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 <code>texi2dvi</code> program when those output formats are requested, after checking the validity of the input to give users the benefit of <code>texi2any</code>’s error checking. If you don’t want such error checking, perhaps because your manual plays advanced TeX tricks together with <samp>texinfo.tex</samp>, just invoke <code>texi2dvi</code> directly. </p> <p>The output format options for this are <samp>--dvi</samp>, <samp>--dvipdf</samp>, <samp>--pdf</samp>, and <samp>--ps</samp>. See <a href="Format-with-texi2dvi.html">Format with <code>texi2dvi</code></a>, for more details on these options and general <code>texi2dvi</code> operation. In addition, the <samp>--verbose</samp>, <samp>--silent</samp>, and <samp>--quiet</samp> options are passed on if specified; the <samp>-I</samp> and <samp>-o</samp> options are likewise passed on with their arguments, and <samp>--debug</samp> without its argument. </p> <p>The only option remaining that is related to the <code>texi2dvi</code> invocation is <samp>--Xopt</samp>. Here, just the argument is passed on and multiple <samp>--Xopt</samp> options accumulate. This provides a way to construct an arbitrary command line for <code>texi2dvi</code>. For example, running </p> <div class="example"> <pre class="example">texi2any --Xopt -t --Xopt @a4paper --pdf foo.texi </pre></div> <p>is equivalent to running </p> <div class="example"> <pre class="example">texi2dvi -t @a4paper --pdf foo.texi </pre></div> <p>except for the validity check. </p> <p>Although one might wish that other options to <code>texi2any</code> would take effect, they don’t. For example, running ‘<samp>texi2any --no-number-sections --dvi foo.texi</samp>’ still results in a DVI file with numbered sections. (Perhaps this could be improved in the future, if requests are received.) </p> <p>The actual name of the command that is invoked is specified by the <code>TEXI2DVI</code> customization variable (see <a href="Other-Customization-Variables.html">Other Customization Variables</a>). As you might guess, the default is ‘<samp>texi2dvi</samp>’. </p> <p><code>texi2any</code> itself does not generate any normal output when it invokes <code>texi2dvi</code>, only diagnostic messages. </p> </div> <hr> <div class="header"> <p> Next: <a href="Customization-Variables.html">Customization Variables</a>, Previous: <a href="texi2any-Environment-Variables.html">Environment Variables Recognized by <code>texi2any</code></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>