XPAND(5)

NAME
xpand - expand calls in troff and nroff files

SYNOPSIS
xpand [ files []]

DESCRIPTION
The xpand utility searches files for requests and inserts the named file at that point. The output of xpand is a composite of files where each call is replaced by the contents of the called file.

The xpand utility is especially useful when preprocessor input (for tbl, eqn, pic, or grap) is contained in a external file. Since is a troff request, the preprocessors will not see the contents of the external source files, so xpand can be used to retrieve them before the preprocessors do their work.

EXAMPLE
Given the file as the entire document file in which each section is inserted with a request, then
    /tmp/pkgbuild/textproc/DWB/work.vax/.destdir/usr/pkg/DWB/bin/xpand doc | tbl | eqn | troff -mm
eliminates all calls in and creates a complete document input stream, which is then processed by tbl, eqn, and troff with the MM macro package.

WARNINGS
xpand does not recognize requests to switch source files.

xpand does not interpret number register or string calls as part of the filename. Any or sequences in the filename argument is assumed to be part of the name; most likely, such a file will not be found.

FILES

SEE ALSO
eqn(1), grap(1), nroff(1), pic(1), tbl(1) troff(1),