version 1.5, 2015/02/20 14:43:22 |
version 1.13, 2015/03/01 00:25:08 |
|
|
.Nd convert texinfo documents to mdoc |
.Nd convert texinfo documents to mdoc |
.Sh SYNOPSIS |
.Sh SYNOPSIS |
.Nm texi2mdoc |
.Nm texi2mdoc |
|
.Op Fl I Ar dir |
.Op Fl I Ar dirs |
.Op Fl I Ar dirs |
.Ar file |
.Op Ar file |
.Sh DESCRIPTION |
.Sh DESCRIPTION |
The |
The |
.Nm |
.Nm |
|
|
mixed with |
mixed with |
.Xr tbl 7 |
.Xr tbl 7 |
.Pq if applicable . |
.Pq if applicable . |
|
By default, |
|
.Nm |
|
reads from standard input. |
Its arguments are as follows: |
Its arguments are as follows: |
.Bl -tag -width Ds |
.Bl -tag -width Ds |
|
.It Fl C Ar dir |
|
Instead of producing a single document, break apart the input into |
|
chapter-level documents placed within |
|
.Ar dir , |
|
which must exist. |
|
These are created as |
|
.Pa chapterNNN.7 . |
.It Fl I Ar dirs |
.It Fl I Ar dirs |
Colon-separated directories to search for |
Colon-separated directories to search for |
.Li @include |
.Li @include |
files. |
files. |
|
.It Ar file |
|
A Texinfo input file. |
|
If specified, the directory of |
|
.Ar file |
|
is prepended to the list of |
|
.Fl I |
|
directories. |
.El |
.El |
.Pp |
.Pp |
.Nm |
.Nm |
|
|
utility was written by |
utility was written by |
.An Kristaps Dzonsons Aq Mt kristaps@bsd.lv . |
.An Kristaps Dzonsons Aq Mt kristaps@bsd.lv . |
.Sh CAVEATS |
.Sh CAVEATS |
Amongst others, the |
The output consists of superfluous |
.Li @macro |
.Sq \&Pp |
and macro-related commands, |
that cause |
.Li @defcodeindex , |
.D1 % mandoc -Tlint |
and |
to complain. |
.Li @footnote |
.Pp |
are not supported. |
Many commands that might contain useful information (such as |
|
.Li @footnote ) |
|
are thrown away. |
|
.Pp |
|
The comma in Texinfo macro arguments may at times be escaped with a backslash. |
|
This is |
|
.Em not |
|
supported. |
.\" .Sh BUGS |
.\" .Sh BUGS |
.Sh SECURITY CONSIDERATIONS |
.Sh SECURITY CONSIDERATIONS |
As a security precaution, |
As a security precaution, |
|
|
of absolute paths or paths with |
of absolute paths or paths with |
.Li \&.. |
.Li \&.. |
as directory components. |
as directory components. |
.\" Not used in OpenBSD. |
|