texi2mdoc/texi2mdoc.1 - diff

Return to texi2mdoc.1 CVS log

Up to [cvsweb.bsd.lv] / texi2mdoc

Diff for /texi2mdoc/texi2mdoc.1 between version 1.3 and 1.10

version 1.3, 2015/02/20 09:58:50

version 1.10, 2015/02/24 21:06:52

Line 23

.Sh SYNOPSIS

.Nm texi2mdoc

.Op Fl I Ar dirs

.Ar file

.Op Ar file

.Sh DESCRIPTION

The

.Nm

Line 34 documents to

mixed with

.Xr tbl 7

.Pq if applicable .

By default,

.Nm

reads from standard input.

Its arguments are as follows:

.Bl -tag -width Ds

.It Fl I Ar dirs

Colon-separated directories to search for

.Li @include

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

.Pp

.Nm

Line 83 The

Line 93 The

.Nm

utility was written by

.An Kristaps Dzonsons Aq Mt kristaps@bsd.lv .

.\" .Sh CAVEATS

.Sh CAVEATS

The output of

.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

with the text.

.Pp

Many commands that might contain useful information (such as

.Li @footnote )

are thrown away.

.Pp

Lastly, the comma in Texinfo macro arguments may at times be escaped

with a backslash.

This is

.Em not

supported.

.\" .Sh BUGS

.\" .Sh SECURITY CONSIDERATIONS

.Sh SECURITY CONSIDERATIONS

As a security precaution,

.Nm

does not allow the inclusion (via

.Li @include

.Li @verbatiminclude )

of absolute paths or paths with

.Li \&..

as directory components.

.\" Not used in OpenBSD.

CVSweb