TEXI2MDOC(1)

NAME
texi2mdoc - convert texinfo documents to mdoc

SYNOPSIS
texi2mdoc [-I dirs] [file]

DESCRIPTION
The texi2mdoc utility converts documents to mdoc(7) mixed with tbl(7) (if applicable). By default, texi2mdoc reads from standard input. Its arguments are as follows:

-I dirs
    Colon-separated directories to search for @include files.

file
    A Texinfo input file. If specified, the directory of file is prepended to the list of -I directories.

texi2mdoc can understand a significant subset of the texinfo language. It recognises itself as a plaintext formatter. The produced document's title is set to the file filename and the description is set to the @settitle command's contents.

EXIT STATUS

SEE ALSO
mdoc(7), tbl(7) GNU Texinfo, http://www.gnu.org/software/texinfo/manual/texinfo.

AUTHORS
The texi2mdoc utility was written by Kristaps Dzonsons <kristaps@bsd.lv>.

CAVEATS
The output consists of superfluous ‘Pp’ that cause
    % mandoc -Tlint
to complain.

Many commands that might contain useful information (such as @footnote) are thrown away.

The comma in Texinfo macro arguments may at times be escaped with a backslash. This is not supported.

SECURITY CONSIDERATIONS
As a security precaution, texi2mdoc does not allow the inclusion (via @include or @verbatiminclude) of absolute paths or paths with.. as directory components.