POD2TEXI(1)

NAME
pod2texi - convert Pod to Texinfo

SYNOPSIS
  pod2texi [OPTION]... POD-FILE...

DESCRIPTION
Translate Pod to Texinfo. If the "--base-level" is higher than 0, a main manual including all the files is done otherwise all manuals are standalone (the default).

OPTIONS

--base-level=NUM|NAME
    Sets the level of the head1 commands. It may be an integer or a Texinfo sectioning command. If it is a Texinfo sectioning command the corresponding level is used. If the resulting level is 1, this corresponds to @chapter/@unnumbered level. If set to 0, the head1 commands level is still 1, but the output manual is considered to be a standalone manual.

    If the level is not 0, the pod file is rendered as a fragment of a Texinfo manual. In that case, each pod file has an additional sectioning command one level above the head1 commands level added for the whole file. Therefore if you want to have each pod file as a chapter, you should use "section" as the base level.

--debug=NUM
    Set debugging level to NUM.

--help
    Display help and exit.

--output=NAME
    Name for the first manual, or the main manual if there is a main manual. Default is output on standard out.

--no-section-nodes
    Use anchors for sections instead of nodes.

--no-fill-section-gaps
    Do not fill sectioning gaps with empty @unnumbered.

--preamble=STR
    Insert STR as top boilerplate before includes. The default is fairly minimal, and sets @documentencoding to "utf-8". For example, you can set this to the empty string and then write your own top-level boilerplate which uses @include to incorporate the generated one.

--subdir=NAME
    If there is a main manual with include files, each corresponding to an input pod file, then include files are put in the directory NAME.

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

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

--version
    Display version information and exit.

SEE ALSO
Pod::Simple::Texinfo. The Texinfo manual. perlpod.

COPYRIGHT
Copyright (C) 2012 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.

AUTHOR
Patrice Dumas <pertusus@free.fr>.