blob: 7e78429f2fcf4059a7a9fd36dea549f7b6701276 [file]
<!DOCTYPE html>
<html>
<!-- Created by Texinfo 6.8dev+dev, http://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.8dev, 23 February 2022),
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-2022 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>Invoking pod2texi (GNU Texinfo 6.8dev)</title>
<meta name="description" content="Invoking pod2texi (GNU Texinfo 6.8dev)">
<meta name="keywords" content="Invoking pod2texi (GNU Texinfo 6.8dev)">
<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="texi2html.html" rel="next" title="texi2html">
<link href="Internationalization-of-Document-Strings.html" rel="prev" title="Internationalization of Document Strings">
</head>
<body lang="en">
<div class="section-level-extent" id="Invoking-pod2texi">
<div class="nav-panel">
<p>
Next: <a href="texi2html.html" accesskey="n" rel="next"><code class="command">texi2html</code>: Ancestor of <code class="command">texi2any</code></a>, Previous: <a href="Internationalization-of-Document-Strings.html" accesskey="p" rel="prev">Internationalization of Document Strings</a>, Up: <a href="Generic-Translator-texi2any.html" accesskey="u" rel="up"><code class="command">texi2any</code>: The Generic Translator for Texinfo</a> &nbsp; [<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>
<h3 class="section" id="Invoking-pod2texi_003a-Convert-Pod-to-Texinfo">19.6 Invoking <code class="command">pod2texi</code>: Convert Pod to Texinfo</h3>
<a class="index-entry-id" id="index-pod2texi"></a>
<a class="index-entry-id" id="index-Invoking-pod2texi"></a>
<a class="index-entry-id" id="index-Pod_002c-converting-to-Texinfo"></a>
<a class="index-entry-id" id="index-Perl-Pod_002c-converting-to-Texinfo"></a>
<p>The <code class="command">pod2texi</code> program translates Perl Pod documentation file(s)
to Texinfo. There are two basic modes of operation: generating a
standalone manual from each input Pod, or (if <code class="code">--base-level=1</code> or
higher is given) generating Texinfo subfiles suitable for use
with <code class="code">@include</code>.
</p>
<p>The <code class="command">pod2texi</code> program may be useful outside of the rest of Texinfo,
thus the invokation of <code class="command">pod2texi</code> is documented using the man page
format to follow the convention used in Perl standalone programs, with a
version on the web
<a class="url" href="http://www.gnu.org/software/texinfo/manual/pod2texi.html">http://www.gnu.org/software/texinfo/manual/pod2texi.html</a> and a version
included below. The version included in the manual is also an example of
<code class="command">pod2texi</code> use, as it is converted from Pod using <code class="command">pod2texi</code>.
</p>
<ul class="mini-toc">
<li><a href="pod2texi-manual-page.html" accesskey="1">pod2texi</a></li>
</ul>
</div>
</body>
</html>