texi2mdoc/texi2mdoc.1 - diff

Return to texi2mdoc.1 CVS log

Up to [cvsweb.bsd.lv] / texi2mdoc

Diff for /texi2mdoc/texi2mdoc.1 between version 1.8 and 1.15

version 1.8, 2015/02/23 22:50:11

version 1.15, 2015/03/12 04:24:19

Line 22

.Nd convert texinfo documents to mdoc

.Sh SYNOPSIS

.Nm texi2mdoc

.Op Fl C Ar dir

.Op Fl I Ar dirs

.Op Ar file

.Sh DESCRIPTION

Line 39 By default,

Line 40 By default,

reads from standard input.

Its arguments are as follows:

.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 I Ar dirs

Colon-separated directories to search for

.Li @include

Line 94 The

Line 102 The

utility was written by

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

.Sh CAVEATS

The output of

The output consists of superfluous

.Nm

doesn't play entirely 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.

that cause

Moreover, many commands that might contain useful information (such as

.D1 % mandoc -Tlint

to complain.

.Pp

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 SECURITY CONSIDERATIONS

As a security precaution,

Line 116 or

Line 127 or

of absolute paths or paths with

.Li \&..

as directory components.

.\" Not used in OpenBSD.

CVSweb