texi2roff1

Usage

Overview

Texi2roff translates the named files from the Texinfo macro language for TeX to the language accepted by troff(1). Files are read and processed in order. If no file is given or if the file is - texi2roff reads the standard input.

Texi2index generates indices for documents translated by texi2roff.

Options

Texi2roff

-me -mm -ms

format the output for use with the troff macro package named.

-i

translate Texinfo index commands into troff index commands. troff will then emit index entries onto the standard error output. You may capture this output and use texi2index(1) and troff to prepare indices from it.

-I

include Texinfo ``Info file'' menu and node contents and @ifinfo text in the output. This material does not appear in a Texinfo document formatted by TeX, but may contain interesting information or be useful when searching a machine-readable document.

-t

(transparent) print text affected by otherwise discarded commands, for people who are afraid of missing something. For best results use -It.

Examples

Translate doc.texinfo using the Bourne shell sh(1). Format with troff and -ms, placing the formatted output in doc, index entries in index, and the formatted index in doc.index.

$ texi2roff -i -ms doc.texinfo | troff -ms > doc 2> index
$ texi2index index | troff -ms >doc.index

As above, but use the C shell csh(1), nroff with -me, and transparent mode:

% (texi2roff -iIt -me doc.texinfo | nroff -me > doc ) >& index
% texi2index index | nroff -me >doc.index

Diagnostics

Errors are reported giving file name and line number.