Permalink
Browse files

remove obsolete "table" option

  • Loading branch information...
Dan Gildea
Dan Gildea committed Dec 14, 2018
1 parent 7b2f999 commit 24f02949f8ebcee888685fb220061a57260b12ce
Showing with 24 additions and 343 deletions.
  1. +2 −0 Changes
  2. +0 −67 docs/features.tex
  3. +13 −16 docs/userman.tex
  4. +4 −12 latex2html.1
  5. +5 −5 latex2html.pin
  6. +0 −243 versions/table.pl
@@ -112,6 +112,8 @@
# A more detailed log history can be found within the particular files, near
# the top.
#
# - remove obsolete "table" option
# https://bugs.debian.org/276037
# - fix "make test"
# - ppmtopng syntax works with all versions of ppmtopng
# - respect ./configure --with-perl=/bin/perl
@@ -43,41 +43,11 @@ \subsection{Variation with HTML Versions\label{versions}}%
In order to make your documents viewable by the widest possible audience,
you should use the most advanced \texttt{HTML} version with widely-accepted usage.

Currently the most advanced is \HTMLIV.
However this has only recently become an officially recommended version.
Not all of its features are fully implemented in popular browsers,
and the level of usage is unclear.
Hence the default version for \latextohtml, version 98.1 remains at \HTMLIII.
Further work is required before \latextohtml{} can fully exploit the
features available using \HTMLIV.

