An FWEB/LaTeX document is set up with the ‘\Wbegin’ command, issued automatically by FWEAVE. See the summary at the end of this section for the essence of what the ‘\Wbegin’ command accomplishes.
FWEAVE uses \documentclass{article} by default. In
principle, the document class can be changed by the FWEB style-file
option ‘LaTeX.class’; see Fwebmac params. However,
FWEAVE has not been tested with most other document classes.
It will probably not work with most document classes that redefine the
sectioning commands from those of \documentclass{article}.
However, it may work with the revtex scientific macro
package. See REVTeX.
To incorporate class options—i.e., to obtain the effect of
‘\documentclass[myoptions]{article}’—use the style-file parameter
LaTeX.class.options, as in
LaTeX.class.options "myoptions"
To get two-sided printing, for example, one would say
LaTeX.class.options "twoside"
To specify user packages—i.e., to obtain the effect of
‘\usepackage[pkgoptions]{pkgname}’—use the style-file parameters
LaTeX.package and LaTeX.package.options, as in
LaTeX.package "pkgname" LaTeX.package.options "pkgoptions"
For example, to indent the first line of every section and to permit the
use of the multicol package (the latter is a useful way of
substantially cutting down on white space), say
LaTeX.package "indentfirst,multicol"
Note that specifying LaTeX.package and
LaTeX.package.options results in the execution (by the
\Wbegin macro) of precisely one line of the form
\usepackage[myoptions]{mypackages}
Sometimes one instead needs to have multiple \usepackage lines,
such as
\usepackage[option1]{package1}
\usepackage[option2]{package2}
To get this effect, one can put these commands explicitly into the
style-file parameter doc.preamble (see discussion two paragraphs
below), as in
doc.preamble = "\\usepackage[option1]{package1}\
\\usepackage[option2]{package2}"
TeX commands in the user’s limbo section of the web source
file will be processed after the \begin{document}
command. Limbo commands from the style file can be inserted before
and/or after those in the limbo section with the aid of the style-file
parameters ‘limbo.begin’ and ‘limbo.end’; see S_limbo.
If there is a compelling reason to insert one’s own LaTeX commands between the ‘\usepackage’ and ‘\begin{document}’ commands, one may use the style-file parameter ‘doc.preamble’, whose value is a string consisting of LaTeX commands (empty by default). Those commands are processed immediately before ‘\begin{document}’. One use of ‘doc.preamble’ is to inhibit FWEB’s tendency to keep a section together on one page. To make it break more readily in the middle of sections (particularly useful for multicolumn output), say
doc.preamble "\\secpenalty=0"
In summary, the beginning of the file output by FWEAVE looks like the following, where ‘<parameter>’ means the contents of the style-file string called ‘parameter’:
\input fwebmac.sty
\Wbegin{many obscure arguments}
<limbo.begin>
Optional TeX commands copied from user's limbo section
<limbo.end>
The ‘\Wbegin’ command essentially does the following:
\documentclass[<LaTeX.class.options>]{<LaTeX.class>}
\usepackage[<LaTeX.package.options>]{<LaTeX.package>}
<doc.preamble>
\begin{document}
For precise information about how ‘\Wbegin’ works, see
fwebmac.web. If you feel that macro absolutely needs to be
changed, please inform the developer (see Support).