version 1.10, 2015/02/24 21:06:52 |
version 1.16, 2018/11/13 08:45:29 |
|
|
.Nd convert texinfo documents to mdoc |
.Nd convert texinfo documents to mdoc |
.Sh SYNOPSIS |
.Sh SYNOPSIS |
.Nm texi2mdoc |
.Nm texi2mdoc |
|
.Op Fl C Ar dir |
|
.Op Fl d Ar date |
.Op Fl I Ar dirs |
.Op Fl I Ar dirs |
.Op Ar file |
.Op Ar file |
.Sh DESCRIPTION |
.Sh DESCRIPTION |
|
|
reads from standard input. |
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 prefix |
|
Instead of producing a single document, break apart the input into |
|
node-level documents placed within |
|
.Ar dir , |
|
which must exist. |
|
These are created as |
|
.Pa prefix-NNN.7 . |
|
.It Fl d Ar date |
|
Set the output document date in the |
|
.Ic \&Dd |
|
macro to |
|
.Ar date , |
|
to be specified in the format |
|
.Dq Ar Month Day , Year . |
|
If unspecified, |
|
.Nm |
|
uses the file modification date |
|
or the current date when reading from standard input. |
.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 |
|
|
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 |
The output of |
The output consists of superfluous |
.Nm |
|
currently doesn't play nicely with |
|
.Xr mdoc 7 : |
|
it doesn't detect whether a line trailing slash is properly escaped nor |
|
does it properly account for how it mingles |
|
.Sq \&Pp |
.Sq \&Pp |
with the text. |
that cause |
|
.D1 % mandoc -Tlint |
|
to complain. |
.Pp |
.Pp |
Many commands that might contain useful information (such as |
Many commands that might contain useful information (such as |
.Li @footnote ) |
.Li @footnote ) |
are thrown away. |
are thrown away. |
.Pp |
.Pp |
Lastly, the comma in Texinfo macro arguments may at times be escaped |
The comma in Texinfo macro arguments may at times be escaped with a backslash. |
with a backslash. |
|
This is |
This is |
.Em not |
.Em not |
supported. |
supported. |
|
|
of absolute paths or paths with |
of absolute paths or paths with |
.Li \&.. |
.Li \&.. |
as directory components. |
as directory components. |
.\" Not used in OpenBSD. |
|