texexpand (1) Linux Manual Page

NAME

texexpand – expand \input and \include statements in a TeX file

DESCRIPTION

General translation mechanism:

The main program latex2html calls texexpand with the document name in order to expand some of its \input and \include statements, here also called `merging’, and to write a list of sensitized style, class, input, or include file names. When texexpand has finished, all is contained in one file, TMP_foo. (assumed foo.tex is the name of the document to translate).

In this version, texexpand cares for following environments that may span include files / section boundaries: a) egin{comment} b) %begin{comment} c) egin{any} introduced with xcludecomment d) %begin{any} e) egin{verbatim} f) egin{latexonly} g) %begin{latexonly}

e) – g) prevent texexpand from expanding input files, but the environment content goes fully into the output file.

Together with each merging of \input etc. there are so-called %%%texexpand markers accompanying the boundary.

When latex2html reads in the output file, it uses these markers to write each part to a separate file, and process them further.

Detailed technical notes:

1. %begin{latexonly} and %end{latexonly} have to be on a separate line. Anything between these tags (including the tags) is discarded.

2. egin{latexonly} and nd{latexonly} have to be on a separate line. Anything between these tags (including the tags) is not expanded.

3. [%\]begin{"to exclude"} and [%\]end{"to exclude"} have to be on a separate line. Anything between these tags (including the tags) is discarded.

4. egin{verbatim/verbatim*} and nd{verbatim/verbatim*} have to be on a separate line. Anything between these tags (including the tags) is not expanded.

5. The scope of any such tags may extend over several files. The opening tag for latexonly may occur on a different include level than the closing tag. The opening tag for verbatim/"to exclude” must occur within the same file than the closing tag.

6. Warnings are printed when the document has been parsed and open tags remain.

7. When in a “to exclude"/verbatim environment, texexpand won’t recognize ANY command except the corresponding closing tag. There cannot be any nested constructions. This behaviour is identical to that of LaTeX.

8. egin{latexonly},nd{latexonly} may be nested, whereas %begin{latexonly},%end{latexonly} may not be nested.

9. A “%” tag cannot close a “\” tag, and vice versa.

10. Every \document(class|style),