\index{iso-latin1@ISO--Latin--1|see{\htmlref{character set}{IIIcharset}}}%
\index{iso-8879@ISO--8879|see{\htmlref{character set}{IIIcharset}}}%
\index{character set!ISO-8879@ISO--8879 (ISO--Latin--1)}%
\index{HTML@\texttt{HTML}!interactive forms}%
\index{HTML@\texttt{HTML}!image-maps}%
This provides support for alignment of headings, images and text
(including text-flow around images), tables with separate captions
and alignment of rows and columns, variable sizes and colors for
text and color or patterns for the background
as well as images, server-side image-maps, interactive forms,
and the minimal typographic elements (bold, italic and teletype)
that were supported already in \texttt{HTML} version 2.0\,.
Furthermore, \texttt{HTML} version 3.2
adheres to the \htmladdnormallink{ISO--Latin--1}%
{http://www.w3.org/hypertext/WWW/MarkUp/html-spec_9.html\#SEC9.7.2}
(ISO--8879) character set.

\medskip\noindent
\textbf{Note: }Although many people still use old browsers
that implement only features available with \texttt{HTML} 2.0,
this is \emph{not} a good reason to limit translation of documents
to using only these effects. Most of the translation done by \latextohtml{}
will still give acceptable results on older browsers.
The deficiencies due to lack of super/subscripts, tables
and some alignment effects should eventually convince such users
to overcome the inertia, and update their browsers to later versions that
correctly support these effects.

\medskip\noindent
Sometimes it is known that the audience, for which a specific document
@@ -130,43 +100,6 @@ \subsection{Variation with HTML Versions\label{versions}}%
will be required in Web-accessible documents.


\index{HTML@\texttt{HTML}!Version 2.2, now `table' extension}%
\index{HTML@\texttt{HTML}!HTML3 Tables@\texttt{HTML3} Table Model }%
\index{tables!as HTML mark-up@as \texttt{HTML} mark-up}%
\index{Netscape@\textsl{Netscape Navigator}!HTML3 Tables@\texttt{HTML3} Tables}%
\item[tables (\texttt{HTML3} model)\label{tables3}\strikeout{Version 2.2}]
Although \texttt{HTML} 3.2 implements tables using \HTMLtag{TABLE} tags,
the capabilities available to specify details of the table-layout
are not as extensive as were originally proposed in the
\htmladdnormallink{\texttt{HTML3} Table Model}%
{http://www.w3.org/pub/WWW/TR/WD-tables}.
This extension (formerly referred to as \texttt{HTML} version 2.2)
provides the full capabilities of this model.

Note that current browsers may not correctly interpret all
the features of tables constructed using this extension.
Tables will be constructed, perhaps with some cells mis-aligned
or without the desired merging of adjacent cells, etc.
This feature was already available in many \texttt{HTML} browsers,
including \appl{Netscape Navigator} V1.2, so should be still
available with later versions of these browsers.


\index{HTML@\texttt{HTML}!Version 3.0}%
\item[\texttt{HTML} 3.0\label{html30}]
This version of \texttt{HTML} was never accepted to become
a recognised standard; perhaps because some of its models
were ``too advanced'' at the time
(notably the \htmlref{\texttt{HTML-Math}}{math3}
and the \htmlref{Table Model}{tables3}).
The proposed \htmladdnormallink{\texttt{HTML} 3.0}%
{http://www.w3.org/pub/WWW/MarkUp/html3/}
``standard'' was withdrawn and re-drafted to create
the \texttt{HTML} 3.2 standard which is in current use.
Standard textual formatting features, including centering, flush-right,
flush-left and underlining are among the features retained.


\index{HTML@\texttt{HTML}!Version 3.0, \texttt{HTML-Math} model}%
\index{HTML@\texttt{HTML}!Version 3.1, now `math' extension}%
\index{Arena@\textsl{Arena}!math mark-up}\index{CERN!Arena@\textsl{Arena}}%
@@ -462,12 +462,11 @@ \subsubsection{Options controlling Extensions and Special Features}
%
\index{HTML version@\texttt{HTML} version}%
\index{HTML@\texttt{HTML}!non-standard extensions}%
\item [ -html\_version \texttt{(2.0|3.0|3.2)[,(math|i18n|table)]*}\label{cs_htmlversion}]
\item [ -html\_version \texttt{(2.0|3.2|4.0|5.0)[,(math|i18n)]*}\label{cs_htmlversion}]
~\\\sameas{\fn{\$HTML\_VERSION}\texttt{ = \char34 ... \char34;}}\\
This specifies both the \texttt{HTML}~\htmlref{version}{version} to generate,
and any extra (non-standard) \texttt{HTML} features that may be required.\html{\\}
The version number corresponds to a published DTD for an \texttt{HTML} standard
(although 3.0 was never accepted and subsequently withdrawn).
The version number corresponds to a published DTD for an \texttt{HTML} standard.
A corresponding \Perl{} file in the \fn{versions/} subdirectory is loaded;
these files are named `\texttt{html}\Meta{num}\texttt{.pl}'.

@@ -479,14 +478,8 @@ \subsubsection{Options controlling Extensions and Special Features}
An exception is \Ve{math} when the \htmlref{\Cs{no\_math}}{nomath}
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 \Ve{i18n}, \Ve{tables}, \Ve{math}
correspond roughly to what used to be called versions `2.1', `2.2', `3.1'
respectively, in releases of \latextohtml{} up to 1996.
Now these extensions can be loaded with any of `2.0', `3.2' or `4.0'
as the specified standard.\\
The default version is usually set to be `3.2', within \fn{latex2html.config}\,.%
Currently, versions 2.0, 3.2. 4.0 and 5.0 are available.
The default version is usually set to be `5.0', within \fn{latex2html.config}\,.%

\index{extensions!disabled}%
\index{extensions!TeX defs@\TeX definitions}%
@@ -716,15 +709,19 @@ \subsubsection{Switches controlling Image Generation}
It does not respect the \fn{\$MATH\_SCALE\_FACTOR} option.

\index{use-pdftex}%
\item [ -use\_pdftex \label{cs_use_pdftex}]
Use the pdflatex program followed by pdfcrop and gs to generate images,
\item [ -(no)use\_pdftex \label{cs_use_pdftex}]
By default, pdflatex is used to process input files.
Specify -nouse\_pdftex for documents that rely on
standard, dvi-producing latex.

The pdflatex method uses the pdflatex program followed by pdfcrop and gs to generate images,
rather than latex followed by dvips. This method can be useful for
pdfLaTeX documents which cannot be translated by latex.
This method can sometimes produce slightly better alignment
of math formulas and eliminate ugly crop marks.
The pdflatex method generally produces better alignment
of math formulas and eliminates ugly crop marks.
It does not respect the \fn{\$MATH\_SCALE\_FACTOR} option.

This method uses the pdfwrite GhostScript driver by default.
The pdflatex method uses the pdfwrite GhostScript driver by default.
If called together with the -use\_dvipng option, it will use
the png16m driver and produce slightly different math alignment.

@@ -273,7 +273,7 @@ alternative strategies for implementing portions of
.B LaTeX
code.
.TP
.B -html_version (2.0|3.0|3.2)[,(math|i18n|table)]*
.B -html_version (2.0|3.2|4.0|5.0)[,(math|i18n)]*
Same as setting:
.I $HTML_VERSION = "... ";
This specifies both the
@@ -284,8 +284,7 @@ version to generate, and any extra
features that may be required.
The version number corresponds to a published DTD for an
.B HTML
standard
(although 3.0 was never accepted and subsequently withdrawn). A
standard. A
corresponding
.B Perl
file in the versions/ subdirectory is loaded; these
@@ -296,15 +295,8 @@ versions/ subdirectory. When such a file is loaded the resulting HTML
code can no longer be expected to validate with the specified DTD. An
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.
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
up to 1996. Now
these extensions can be loaded with any of `2.0', `3.2' or `4.0' as the
specified standard.
The default version is usually set to be `4.0', within
Currently, versions 2.0, 3.2, 4.0 and 5.0 are available.
The default version is usually set to be `5.0', within
latex2html.config.
.TP
.B -no_tex_defs
@@ -10831,7 +10831,7 @@ sub do_cmd_lq {
sub do_leftquote {
# MRO: use $_[0] : local(*_) = @_;
local($quote,$lquo) = ('',($HTML_VERSION<5)? '&#8216;' : ';SPMlsquo;');
local($quote,$lquo) = ('',($HTML_VERSION<4)? '&#8216;' : ';SPMlsquo;');
# select whole quotation, if \lq matches \rq
if ($_[0] =~ /^(.*)((\\rq\\rq|'')*)(\\rq)/) {
$quote = $1.$2; $_[0] = $';
@@ -15941,7 +15941,7 @@ sub initialise {
} else {
print "\n You specified an invalid version: $HTML_VERSION\n"
. "In future please request extensions by name:\n"
. " i18n table math frame latin1 unicode etc.\n";
. " i18n math frame latin1 unicode etc.\n";

# Require all necessary version specific files
foreach ( sort <$LATEX2HTMLVERSIONS${dd}html[1-9].[0-9].pl> ) {
@@ -17658,9 +17658,9 @@ Here is the type of extra information that is shown at each level:
=item B<-html_version> I<list>

Which HTML version should be generated. Currently available are:
C<2.0>, C<3.0>, C<3.2>, C<4.0>. Some additional options that may be
C<2.0>, C<3.2>, C<4.0>, C<5.0>. Some additional options that may be
added are: C<math> (parse mathematics), C<i18n> (?),
C<table> (generate tables), C<frame> (generate frames),
C<frame> (generate frames),
C<latin1>...C<latin9> (use ISO-Latin-x encoding),
C<unicode> (generate unicode characters). Separate the options with ',',
e.g. C<4.0,math,frame>.
@@ -17757,7 +17757,7 @@ and modified by L. Peter Deutsch (Aladdin Enterprises).
See the WWW online documentation or the F<$LATEX2HTMLDIR/doc/manual.ps>
file for more detailed information and examples.

L<pstoing>, L<texexpand>
L<pstoimg>, L<texexpand>

=cut

Oops, something went wrong.

0 comments on commit 24f0294

Please sign in to comment.