--- latex2html.1.bak 2007-02-26 21:14:13.000000000 -0500 +++ latex2html.1 2007-02-26 21:44:19.000000000 -0500 @@ -48,8 +48,8 @@ or .I /usr/share/doc/latex2html/html/ .SH CAVEAT -This documetation has been derived from the TeX manual, and may not be -uptodate. Please refer to the online manual for authoritative +This documentation has been derived from the TeX manual, and may not be +up to date. Please refer to the online manual for authoritative documentation. .UN file://localhost/doc/latex2html/html/ .SH Options controlling Titles, File-Names and Sectioning @@ -200,7 +200,7 @@ For each node, create links to child nodes down to this much deeper than the node's sectioning-level. Specifying -link 0 will show no links to child nodes from that page, --link 1 will show only the immediate descendents, etc. +-link 1 will show only the immediate descendants, etc. A value at least as big as that of the -split depth will produce a mini table-of-contents (when not empty) on each page, for the tree structure rooted at that node. @@ -298,7 +298,7 @@ exception is math when the -no_math switch is also used, which should still validate. Currently, versions 2.0, 3.2 and 4.0 are available. (and also 2.1, 2.2, -3.0 and 3.1, for hoistorical reasons). The extensions i18n, tables, +3.0 and 3.1, for historical reasons). The extensions i18n, tables, math correspond roughly to what used to be called versions `2.1', `2.2', `3.1' respectively, in releases of .B LaTeX2HTML @@ -387,7 +387,7 @@ Same as setting: .I $NO_SIMPLE_MATH = 1; Ordinarily simple mathematical expressions are set using the ordinary -text font, but italiced. When part of the expression can not be +text font, but italicized. When part of the expression can not be represented this way, an image is made of the whole formula. This is called ``simple math''. When .I $NO_SIMPLE_MATH @@ -396,9 +396,9 @@ However, if the math extension is loaded, using the -html_version switch described earlier, then specifying -no_math produces a quite different effect. Now it is the special tags and entities which -are cancelled. In their place a sophisticated scheme for parsing +are canceled. In their place a sophisticated scheme for parsing mathematical expressions is used. Images are made of those sub-parts of -a formula which cannot be adequately expressed using (italiced) text +a formula which cannot be adequately expressed using (italicized) text characters and and tags. See the subsection on mathematics for more details. .TP @@ -968,20 +968,27 @@ Read from latex2html.config by install-test, its value is checked to locate the dvips program or script. There could be several reasons to change the value here: -o add a switch -P to load a specific configuration-file; +.RS +.RS +.P +add a switch -P to load a specific configuration-file; e.g. to use a specific set of PostScript fonts, for improved image-generation. -o to prepend a path to a different version of dvips than normally +.P +to prepend a path to a different version of dvips than normally available as the system default (e.g. the printing requirements are different). -o to append debugging switches, in case of poor quality images; +.P +to append debugging switches, in case of poor quality images; one can see which paths are being searched for fonts and other resources. -o to prepend commands for setting path variables that dvips may need +.P +to prepend commands for setting path variables that dvips may need in order to locate fonts or other resources. +.RE +.P If automatic generation of fonts is required, using Metafont, the following configuration variables are important. -.RS .TP .B $PK_GENERATION = 1; This variable must be set, to initiate font-generation; otherwise @@ -1112,15 +1119,19 @@ used when these images are made. If the value of this variable is empty then the accent is simply ignored, using an un-accented font character (not an image) instead. -Within the color.perl package, the following variables are used to identify +.P +Within the color.perl package, the following two variables are used to identify the names of files containing specifications for named colors. Files having these names are provided, in the .I $LATEX2HTMLSTYLES directory, but they could be moved elsewhere, or replaced by alternative files having different names. In such a case the values of these variables should be altered accordingly. - $RGBCOLORFILE = 'rgb.txt'; - $CRAYOLAFILE = 'crayola.txt'; +.P +.B $RGBCOLORFILE = 'rgb.txt'; +.P +.B $CRAYOLAFILE = 'crayola.txt'; +.P The following variables may well be altered from the system defaults, but this is best done using a local .latex2html-init initialisation file, for overall consistency of style within documents located at the same site, or