ia64/xen-unstable

diff docs/html.sty @ 3762:0a4b76b6b5a0

bitkeeper revision 1.1161 (420b5ed6DpcotfvpA5TTxShadFd_MQ)

Merge with non-ancient version of Xen.
author sos22@douglas.cl.cam.ac.uk
date Thu Feb 10 13:17:10 2005 +0000 (2005-02-10)
parents f6afd85efce0
children
line diff
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/docs/html.sty	Thu Feb 10 13:17:10 2005 +0000
     1.3 @@ -0,0 +1,887 @@
     1.4 +%
     1.5 +% $Id: html.sty,v 1.23 1998/02/26 10:32:24 latex2html Exp $
     1.6 +% LaTeX2HTML Version 96.2 : html.sty
     1.7 +% 
     1.8 +% This file contains definitions of LaTeX commands which are
     1.9 +% processed in a special way by the translator. 
    1.10 +% For example, there are commands for embedding external hypertext links,
    1.11 +% for cross-references between documents or for including raw HTML.
    1.12 +% This file includes the comments.sty file v2.0 by Victor Eijkhout
    1.13 +% In most cases these commands do nothing when processed by LaTeX.
    1.14 +%
    1.15 +% Place this file in a directory accessible to LaTeX (i.e., somewhere
    1.16 +% in the TEXINPUTS path.)
    1.17 +%
    1.18 +% NOTE: This file works with LaTeX 2.09 or (the newer) LaTeX2e.
    1.19 +%       If you only have LaTeX 2.09, some complex LaTeX2HTML features
    1.20 +%       like support for segmented documents are not available.
    1.21 +
    1.22 +% Changes:
    1.23 +% See the change log at end of file.
    1.24 +
    1.25 +
    1.26 +% Exit if the style file is already loaded
    1.27 +% (suggested by Lee Shombert <las@potomac.wash.inmet.com>
    1.28 +\ifx \htmlstyloaded\relax \endinput\else\let\htmlstyloaded\relax\fi
    1.29 +\makeatletter
    1.30 +
    1.31 +\providecommand{\latextohtml}{\LaTeX2\texttt{HTML}}
    1.32 +
    1.33 +
    1.34 +%%% LINKS TO EXTERNAL DOCUMENTS
    1.35 +%
    1.36 +% This can be used to provide links to arbitrary documents.
    1.37 +% The first argumment should be the text that is going to be
    1.38 +% highlighted and the second argument a URL.
    1.39 +% The hyperlink will appear as a hyperlink in the HTML 
    1.40 +% document and as a footnote in the dvi or ps files.
    1.41 +%
    1.42 +\newcommand{\htmladdnormallinkfoot}[2]{#1\footnote{#2}} 
    1.43 +
    1.44 +
    1.45 +% This is an alternative definition of the command above which
    1.46 +% will ignore the URL in the dvi or ps files.
    1.47 +\newcommand{\htmladdnormallink}[2]{#1}
    1.48 +
    1.49 +
    1.50 +% This command takes as argument a URL pointing to an image.
    1.51 +% The image will be embedded in the HTML document but will
    1.52 +% be ignored in the dvi and ps files.
    1.53 +%
    1.54 +\newcommand{\htmladdimg}[1]{}
    1.55 +
    1.56 +
    1.57 +%%% CROSS-REFERENCES BETWEEN (LOCAL OR REMOTE) DOCUMENTS
    1.58 +%
    1.59 +% This can be used to refer to symbolic labels in other Latex 
    1.60 +% documents that have already been processed by the translator.
    1.61 +% The arguments should be:
    1.62 +% #1 : the URL to the directory containing the external document
    1.63 +% #2 : the path to the labels.pl file of the external document.
    1.64 +% If the external document lives on a remote machine then labels.pl 
    1.65 +% must be copied on the local machine.
    1.66 +%
    1.67 +%e.g. \externallabels{http://cbl.leeds.ac.uk/nikos/WWW/doc/tex2html/latex2html}
    1.68 +%                    {/usr/cblelca/nikos/tmp/labels.pl}
    1.69 +% The arguments are ignored in the dvi and ps files.
    1.70 +%
    1.71 +\newcommand{\externallabels}[2]{}
    1.72 +
    1.73 +
    1.74 +% This complements the \externallabels command above. The argument
    1.75 +% should be a label defined in another latex document and will be
    1.76 +% ignored in the dvi and ps files.
    1.77 +%
    1.78 +\newcommand{\externalref}[1]{}
    1.79 +
    1.80 +
    1.81 +% Suggested by  Uffe Engberg (http://www.brics.dk/~engberg/)
    1.82 +% This allows the same effect for citations in external bibliographies.
    1.83 +% An  \externallabels  command must be given, locating a labels.pl file
    1.84 +% which defines the location and keys used in the external .html file.
    1.85 +%  
    1.86 +\newcommand{\externalcite}{\nocite}
    1.87 +
    1.88 +
    1.89 +%%% HTMLRULE
    1.90 +% This command adds a horizontal rule and is valid even within
    1.91 +% a figure caption.
    1.92 +% Here we introduce a stub for compatibility.
    1.93 +\newcommand{\htmlrule}{\protect\HTMLrule}
    1.94 +\newcommand{\HTMLrule}{\@ifstar\htmlrulestar\htmlrulestar}
    1.95 +\newcommand{\htmlrulestar}[1]{}
    1.96 +
    1.97 +% This command adds information within the <BODY> ... </BODY> tag
    1.98 +%
    1.99 +\newcommand{\bodytext}[1]{}
   1.100 +\newcommand{\htmlbody}{}
   1.101 +
   1.102 +
   1.103 +%%% HYPERREF 
   1.104 +% Suggested by Eric M. Carol <eric@ca.utoronto.utcc.enfm>
   1.105 +% Similar to \ref but accepts conditional text. 
   1.106 +% The first argument is HTML text which will become ``hyperized''
   1.107 +% (underlined).
   1.108 +% The second and third arguments are text which will appear only in the paper
   1.109 +% version (DVI file), enclosing the fourth argument which is a reference to a label.
   1.110 +%
   1.111 +%e.g. \hyperref{using the tracer}{using the tracer (see Section}{)}{trace}
   1.112 +% where there is a corresponding \label{trace}
   1.113 +%
   1.114 +\newcommand{\hyperref}{\hyperrefx[ref]}
   1.115 +\def\hyperrefx[#1]{{\def\next{#1}%
   1.116 + \def\tmp{ref}\ifx\next\tmp\aftergroup\hyperrefref
   1.117 + \else\def\tmp{pageref}\ifx\next\tmp\aftergroup\hyperpageref
   1.118 + \else\def\tmp{page}\ifx\next\tmp\aftergroup\hyperpageref
   1.119 + \else\def\tmp{noref}\ifx\next\tmp\aftergroup\hypernoref
   1.120 + \else\def\tmp{no}\ifx\next\tmp\aftergroup\hypernoref
   1.121 + \else\typeout{*** unknown option \next\space to  hyperref ***}%
   1.122 + \fi\fi\fi\fi\fi}}
   1.123 +\newcommand{\hyperrefref}[4]{#2\ref{#4}#3}
   1.124 +\newcommand{\hyperpageref}[4]{#2\pageref{#4}#3}
   1.125 +\newcommand{\hypernoref}[3]{#2}
   1.126 +
   1.127 +
   1.128 +%%% HYPERCITE --- added by RRM
   1.129 +% Suggested by Stephen Simpson <simpson@math.psu.edu>
   1.130 +% effects the same ideas as in  \hyperref, but for citations.
   1.131 +% It does not allow an optional argument to the \cite, in LaTeX.
   1.132 +%
   1.133 +%   \hypercite{<html-text>}{<LaTeX-text>}{<opt-text>}{<key>}
   1.134 +%
   1.135 +% uses the pre/post-texts in LaTeX, with a  \cite{<key>}
   1.136 +%
   1.137 +%   \hypercite[ext]{<html-text>}{<LaTeX-text>}{<key>}
   1.138 +%
   1.139 +% uses the pre/post-texts in LaTeX, with a  \nocite{<key>}
   1.140 +% the actual reference comes from an \externallabels  file.
   1.141 +%
   1.142 +\newcommand{\hypercite}{\hypercitex[int]}
   1.143 +\def\hypercitex[#1]{{\def\next{#1}%
   1.144 + \def\tmp{int}\ifx\next\tmp\aftergroup\hyperciteint
   1.145 + \else\def\tmp{cite}\ifx\next\tmp\aftergroup\hyperciteint
   1.146 + \else\def\tmp{ext}\ifx\next\tmp\aftergroup\hyperciteext
   1.147 + \else\def\tmp{nocite}\ifx\next\tmp\aftergroup\hyperciteext
   1.148 + \else\def\tmp{no}\ifx\next\tmp\aftergroup\hyperciteext
   1.149 + \else\typeout{*** unknown option \next\space to  hypercite ***}%
   1.150 + \fi\fi\fi\fi\fi}}
   1.151 +\newcommand{\hyperciteint}[4]{#2{\def\tmp{#3}\def\emptyopt{}%
   1.152 + \ifx\tmp\emptyopt\cite{#4}\else\cite[#3]{#4}\fi}}
   1.153 +\newcommand{\hyperciteext}[3]{#2\nocite{#3}}
   1.154 +
   1.155 +
   1.156 +
   1.157 +%%% HTMLREF
   1.158 +% Reference in HTML version only.
   1.159 +% Mix between \htmladdnormallink and \hyperref.
   1.160 +% First arg is text for in both versions, second is label for use in HTML
   1.161 +% version.
   1.162 +\newcommand{\htmlref}[2]{#1}
   1.163 +
   1.164 +%%% HTMLCITE
   1.165 +% Reference in HTML version only.
   1.166 +% Mix between \htmladdnormallink and \hypercite.
   1.167 +% First arg is text for in both versions, second is citation for use in HTML
   1.168 +% version.
   1.169 +\newcommand{\htmlcite}[2]{#1}
   1.170 +
   1.171 +
   1.172 +%%% HTMLIMAGE
   1.173 +% This command can be used inside any environment that is converted
   1.174 +% into an inlined image (eg a "figure" environment) in order to change
   1.175 +% the way the image will be translated. The argument of \htmlimage
   1.176 +% is really a string of options separated by commas ie 
   1.177 +% [scale=<scale factor>],[external],[thumbnail=<reduction factor>
   1.178 +% The scale option allows control over the size of the final image.
   1.179 +% The ``external'' option will cause the image not to be inlined 
   1.180 +% (images are inlined by default). External images will be accessible
   1.181 +% via a hypertext link. 
   1.182 +% The ``thumbnail'' option will cause a small inlined image to be 
   1.183 +% placed in the caption. The size of the thumbnail depends on the
   1.184 +% reduction factor. The use of the ``thumbnail'' option implies
   1.185 +% the ``external'' option.
   1.186 +%
   1.187 +% Example:
   1.188 +% \htmlimage{scale=1.5,external,thumbnail=0.2}
   1.189 +% will cause a small thumbnail image 1/5th of the original size to be
   1.190 +% placed in the final document, pointing to an external image 1.5
   1.191 +% times bigger than the original.
   1.192 +% 
   1.193 +\newcommand{\htmlimage}[1]{}
   1.194 +
   1.195 +
   1.196 +% \htmlborder causes a border to be placed around an image or table
   1.197 +% when the image is placed within a <TABLE> cell.
   1.198 +\newcommand{\htmlborder}[1]{}
   1.199 +
   1.200 +% Put \begin{makeimage}, \end{makeimage} around LaTeX to ensure its
   1.201 +% translation into an image.
   1.202 +% This shields sensitive text from being translated.
   1.203 +\newenvironment{makeimage}{}{}
   1.204 +
   1.205 +
   1.206 +% A dummy environment that can be useful to alter the order
   1.207 +% in which commands are processed, in LaTeX2HTML
   1.208 +\newenvironment{tex2html_deferred}{}{}
   1.209 +
   1.210 +
   1.211 +%%% HTMLADDTONAVIGATION
   1.212 +% This command appends its argument to the buttons in the navigation
   1.213 +% panel. It is ignored by LaTeX.
   1.214 +%
   1.215 +% Example:
   1.216 +% \htmladdtonavigation{\htmladdnormallink
   1.217 +%              {\htmladdimg{http://server/path/to/gif}}
   1.218 +%              {http://server/path}}
   1.219 +\newcommand{\htmladdtonavigation}[1]{}
   1.220 +
   1.221 +
   1.222 +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
   1.223 +% Comment.sty   version 2.0, 19 June 1992
   1.224 +% selectively in/exclude pieces of text: the user can define new
   1.225 +% comment versions, and each is controlled separately.
   1.226 +% This style can be used with plain TeX or LaTeX, and probably
   1.227 +% most other packages too.
   1.228 +%
   1.229 +% Examples of use in LaTeX and TeX follow \endinput
   1.230 +%
   1.231 +% Author
   1.232 +%    Victor Eijkhout
   1.233 +%    Department of Computer Science
   1.234 +%    University Tennessee at Knoxville
   1.235 +%    104 Ayres Hall
   1.236 +%    Knoxville, TN 37996
   1.237 +%    USA
   1.238 +%
   1.239 +%    eijkhout@cs.utk.edu
   1.240 +%
   1.241 +% Usage: all text included in between
   1.242 +%    \comment ... \endcomment
   1.243 +% or \begin{comment} ... \end{comment}
   1.244 +% is discarded. The closing command should appear on a line
   1.245 +% of its own. No starting spaces, nothing after it.
   1.246 +% This environment should work with arbitrary amounts
   1.247 +% of comment.
   1.248 +%
   1.249 +% Other 'comment' environments are defined by
   1.250 +% and are selected/deselected with
   1.251 +% \includecomment{versiona}
   1.252 +% \excludecoment{versionb}
   1.253 +%
   1.254 +% These environments are used as
   1.255 +% \versiona ... \endversiona
   1.256 +% or \begin{versiona} ... \end{versiona}
   1.257 +% with the closing command again on a line of its own.
   1.258 +%
   1.259 +% Basic approach:
   1.260 +% to comment something out, scoop up  every line in verbatim mode
   1.261 +% as macro argument, then throw it away.
   1.262 +% For inclusions, both the opening and closing comands
   1.263 +% are defined as noop
   1.264 +%
   1.265 +% Changed \next to \html@next to prevent clashes with other sty files
   1.266 +% (mike@emn.fr)
   1.267 +% Changed \html@next to \htmlnext so the \makeatletter and
   1.268 +% \makeatother commands could be removed (they were causing other
   1.269 +% style files - changebar.sty - to crash) (nikos@cbl.leeds.ac.uk)
   1.270 +% Changed \htmlnext back to \html@next...
   1.271 +
   1.272 +\def\makeinnocent#1{\catcode`#1=12 }
   1.273 +\def\csarg#1#2{\expandafter#1\csname#2\endcsname}
   1.274 +
   1.275 +\def\ThrowAwayComment#1{\begingroup
   1.276 +    \def\CurrentComment{#1}%
   1.277 +    \let\do\makeinnocent \dospecials
   1.278 +    \makeinnocent\^^L% and whatever other special cases
   1.279 +    \endlinechar`\^^M \catcode`\^^M=12 \xComment}
   1.280 +{\catcode`\^^M=12 \endlinechar=-1 %
   1.281 + \gdef\xComment#1^^M{\def\test{#1}\edef\test{\meaning\test}
   1.282 +      \csarg\ifx{PlainEnd\CurrentComment Test}\test
   1.283 +          \let\html@next\endgroup
   1.284 +      \else \csarg\ifx{LaLaEnd\CurrentComment Test}\test
   1.285 +            \edef\html@next{\endgroup\noexpand\end{\CurrentComment}}
   1.286 +      \else \csarg\ifx{LaInnEnd\CurrentComment Test}\test
   1.287 +            \edef\html@next{\endgroup\noexpand\end{\CurrentComment}}
   1.288 +      \else \let\html@next\xComment
   1.289 +      \fi \fi \fi \html@next}
   1.290 +}
   1.291 +
   1.292 +\def\includecomment
   1.293 + #1{\expandafter\def\csname#1\endcsname{}%
   1.294 +    \expandafter\def\csname end#1\endcsname{}}
   1.295 +\def\excludecomment
   1.296 + #1{\expandafter\def\csname#1\endcsname{\ThrowAwayComment{#1}}%
   1.297 +    {\escapechar=-1\relax
   1.298 +     \edef\tmp{\string\\end#1}%
   1.299 +      \csarg\xdef{PlainEnd#1Test}{\meaning\tmp}%
   1.300 +     \edef\tmp{\string\\end\string\{#1\string\}}%
   1.301 +      \csarg\xdef{LaLaEnd#1Test}{\meaning\tmp}%
   1.302 +     \edef\tmp{\string\\end \string\{#1\string\}}%
   1.303 +      \csarg\xdef{LaInnEnd#1Test}{\meaning\tmp}%
   1.304 +    }}
   1.305 +
   1.306 +\excludecomment{comment}
   1.307 +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
   1.308 +% end Comment.sty
   1.309 +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
   1.310 +
   1.311 +%
   1.312 +% Alternative code by Robin Fairbairns, 22 September 1997
   1.313 +%
   1.314 +\newcommand\@gobbleenv{\let\reserved@a\@currenvir\@gobble@nv}
   1.315 +\long\def\@gobble@nv#1\end#2{\def\reserved@b{#2}%
   1.316 + \ifx\reserved@a\reserved@b
   1.317 +  \edef\reserved@a{\noexpand\end{\reserved@a}}%
   1.318 +  \expandafter\reserved@a
   1.319 + \else
   1.320 +  \expandafter\@gobble@nv
   1.321 + \fi}
   1.322 +
   1.323 +\renewcommand{\excludecomment}[1]{%
   1.324 +    \csname newenvironment\endcsname{#1}{\@gobbleenv}{}}
   1.325 +
   1.326 +%%% RAW HTML 
   1.327 +% 
   1.328 +% Enclose raw HTML between a \begin{rawhtml} and \end{rawhtml}.
   1.329 +% The html environment ignores its body
   1.330 +%
   1.331 +\excludecomment{rawhtml}
   1.332 +
   1.333 +
   1.334 +%%% HTML ONLY
   1.335 +%
   1.336 +% Enclose LaTeX constructs which will only appear in the 
   1.337 +% HTML output and will be ignored by LaTeX with 
   1.338 +% \begin{htmlonly} and \end{htmlonly}
   1.339 +%
   1.340 +\excludecomment{htmlonly}
   1.341 +% Shorter version
   1.342 +\newcommand{\html}[1]{}
   1.343 +
   1.344 +% for images.tex only
   1.345 +\excludecomment{imagesonly}
   1.346 +
   1.347 +%%% LaTeX ONLY
   1.348 +% Enclose LaTeX constructs which will only appear in the 
   1.349 +% DVI output and will be ignored by latex2html with 
   1.350 +%\begin{latexonly} and \end{latexonly}
   1.351 +%
   1.352 +\newenvironment{latexonly}{}{}
   1.353 +% Shorter version
   1.354 +\newcommand{\latex}[1]{#1}
   1.355 +
   1.356 +
   1.357 +%%% LaTeX or HTML
   1.358 +% Combination of \latex and \html.
   1.359 +% Say \latexhtml{this should be latex text}{this html text}
   1.360 +%
   1.361 +%\newcommand{\latexhtml}[2]{#1}
   1.362 +\long\def\latexhtml#1#2{#1}
   1.363 +
   1.364 +
   1.365 +%%% tracing the HTML conversions
   1.366 +% This alters the tracing-level within the processing
   1.367 +% performed by  latex2html  by adjusting  $VERBOSITY
   1.368 +% (see  latex2html.config  for the appropriate values)
   1.369 +%
   1.370 +\newcommand{\htmltracing}[1]{}
   1.371 +\newcommand{\htmltracenv}[1]{}
   1.372 +
   1.373 +
   1.374 +%%%  \strikeout for HTML only
   1.375 +% uses <STRIKE>...</STRIKE> tags on the argument
   1.376 +% LaTeX just gobbles it up.
   1.377 +\newcommand{\strikeout}[1]{}
   1.378 +
   1.379 +
   1.380 +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
   1.381 +%%% JCL - stop input here if LaTeX2e is not present
   1.382 +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
   1.383 +\ifx\if@compatibility\undefined
   1.384 +  %LaTeX209
   1.385 +  \makeatother\relax\expandafter\endinput
   1.386 +\fi
   1.387 +\if@compatibility
   1.388 +  %LaTeX2e in LaTeX209 compatibility mode
   1.389 +  \makeatother\relax\expandafter\endinput
   1.390 +\fi
   1.391 +
   1.392 +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
   1.393 +%
   1.394 +% Start providing LaTeX2e extension:
   1.395 +% This is currently:
   1.396 +%  - additional optional argument for \htmladdimg
   1.397 +%  - support for segmented documents
   1.398 +%
   1.399 +
   1.400 +\ProvidesPackage{html}
   1.401 +          [1996/12/22 v1.1 hypertext commands for latex2html (nd, hws, rrm)]
   1.402 +%%%%MG
   1.403 +
   1.404 +% This command takes as argument a URL pointing to an image.
   1.405 +% The image will be embedded in the HTML document but will
   1.406 +% be ignored in the dvi and ps files.  The optional argument
   1.407 +% denotes additional HTML tags.
   1.408 +%
   1.409 +% Example:  \htmladdimg[ALT="portrait" ALIGN=CENTER]{portrait.gif}
   1.410 +%
   1.411 +\renewcommand{\htmladdimg}[2][]{}
   1.412 +
   1.413 +%%% HTMLRULE for LaTeX2e
   1.414 +% This command adds a horizontal rule and is valid even within
   1.415 +% a figure caption.
   1.416 +%
   1.417 +% This command is best used with LaTeX2e and HTML 3.2 support.
   1.418 +% It is like \hrule, but allows for options via key--value pairs
   1.419 +% as follows:  \htmlrule[key1=value1, key2=value2, ...] .
   1.420 +% Use \htmlrule* to suppress the <BR> tag.
   1.421 +% Eg. \htmlrule[left, 15, 5pt, "none", NOSHADE] produces
   1.422 +% <BR CLEAR="left"><HR NOSHADE SIZE="15">.
   1.423 +% Renew the necessary part.
   1.424 +\renewcommand{\htmlrulestar}[1][all]{}
   1.425 +
   1.426 +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
   1.427 +%
   1.428 +%  renew some definitions to allow optional arguments
   1.429 +%
   1.430 +% The description of the options is missing, as yet.
   1.431 +%
   1.432 +\renewcommand{\latextohtml}{\textup{\LaTeX2\texttt{HTML}}}
   1.433 +\renewcommand{\htmladdnormallinkfoot}[3][]{#2\footnote{#3}} 
   1.434 +\renewcommand{\htmladdnormallink}[3][]{#2}
   1.435 +\renewcommand{\htmlbody}[1][]{}
   1.436 +\renewcommand{\hyperref}[1][ref]{\hyperrefx[#1]}
   1.437 +\renewcommand{\hypercite}[1][int]{\hypercitex[#1]}
   1.438 +\renewcommand{\htmlref}[3][]{#2}
   1.439 +\renewcommand{\htmlcite}[1]{#1\htmlcitex}
   1.440 +\newcommand{\htmlcitex}[2][]{{\def\tmp{#1}\ifx\tmp\@empty\else~[#1]\fi}}
   1.441 +\renewcommand{\htmlimage}[2][]{}
   1.442 +\renewcommand{\htmlborder}[2][]{}
   1.443 +
   1.444 +
   1.445 +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
   1.446 +%
   1.447 +%  HTML  HTMLset  HTMLsetenv
   1.448 +%
   1.449 +%  These commands do nothing in LaTeX, but can be used to place
   1.450 +%  HTML tags or set Perl variables during the LaTeX2HTML processing;
   1.451 +%  They are intended for expert use only.
   1.452 +
   1.453 +\newcommand{\HTMLcode}[2][]{}
   1.454 +\ifx\undefined\HTML\newcommand{\HTML}[2][]{}\else
   1.455 +\typeout{*** Warning: \string\HTML\space had an incompatible definition ***}%
   1.456 +\typeout{*** instead use \string\HTMLcode\space for raw HTML code ***}%
   1.457 +\fi 
   1.458 +\newcommand{\HTMLset}[3][]{}
   1.459 +\newcommand{\HTMLsetenv}[3][]{}
   1.460 +
   1.461 +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
   1.462 +%
   1.463 +% The following commands pertain to document segmentation, and
   1.464 +% were added by Herbert Swan <dprhws@edp.Arco.com> (with help from
   1.465 +% Michel Goossens <goossens@cern.ch>):
   1.466 +%
   1.467 +%
   1.468 +% This command inputs internal latex2html tables so that large
   1.469 +% documents can to partitioned into smaller (more manageable)
   1.470 +% segments.
   1.471 +%
   1.472 +\newcommand{\internal}[2][internals]{}
   1.473 +
   1.474 +%
   1.475 +%  Define a dummy stub \htmlhead{}.  This command causes latex2html
   1.476 +%  to define the title of the start of a new segment.  It is not
   1.477 +%  normally placed in the user's document.  Rather, it is passed to
   1.478 +%  latex2html via a .ptr file written by \segment.
   1.479 +%
   1.480 +\newcommand{\htmlhead}[3][]{}
   1.481 +
   1.482 +%  In the LaTeX2HTML version this will eliminate the title line
   1.483 +%  generated by a \segment command, but retains the title string
   1.484 +%  for use in other places.
   1.485 +%
   1.486 +\newcommand{\htmlnohead}{}
   1.487 +
   1.488 +
   1.489 +%  In the LaTeX2HTML version this put a URL into a <BASE> tag
   1.490 +%  within the <HEAD>...</HEAD> portion of a document.
   1.491 +%
   1.492 +\newcommand{\htmlbase}[1]{}
   1.493 +%
   1.494 +
   1.495 +%
   1.496 +%  The dummy command \endpreamble is needed by latex2html to
   1.497 +%  mark the end of the preamble in document segments that do
   1.498 +%  not contain a \begin{document}
   1.499 +%
   1.500 +\newcommand{\startdocument}{}
   1.501 +
   1.502 +
   1.503 +% \tableofchildlinks, \htmlinfo
   1.504 +%     by Ross Moore  ---  extensions dated 27 September 1997
   1.505 +%
   1.506 +%  These do nothing in LaTeX but for LaTeX2HTML they mark 
   1.507 +%  where the table of child-links and info-page should be placed,
   1.508 +%  when the user wants other than the default.
   1.509 +%	\tableofchildlinks	 % put mini-TOC at this location
   1.510 +%	\tableofchildlinks[off]	 % not on current page
   1.511 +%	\tableofchildlinks[none] % not on current and subsequent pages
   1.512 +%	\tableofchildlinks[on]   % selectively on current page
   1.513 +%	\tableofchildlinks[all]  % on current and all subsequent pages
   1.514 +%	\htmlinfo	 	 % put info-page at this location
   1.515 +%	\htmlinfo[off]		 % no info-page in current document
   1.516 +%	\htmlinfo[none]		 % no info-page in current document
   1.517 +%  *-versions omit the preceding <BR> tag.
   1.518 +%
   1.519 +\newcommand{\tableofchildlinks}{%
   1.520 +  \@ifstar\tableofchildlinksstar\tableofchildlinksstar}
   1.521 +\newcommand{\tableofchildlinksstar}[1][]{}
   1.522 +
   1.523 +\newcommand{\htmlinfo}{\@ifstar\htmlinfostar\htmlinfostar}
   1.524 +\newcommand{\htmlinfostar}[1][]{}
   1.525 +
   1.526 +
   1.527 +%  This redefines  \begin  to allow for an optional argument
   1.528 +%  which is used by LaTeX2HTML to specify `style-sheet' information
   1.529 +
   1.530 +\let\realLaTeX@begin=\begin
   1.531 +\renewcommand{\begin}[1][]{\realLaTeX@begin}
   1.532 +
   1.533 +
   1.534 +%
   1.535 +%  Allocate a new set of section counters, which will get incremented
   1.536 +%  for "*" forms of sectioning commands, and for a few miscellaneous
   1.537 +%  commands.
   1.538 +%
   1.539 +
   1.540 +\newcounter{lpart}
   1.541 +\newcounter{lchapter}[part]
   1.542 +\@ifundefined{c@chapter}%
   1.543 + {\let\Hchapter\relax \newcounter{lsection}[part]}%
   1.544 + {\let\Hchapter=\chapter \newcounter{lsection}[chapter]}
   1.545 +\newcounter{lsubsection}[section]
   1.546 +\newcounter{lsubsubsection}[subsection]
   1.547 +\newcounter{lparagraph}[subsubsection]
   1.548 +\newcounter{lsubparagraph}[paragraph]
   1.549 +\newcounter{lequation}
   1.550 +
   1.551 +%
   1.552 +%  Redefine "*" forms of sectioning commands to increment their
   1.553 +%  respective counters.
   1.554 +%
   1.555 +\let\Hpart=\part
   1.556 +%\let\Hchapter=\chapter
   1.557 +\let\Hsection=\section
   1.558 +\let\Hsubsection=\subsection
   1.559 +\let\Hsubsubsection=\subsubsection
   1.560 +\let\Hparagraph=\paragraph
   1.561 +\let\Hsubparagraph=\subparagraph
   1.562 +\let\Hsubsubparagraph=\subsubparagraph
   1.563 +
   1.564 +\ifx\c@subparagraph\undefined
   1.565 + \newcounter{lsubsubparagraph}[lsubparagraph]
   1.566 +\else
   1.567 + \newcounter{lsubsubparagraph}[subparagraph]
   1.568 +\fi
   1.569 +
   1.570 +%
   1.571 +%  The following definitions are specific to LaTeX2e:
   1.572 +%  (They must be commented out for LaTeX 2.09)
   1.573 +%
   1.574 +\renewcommand{\part}{\@ifstar{\stepcounter{lpart}%
   1.575 +  \bgroup\def\tmp{*}\H@part}{\bgroup\def\tmp{}\H@part}}
   1.576 +\newcommand{\H@part}[1][]{\def\tmp@a{#1}\check@align
   1.577 + \expandafter\egroup\expandafter\Hpart\tmp}
   1.578 +
   1.579 +\ifx\Hchapter\relax\else
   1.580 + \def\chapter{\resetsections \@ifstar{\stepcounter{lchapter}%
   1.581 +   \bgroup\def\tmp{*}\H@chapter}{\bgroup\def\tmp{}\H@chapter}}\fi
   1.582 +\newcommand{\H@chapter}[1][]{\def\tmp@a{#1}\check@align
   1.583 + \expandafter\egroup\expandafter\Hchapter\tmp}
   1.584 +
   1.585 +\renewcommand{\section}{\resetsubsections
   1.586 + \@ifstar{\stepcounter{lsection}\bgroup\def\tmp{*}%
   1.587 +   \H@section}{\bgroup\def\tmp{}\H@section}}
   1.588 +\newcommand{\H@section}[1][]{\def\tmp@a{#1}\check@align
   1.589 + \expandafter\egroup\expandafter\Hsection\tmp}
   1.590 +
   1.591 +\renewcommand{\subsection}{\resetsubsubsections
   1.592 + \@ifstar{\stepcounter{lsubsection}\bgroup\def\tmp{*}%
   1.593 +   \H@subsection}{\bgroup\def\tmp{}\H@subsection}}
   1.594 +\newcommand{\H@subsection}[1][]{\def\tmp@a{#1}\check@align
   1.595 + \expandafter\egroup\expandafter\Hsubsection\tmp}
   1.596 +
   1.597 +\renewcommand{\subsubsection}{\resetparagraphs
   1.598 + \@ifstar{\stepcounter{lsubsubsection}\bgroup\def\tmp{*}%
   1.599 +   \H@subsubsection}{\bgroup\def\tmp{}\H@subsubsection}}
   1.600 +\newcommand{\H@subsubsection}[1][]{\def\tmp@a{#1}\check@align
   1.601 + \expandafter\egroup\expandafter\Hsubsubsection\tmp}
   1.602 +
   1.603 +\renewcommand{\paragraph}{\resetsubparagraphs
   1.604 + \@ifstar{\stepcounter{lparagraph}\bgroup\def\tmp{*}%
   1.605 +   \H@paragraph}{\bgroup\def\tmp{}\H@paragraph}}
   1.606 +\newcommand\H@paragraph[1][]{\def\tmp@a{#1}\check@align
   1.607 + \expandafter\egroup\expandafter\Hparagraph\tmp}
   1.608 +
   1.609 +\renewcommand{\subparagraph}{\resetsubsubparagraphs
   1.610 + \@ifstar{\stepcounter{lsubparagraph}\bgroup\def\tmp{*}%
   1.611 +   \H@subparagraph}{\bgroup\def\tmp{}\H@subparagraph}}
   1.612 +\newcommand\H@subparagraph[1][]{\def\tmp@a{#1}\check@align
   1.613 + \expandafter\egroup\expandafter\Hsubparagraph\tmp}
   1.614 +
   1.615 +\ifx\Hsubsubparagraph\relax\else\@ifundefined{subsubparagraph}{}{%
   1.616 +\def\subsubparagraph{%
   1.617 + \@ifstar{\stepcounter{lsubsubparagraph}\bgroup\def\tmp{*}%
   1.618 +   \H@subsubparagraph}{\bgroup\def\tmp{}\H@subsubparagraph}}}\fi
   1.619 +\newcommand\H@subsubparagraph[1][]{\def\tmp@a{#1}\check@align
   1.620 + \expandafter\egroup\expandafter\Hsubsubparagraph\tmp}
   1.621 +
   1.622 +\def\check@align{\def\empty{}\ifx\tmp@a\empty
   1.623 + \else\def\tmp@b{center}\ifx\tmp@a\tmp@b\let\tmp@a\empty
   1.624 + \else\def\tmp@b{left}\ifx\tmp@a\tmp@b\let\tmp@a\empty
   1.625 + \else\def\tmp@b{right}\ifx\tmp@a\tmp@b\let\tmp@a\empty
   1.626 + \else\expandafter\def\expandafter\tmp@a\expandafter{\expandafter[\tmp@a]}%
   1.627 + \fi\fi\fi \def\empty{}\ifx\tmp\empty\let\tmp=\tmp@a \else 
   1.628 +  \expandafter\def\expandafter\tmp\expandafter{\expandafter*\tmp@a}%
   1.629 + \fi\fi}
   1.630 +%
   1.631 +\def\resetsections{\setcounter{section}{0}\setcounter{lsection}{0}%
   1.632 + \reset@dependents{section}\resetsubsections }
   1.633 +\def\resetsubsections{\setcounter{subsection}{0}\setcounter{lsubsection}{0}%
   1.634 + \reset@dependents{subsection}\resetsubsubsections }
   1.635 +\def\resetsubsubsections{\setcounter{subsubsection}{0}\setcounter{lsubsubsection}{0}%
   1.636 + \reset@dependents{subsubsection}\resetparagraphs }
   1.637 +%
   1.638 +\def\resetparagraphs{\setcounter{lparagraph}{0}\setcounter{lparagraph}{0}%
   1.639 + \reset@dependents{paragraph}\resetsubparagraphs }
   1.640 +\def\resetsubparagraphs{\ifx\c@subparagraph\undefined\else
   1.641 +  \setcounter{subparagraph}{0}\fi \setcounter{lsubparagraph}{0}%
   1.642 + \reset@dependents{subparagraph}\resetsubsubparagraphs }
   1.643 +\def\resetsubsubparagraphs{\ifx\c@subsubparagraph\undefined\else
   1.644 +  \setcounter{subsubparagraph}{0}\fi \setcounter{lsubsubparagraph}{0}}
   1.645 +%
   1.646 +\def\reset@dependents#1{\begingroup\let \@elt \@stpelt
   1.647 + \csname cl@#1\endcsname\endgroup}
   1.648 +%
   1.649 +%
   1.650 +%  Define a helper macro to dump a single \secounter command to a file.
   1.651 +%
   1.652 +\newcommand{\DumpPtr}[2]{%
   1.653 +\count255=\arabic{#1}\def\dummy{dummy}\def\tmp{#2}%
   1.654 +\ifx\tmp\dummy\else\advance\count255 by \arabic{#2}\fi
   1.655 +\immediate\write\ptrfile{%
   1.656 +\noexpand\setcounter{#1}{\number\count255}}}
   1.657 +
   1.658 +%
   1.659 +%  Define a helper macro to dump all counters to the file.
   1.660 +%  The value for each counter will be the sum of the l-counter
   1.661 +%      actual LaTeX section counter.
   1.662 +%  Also dump an \htmlhead{section-command}{section title} command
   1.663 +%      to the file.
   1.664 +%
   1.665 +\newwrite\ptrfile
   1.666 +\def\DumpCounters#1#2#3#4{%
   1.667 +\begingroup\let\protect=\noexpand
   1.668 +\immediate\openout\ptrfile = #1.ptr
   1.669 +\DumpPtr{part}{lpart}%
   1.670 +\ifx\Hchapter\relax\else\DumpPtr{chapter}{lchapter}\fi
   1.671 +\DumpPtr{section}{lsection}%
   1.672 +\DumpPtr{subsection}{lsubsection}%
   1.673 +\DumpPtr{subsubsection}{lsubsubsection}%
   1.674 +\DumpPtr{paragraph}{lparagraph}%
   1.675 +\DumpPtr{subparagraph}{lsubparagraph}%
   1.676 +\DumpPtr{equation}{lequation}%
   1.677 +\DumpPtr{footnote}{dummy}%
   1.678 +\def\tmp{#4}\ifx\tmp\@empty
   1.679 +\immediate\write\ptrfile{\noexpand\htmlhead{#2}{#3}}\else
   1.680 +\immediate\write\ptrfile{\noexpand\htmlhead[#4]{#2}{#3}}\fi
   1.681 +\dumpcitestatus \dumpcurrentcolor
   1.682 +\immediate\closeout\ptrfile
   1.683 +\endgroup }
   1.684 +
   1.685 +
   1.686 +%% interface to natbib.sty
   1.687 +
   1.688 +\def\dumpcitestatus{}
   1.689 +\def\loadcitestatus{\def\dumpcitestatus{%
   1.690 +  \ifciteindex\immediate\write\ptrfile{\noexpand\citeindextrue}%
   1.691 +  \else\immediate\write\ptrfile{\noexpand\citeindexfalse}\fi }%
   1.692 +}
   1.693 +\@ifpackageloaded{natbib}{\loadcitestatus}{%
   1.694 + \AtBeginDocument{\@ifpackageloaded{natbib}{\loadcitestatus}{}}}
   1.695 +
   1.696 +
   1.697 +%% interface to color.sty
   1.698 +
   1.699 +\def\dumpcurrentcolor{}
   1.700 +\def\loadsegmentcolors{%
   1.701 + \let\real@pagecolor=\pagecolor
   1.702 + \let\pagecolor\segmentpagecolor
   1.703 + \let\segmentcolor\color
   1.704 + \ifx\current@page@color\undefined \def\current@page@color{{}}\fi
   1.705 + \def\dumpcurrentcolor{\bgroup\def\@empty@{{}}%
   1.706 +   \expandafter\def\expandafter\tmp\space####1@{\def\thiscol{####1}}%
   1.707 +  \ifx\current@color\@empty@\def\thiscol{}\else
   1.708 +   \expandafter\tmp\current@color @\fi
   1.709 +  \immediate\write\ptrfile{\noexpand\segmentcolor{\thiscol}}%
   1.710 +  \ifx\current@page@color\@empty@\def\thiscol{}\else
   1.711 +   \expandafter\tmp\current@page@color @\fi
   1.712 +  \immediate\write\ptrfile{\noexpand\segmentpagecolor{\thiscol}}%
   1.713 + \egroup}%
   1.714 + \global\let\loadsegmentcolors=\relax
   1.715 +}
   1.716 +
   1.717 +% These macros are needed within  images.tex  since this inputs
   1.718 +% the <segment>.ptr files for a segment, so that counters are
   1.719 +% colors are synchronised.
   1.720 +%
   1.721 +\newcommand{\segmentpagecolor}[1][]{%
   1.722 + \@ifpackageloaded{color}{\loadsegmentcolors\bgroup
   1.723 +  \def\tmp{#1}\ifx\@empty\tmp\def\next{[]}\else\def\next{[#1]}\fi
   1.724 +  \expandafter\segmentpagecolor@\next}%
   1.725 + {\@gobble}}
   1.726 +\def\segmentpagecolor@[#1]#2{\def\tmp{#1}\def\tmpB{#2}%
   1.727 + \ifx\tmpB\@empty\let\next=\egroup
   1.728 + \else
   1.729 +  \let\realendgroup=\endgroup
   1.730 +  \def\endgroup{\edef\next{\noexpand\realendgroup
   1.731 +   \def\noexpand\current@page@color{\current@color}}\next}%
   1.732 +  \ifx\tmp\@empty\real@pagecolor{#2}\def\model{}%
   1.733 +  \else\real@pagecolor[#1]{#2}\def\model{[#1]}%
   1.734 +  \fi
   1.735 +  \edef\next{\egroup\def\noexpand\current@page@color{\current@page@color}%
   1.736 +  \noexpand\real@pagecolor\model{#2}}%
   1.737 + \fi\next}
   1.738 +%
   1.739 +\newcommand{\segmentcolor}[2][named]{\@ifpackageloaded{color}%
   1.740 + {\loadsegmentcolors\segmentcolor[#1]{#2}}{}}
   1.741 +
   1.742 +\@ifpackageloaded{color}{\loadsegmentcolors}{\let\real@pagecolor=\@gobble
   1.743 + \AtBeginDocument{\@ifpackageloaded{color}{\loadsegmentcolors}{}}}
   1.744 +
   1.745 +
   1.746 +%  Define the \segment[align]{file}{section-command}{section-title} command,
   1.747 +%  and its helper macros.  This command does four things:
   1.748 +%       1)  Begins a new LaTeX section;
   1.749 +%       2)  Writes a list of section counters to file.ptr, each
   1.750 +%           of which represents the sum of the LaTeX section
   1.751 +%           counters, and the l-counters, defined above;
   1.752 +%       3)  Write an \htmlhead{section-title} command to file.ptr;
   1.753 +%       4)  Inputs file.tex.
   1.754 +
   1.755 +\def\segment{\@ifstar{\@@htmls}{\@@html}}
   1.756 +\def\endsegment{}
   1.757 +\newcommand{\@@htmls}[1][]{\@@htmlsx{#1}}
   1.758 +\newcommand{\@@html}[1][]{\@@htmlx{#1}}
   1.759 +\def\@@htmlsx#1#2#3#4{\csname #3\endcsname* {#4}%
   1.760 +                   \DumpCounters{#2}{#3*}{#4}{#1}\input{#2}}
   1.761 +\def\@@htmlx#1#2#3#4{\csname #3\endcsname {#4}%
   1.762 +                   \DumpCounters{#2}{#3}{#4}{#1}\input{#2}}
   1.763 +
   1.764 +\makeatother
   1.765 +\endinput
   1.766 +
   1.767 +
   1.768 +% Modifications:
   1.769 +%
   1.770 +% (The listing of Initiales see Changes)
   1.771 +
   1.772 +% $Log: html.sty,v $
   1.773 +% Revision 1.23  1998/02/26 10:32:24  latex2html
   1.774 +%  --  use \providecommand for  \latextohtml
   1.775 +%  --  implemented \HTMLcode to do what \HTML did previously
   1.776 +% 	\HTML still works, unless already defined by another package
   1.777 +%  --  fixed problems remaining with undefined \chapter
   1.778 +%  --  defined \endsegment
   1.779 +%
   1.780 +% Revision 1.22  1997/12/05 11:38:18  RRM
   1.781 +%  --  implemented an optional argument to \begin for style-sheet info.
   1.782 +%  --  modified use of an optional argument with sectioning-commands
   1.783 +%
   1.784 +% Revision 1.21  1997/11/05 10:28:56  RRM
   1.785 +%  --  replaced redefinition of \@htmlrule with \htmlrulestar
   1.786 +%
   1.787 +% Revision 1.20  1997/10/28 02:15:58  RRM
   1.788 +%  --  altered the way some special html-macros are defined, so that
   1.789 +% 	star-variants are explicitly defined for LaTeX
   1.790 +% 	 -- it is possible for these to occur within  images.tex
   1.791 +% 	e.g. \htmlinfostar \htmlrulestar \tableofchildlinksstar
   1.792 +%
   1.793 +% Revision 1.19  1997/10/11 05:47:48  RRM
   1.794 +%  --  allow the dummy {tex2html_nowrap} environment in LaTeX
   1.795 +% 	use it to make its contents be evaluated in environment order
   1.796 +%
   1.797 +% Revision 1.18  1997/10/04 06:56:50  RRM
   1.798 +%  --  uses Robin Fairbairns' code for ignored environments,
   1.799 +%      replacing the previous  comment.sty  stuff.
   1.800 +%  --  extensions to the \tableofchildlinks command
   1.801 +%  --  extensions to the \htmlinfo command
   1.802 +%
   1.803 +% Revision 1.17  1997/07/08 11:23:39  RRM
   1.804 +%     include value of footnote counter in .ptr files for segments
   1.805 +%
   1.806 +% Revision 1.16  1997/07/03 08:56:34  RRM
   1.807 +%     use \textup  within the \latextohtml macro
   1.808 +%
   1.809 +% Revision 1.15  1997/06/15 10:24:58  RRM
   1.810 +%      new command  \htmltracenv  as environment-ordered \htmltracing
   1.811 +%
   1.812 +% Revision 1.14  1997/06/06 10:30:37  RRM
   1.813 +%  -   new command:  \htmlborder  puts environment into a <TABLE> cell
   1.814 +%      with a border of specified width, + other attributes.
   1.815 +%  -   new commands: \HTML  for setting arbitrary HTML tags, with attributes
   1.816 +%                    \HTMLset  for setting Perl variables, while processing
   1.817 +%                    \HTMLsetenv  same as \HTMLset , but it gets processed
   1.818 +%                                 as if it were an environment.
   1.819 +%  -   new command:  \latextohtml  --- to set the LaTeX2HTML name/logo
   1.820 +%  -   fixed some remaining problems with \segmentcolor & \segmentpagecolor
   1.821 +%
   1.822 +% Revision 1.13  1997/05/19 13:55:46  RRM
   1.823 +%      alterations and extra options to  \hypercite
   1.824 +%
   1.825 +% Revision 1.12  1997/05/09 12:28:39  RRM
   1.826 +%  -  Added the optional argument to \htmlhead, also in \DumpCounters
   1.827 +%  -  Implemented \HTMLset as a no-op in LaTeX.
   1.828 +%  -  Fixed a bug in accessing the page@color settings.
   1.829 +%
   1.830 +% Revision 1.11  1997/03/26 09:32:40  RRM
   1.831 +%  -  Implements LaTeX versions of  \externalcite  and  \hypercite  commands.
   1.832 +%     Thanks to  Uffe Engberg  and  Stephen Simpson  for the suggestions.
   1.833 +%
   1.834 +% Revision 1.10  1997/03/06 07:37:58  RRM
   1.835 +% Added the  \htmltracing  command, for altering  $VERBOSITY .
   1.836 +%
   1.837 +% Revision 1.9  1997/02/17 02:26:26  RRM
   1.838 +% - changes to counter handling (RRM)
   1.839 +% - shuffled around some definitions
   1.840 +% - changed \htmlrule of 209 mode
   1.841 +%
   1.842 +% Revision 1.8  1997/01/26 09:04:12  RRM
   1.843 +% RRM: added optional argument to sectioning commands
   1.844 +%      \htmlbase  sets the <BASE HREF=...> tag
   1.845 +%      \htmlinfo  and  \htmlinfo* allow the document info to be positioned
   1.846 +%
   1.847 +% Revision 1.7  1997/01/03 12:15:44  L2HADMIN
   1.848 +% % - fixes to the  color  and  natbib  interfaces
   1.849 +% % - extended usage of  \hyperref, via an optional argument.
   1.850 +% % - extended use comment environments to allow shifting expansions
   1.851 +% %     e.g. within \multicolumn  (`bug' reported by Luc De Coninck).
   1.852 +% % - allow optional argument to: \htmlimage, \htmlhead,
   1.853 +% %     \htmladdimg, \htmladdnormallink, \htmladdnormallinkfoot
   1.854 +% % - added new commands: \htmlbody, \htmlnohead
   1.855 +% % - added new command: \tableofchildlinks
   1.856 +%
   1.857 +% Revision 1.6  1996/12/25 03:04:54  JCL
   1.858 +% added patches to segment feature from Martin Wilck
   1.859 +%
   1.860 +% Revision 1.5  1996/12/23 01:48:06  JCL
   1.861 +%  o introduced the environment makeimage, which may be used to force
   1.862 +%    LaTeX2HTML to generate an image from the contents.
   1.863 +%    There's no magic, all what we have now is a defined empty environment
   1.864 +%    which LaTeX2HTML will not recognize and thus pass it to images.tex.
   1.865 +%  o provided \protect to the \htmlrule commands to allow for usage
   1.866 +%    within captions.
   1.867 +%
   1.868 +% Revision 1.4  1996/12/21 19:59:22  JCL
   1.869 +% - shuffled some entries
   1.870 +% - added \latexhtml command
   1.871 +%
   1.872 +% Revision 1.3  1996/12/21 12:22:59  JCL
   1.873 +% removed duplicate \htmlrule, changed \htmlrule back not to create a \hrule
   1.874 +% to allow occurrence in caption
   1.875 +%
   1.876 +% Revision 1.2  1996/12/20 04:03:41  JCL
   1.877 +% changed occurrence of \makeatletter, \makeatother
   1.878 +% added new \htmlrule command both for the LaTeX2.09 and LaTeX2e
   1.879 +% sections
   1.880 +%
   1.881 +%
   1.882 +% jcl 30-SEP-96
   1.883 +%  - Stuck the commands commonly used by both LaTeX versions to the top,
   1.884 +%    added a check which stops input or reads further if the document
   1.885 +%    makes use of LaTeX2e.
   1.886 +%  - Introduced rrm's \dumpcurrentcolor and \bodytext
   1.887 +% hws 31-JAN-96 - Added support for document segmentation
   1.888 +% hws 10-OCT-95 - Added \htmlrule command
   1.889 +% jz 22-APR-94 - Added support for htmlref
   1.890 +% nd  - Created