/usr/share/doc/fweb/html-info/Document-class.html is in fweb-doc 1.62-13.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Created by GNU Texinfo 6.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>FWEB: Document class</title>
<meta name="description" content="FWEB: Document class">
<meta name="keywords" content="FWEB: Document class">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Concept-index.html#Concept-index" rel="index" title="Concept index">
<link href="Parameter-index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="LaTeX.html#LaTeX" rel="up" title="LaTeX">
<link href="REVTeX.html#REVTeX" rel="next" title="REVTeX">
<link href="LaTeX.html#LaTeX" rel="prev" title="LaTeX">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smalllisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>
</head>
<body lang="en">
<a name="Document-class"></a>
<div class="header">
<p>
Next: <a href="REVTeX.html#REVTeX" accesskey="n" rel="next">REVTeX</a>, Previous: <a href="LaTeX.html#LaTeX" accesskey="p" rel="prev">LaTeX</a>, Up: <a href="LaTeX.html#LaTeX" accesskey="u" rel="up">LaTeX</a> [<a href="Parameter-index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-index.html#Concept-index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="LaTeX_0027s-document-class"></a>
<h4 class="subsubsection">10.1.3.1 LaTeX’s document class</h4>
<a name="index-_005cdocumentclass"></a>
<p>An <small>FWEB</small>/LaTeX document is set up with the ‘<samp>\Wbegin</samp>’
command, issued automatically by <small>FWEAVE</small>. See the summary at the
end of this section for the essence of what the ‘<samp>\Wbegin</samp>’ command
accomplishes.
</p>
<p><small>FWEAVE</small> uses <code>\documentclass{article}</code> by default. In
principle, the document class can be changed by the <small>FWEB</small> style-file
option ‘<samp>LaTeX.class</samp>’; see <a href="Fwebmac-params.html#Fwebmac-params">Fwebmac params</a>. However,
<em><small>FWEAVE</small> has not been tested with most other document classes</em>.
It will probably not work with most document classes that redefine the
sectioning commands from those of <code>\documentclass{article}</code>.
However, it <em>may</em> work with the <code>revtex</code> scientific macro
package. See <a href="REVTeX.html#REVTeX">REVTeX</a>.
</p>
<p>To incorporate class options—i.e., to obtain the effect of
‘<samp>\documentclass[myoptions]{article}</samp>’—use the style-file parameter
<code>LaTeX.class.options</code>, as in
<a name="index-Class-options"></a>
<a name="index-Options_002c-class"></a>
</p>
<div class="example">
<pre class="example">LaTeX.class.options "myoptions"
</pre></div>
<p>To get two-sided printing, for example, one would say
<a name="index-Printing_002c-two_002dsided"></a>
</p>
<div class="example">
<pre class="example">LaTeX.class.options "twoside"
</pre></div>
<a name="index-_005cusepackage"></a>
<a name="index-User-packages"></a>
<a name="index-Packages_002c-user"></a>
<p>To specify user packages—i.e., to obtain the effect of
‘<samp>\usepackage[pkgoptions]{pkgname}</samp>’—use the style-file parameters
<code>LaTeX.package</code> and <code>LaTeX.package.options</code>, as in
</p>
<div class="example">
<pre class="example">LaTeX.package "pkgname"
LaTeX.package.options "pkgoptions"
</pre></div>
<p>For example, to indent the first line of every section and to permit the
use of the <code>multicol</code> package (the latter is a useful way of
substantially cutting down on white space), say
</p>
<div class="example">
<pre class="example">LaTeX.package "indentfirst,multicol"
</pre></div>
<p>Note that specifying <code>LaTeX.package</code> and
<code>LaTeX.package.options</code> results in the execution (by the
<code>\Wbegin</code> macro) of precisely <em>one</em> line of the form
</p>
<div class="example">
<pre class="example">\usepackage[myoptions]{mypackages}
</pre></div>
<p>Sometimes one instead needs to have multiple <code>\usepackage</code> lines,
such as
</p>
<div class="example">
<pre class="example">\usepackage[option1]{package1}
\usepackage[option2]{package2}
</pre></div>
<p>To get this effect, one can put these commands explicitly into the
style-file parameter <code>doc.preamble</code> (see discussion two paragraphs
below), as in
</p>
<div class="example">
<pre class="example">doc.preamble = "\\usepackage[option1]{package1}\
\\usepackage[option2]{package2}"
</pre></div>
<p>TeX commands in the user’s limbo section of the <code>web</code> source
file will be processed <em>after</em> the <code>\begin{document}</code>
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 ‘<samp>limbo.begin</samp>’ and ‘<samp>limbo.end</samp>’; see <a href="S_005flimbo.html#S_005flimbo">S_limbo</a>.
</p>
<p>If there is a compelling reason to insert one’s own LaTeX
commands between the ‘<samp>\usepackage</samp>’ and ‘<samp>\begin{document}</samp>’
commands, one may use the style-file parameter ‘<samp>doc.preamble</samp>’,
whose value is a string consisting of LaTeX commands (empty by
default). Those commands are processed immediately before
‘<samp>\begin{document}</samp>’. One use of ‘<samp>doc.preamble</samp>’ is to inhibit
<small>FWEB</small>’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
</p>
<div class="example">
<pre class="example">doc.preamble "\\secpenalty=0"
</pre></div>
<p>In summary, the beginning of the file output by <small>FWEAVE</small> looks like
the following, where ‘<samp><parameter></samp>’ means the contents of the
style-file string called ‘<samp>parameter</samp>’:
</p>
<div class="example">
<pre class="example">\input fwebmac.sty
\Wbegin{many obscure arguments}
<limbo.begin>
Optional TeX commands copied from user's limbo section
<limbo.end>
</pre></div>
<p><a name="index-_005cWbegin"></a>
The ‘<samp>\Wbegin</samp>’ command essentially does the following:
</p>
<div class="example">
<pre class="example">\documentclass[<LaTeX.class.options>]{<LaTeX.class>}
\usepackage[<LaTeX.package.options>]{<LaTeX.package>}
<doc.preamble>
\begin{document}
</pre></div>
<p>For precise information about how ‘<samp>\Wbegin</samp>’ works, see
<code>fwebmac.web</code>. If you feel that macro absolutely needs to be
changed, please inform the developer (see <a href="Support.html#Support">Support</a>).
</p>
<hr>
<div class="header">
<p>
Next: <a href="REVTeX.html#REVTeX" accesskey="n" rel="next">REVTeX</a>, Previous: <a href="LaTeX.html#LaTeX" accesskey="p" rel="prev">LaTeX</a>, Up: <a href="LaTeX.html#LaTeX" accesskey="u" rel="up">LaTeX</a> [<a href="Parameter-index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-index.html#Concept-index" title="Index" rel="index">Index</a>]</p>
</div>
</body>
</html>
|