texi2mdoc/texi2mdoc.1 - diff

Return to texi2mdoc.1 CVS log

Up to [cvsweb.bsd.lv] / texi2mdoc

Diff for /texi2mdoc/texi2mdoc.1 between version 1.2 and 1.16

version 1.2, 2015/02/19 15:40:44

version 1.16, 2018/11/13 08:45:29

Line 22

.Nd convert texinfo documents to mdoc

.Sh SYNOPSIS

.Nm texi2mdoc

.Op Fl C Ar dir

.Op Fl d Ar date

.Op Fl I Ar dirs

.Ar file

.Op Ar file

.Sh DESCRIPTION

The

.Nm

Line 34 documents to

Line 36 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 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

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 69 command's contents.

Line 99 command's contents.

.\" .Sh ERRORS

.\" For sections 2, 3, 4, and 9 errno settings only.

.Sh SEE ALSO

.Xr mdoc 7 ,

.Xr tbl 7

.Rs

.%B GNU Texinfo

.%U http://www.gnu.org/software/texinfo/manual/texinfo

.Re

.Xr mdoc 7 ,

.Xr tbl 7

.\" .Xr foobar 1

.\" .Sh STANDARDS

.\" .Sh HISTORY

Line 83 The

Line 113 The

.Nm

utility was written by

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

.\" .Sh CAVEATS

.Sh CAVEATS

The output consists of superfluous

.Sq \&Pp

that cause

.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

.Sh SECURITY CONSIDERATIONS

.\" Not used in OpenBSD.

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.

CVSweb