pod2texi - convert Pod to Texinfo


  pod2texi [OPTION]... POD...


Translate Pod file(s) to Texinfo. There are two basic modes of operation. First, by default, each pod is translated to a standalone Texinfo manual.

Second, if --base-level is set higher than 0, each pod is translated to a file suitable for @include, and one more file with all the @includes is generated, intended to be @included in turn within a hand-written top-level file.



Use appendix sectioning commands (@appendix, ...) instead of the default numbered sectioning Texinfo @-commands (@chapter, @section, ...).


Sets the level of the head1 commands. It may be an integer or a Texinfo sectioning command (without the @): 1 corresponds to the @chapter/@unnumbered level, 2 to the @section level, and so on. The default is 0, meaning that head1 commands are still output as chapters, but the output is arranged as a standalone manual.

If the level is not 0, the pod file is rendered as a fragment of a Texinfo manual suitable for @include. In this case, each pod file has an additional sectioning command covering the entire file, one level above the --base-level value. Therefore, to make each pod file a chapter in a large manual, you should use section as the base level.

For an example of making Texinfo out of the Perl documentation itself, see contrib/perldoc-all in the Texinfo source distribution, with output available at


Set debugging level to NUM.


Display help and exit.


Name for the first manual, or the main manual if there is a main manual. Default is to write to standard output.


Use anchors for sections instead of nodes.


Do not fill sectioning gaps with empty @unnumbered files. Ordinarily, it's good to keep the sectioning hierarchy intact.


Insert STR as top boilerplate before includes. The default is a minimal beginning for a Texinfo document, and sets @documentencoding to utf-8 (because the output is written that way).


If there is a main manual with include files (each corresponding to an input pod file), then those include files are put in directory NAME.


Use unnumbered sectioning commands (@unnumbered, ...) instead of the default numbered sectioning Texinfo @-commands (@chapter, @section, ...).


Name of the @top element for the main manual. May contain Texinfo code.


Display version information and exit.


Pod::Simple::Texinfo. perlpod. The Texinfo manual. Texinfo home page:


Copyright 2021 Free Software Foundation, Inc.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.

There is NO WARRANTY, to the extent permitted by law.


Patrice Dumas <>.