path: root/Master/texmf-dist/source/latex/supertabular/supertabular.dtx

% \iffalse meta-comment
%
% Copyright 1989-2004 Johannes L. Braams.  All rights reserved.
%
% This file is part of the supertabular package.
% ---------------------------------------------
%
% It may be distributed and/or modified under the
% conditions of the LaTeX Project Public License, either version 1.3
% of this license or (at your option) any later version.
% The latest version of this license is in
%   http://www.latex-project.org/lppl.txt
% and version 1.3 or later is part of all distributions of LaTeX
% version 2003/12/01 or later.
%
% This work has the LPPL maintenance status "maintained".
%
% The Current Maintainer of this work is Johannes Braams.
%
% The list of all files belonging to the supertabular package is
% given in the file `MANIFEST.
%
% The list of derived (unpacked) files belonging to the distribution
% and covered by LPPL is defined by the unpacking scripts (with
% extension .ins) which are part of the distribution.
% \fi
%
% \CheckSum{1025}
% \iffalse
%% Sourcefile `supertabular.dtx'.
%%
%% Copyright (C) 1988 by Theo Jurriens 
%% Copyright (C) 1990-2004 by Johannes Braams texniek at braams.cistron.nl
%%                            Kersengaarde 33
%%                            2723 BP Zoetermeer NL
%%                       all rights reserved.
%%
%%
%<*dtx>
\ProvidesFile{supertabular.dtx}
%</dtx>
%<package>\NeedsTeXFormat{LaTeX2e}
%<package>\ProvidesPackage{supertabular}
%<driver>\ProvidesFile{supertabular.drv}
%\ProvidesFile{supertabular.dtx}
              [2004/02/20 v4.1e the supertabular environment]
%
%<*driver>
\documentclass{ltxdoc}
\usepackage{supertabular}
\newcommand{\tbsp}{\rule{0pt}{18pt}}
\begin{document}
\providecommand{\Lenv}[1]{\textsf{#1}}
\providecommand{\pkg}[1]{\texttt{#1}}
\providecommand{\cls}[1]{\texttt{#1}}
\providecommand{\file}[1]{\texttt{#1}}
\DocInput{supertabular.dtx}
\end{document}
%</driver>
% \fi
%
% \changes{v4.0a}{1996/11/28}{Cleanup of the code, now a \file{.dtx}
%    source file} 
% \changes{v4.0c}{1997/02/20}{Replace \cs{tableformat} by
%    \cs{ST@tableformat} to prevent a clash with the \pkg{KOMA}
%    pacakage} 
% \changes{v4.0f}{1997/04/10}{Repaired a few typos in the
%    documentation}
% \changes{v4.1a}{1997/09/18}{Repaired a number of typos and added
%    contributed mpsupertabular environemnts} 
% \changes{v4.1b}{1997/10/08}{Renamed \cs{@@tabularcr} to
%    \cs{org@tabularcr}}
%
%  \GetFileInfo{supertabular.dtx}
%  \title{The \texttt{supertabular} environment\thanks{This file
%        has version number \fileversion, last
%        revised \filedate.}}
%  \author{Johannes Braams and Theo Jurriens}
%  \date{\filedate}
%  \maketitle
%
%  \section{Introduction}
%
%    The package \pkg{supertabular} offers a new environment, the
%    \Lenv{supertabular} environment. As the name indicates it is an
%    extension of the normal \Lenv{tabular} environment.
%
%    With the original \Lenv{tabular} environment a tabular must
%    always fit on \emph{one} page. If the tabular becomes too large
%    the text overwrites the page's bottom margin and you get an
%    \texttt{Overfull vbox} message. 
%
%    The \Lenv{supertabular} environment uses the \Lenv{tabular}
%    environment internally, but it evaluates the used space every
%    time it gets a |\\| command. If the tabular reaches the
%    textheight, it automatically inserts an optional tabletail, an
%    |\end{tabular}| command, starts a new page, a new
%    \Lenv{tabular} environment and inserts the optional tablehead on
%    the new page continuing the tabular.  
%
%  \section{User interface}
%
%    The package \pkg{supertabular} has three options, they control
%    the amount of information that is written to the \file{.log}
%    file. 
%    \begin{enumerate}
%    \item The option \textsf{errorshow} (the default) doens't write
%      any extra information. 
%    \item The option \textsf{pageshow} writes information about when
%      and why \pkg{supertabular} decides to break the tabular
%      environment in order to produce a new page. 
%    \item The option \textsf{debugshow} also adds information about
%      each line that is added to the tabular.
%    \end{enumerate}
%
%    Below is a description of the new commands and environments that
%    this package provides.
%
%  \DescribeMacro{\tablefirsthead}
%    The command |\tablefirsthead| takes one argument, it defines the
%    contents of the first occurence of the tabular head.\\ 
%    The use of this command is optional. Don't forget to close the
%    head by a |\\|.
%
%  \DescribeMacro{\tablehead}
%    The command |\tablehead| takes one argument, it defines the
%    contents of all subsequent ocurrences of the tabular head.\\ 
%    Don't forget to close the head by a |\\|
%
%  \DescribeMacro{\tabletail}
%    The command |\tabletail| takes one argument, it defines something
%    which should be inserted before each |\end{tabular}|, except
%    the last. 
%
%  \DescribeMacro{\tablelasttail}
%    The command |\tablelasttail| takes one argument, it defines
%    something which should be inserted before the last
%    |\end{tabular}|.\\
%    The use of this command is optional.
%
%  \DescribeMacro{\topcaption}
%  \DescribeMacro{\bottomcaption}
%  \DescribeMacro{\tablecaption}
%    These commands all take the same arguments as \LaTeX's standard
%    |\caption| command. They provide a caption for the super-table,
%    either at the top or at the bottom of the table. When
%    |\tablecaption| is used the caption will be placed at the
%    default location, which is at the top.
%
%  \DescribeEnv{supertabular}
%  \DescribeEnv{supertabular*}
%    The environments \Lenv{supertabular} and \Lenv{supertabular*}
%    can be used much like the standard \LaTeX\ environments
%    \Lenv{tabular} and \Lenv{tabular*}.
%
%  \DescribeEnv{mpsupertabular}
%  \DescribeEnv{mpsupertabular*}
%     The environments \Lenv{mpsupertabular} and
%    \Lenv{mpsupertabular*} work like the \Lenv{supertabular} and
%    \Lenv{supertabular*} environments but put each page into a
%    \Lenv{minipage} first. Thus it is possible to have footnotes
%    inside a \Lenv{mpsupertabular}. The footnotetext is printed at
%    the end of each page. 
% 
%  \DescribeMacro{\shrinkheight}
%    The allowed maximimum height of a part of the supertabular on a
%    page can be adjusted using the command |\shrinkheight|. It takes
%    one argument, the length with which to shrink (positive value) or
%    grow (negative value) the allowed height.
%
%  \section{Weak points}
%
%  \begin{itemize}
%  \item When the material of a normal entry (not a p-arg) becomes
%    larger than the estimated |\ST@lineht|, overfull |\vbox|es
%    will be produced at all. 
%  \item When the last p-arg on a page gets more than 4 lines
%    (probably even more than 3 lines) it will result in an  overfull
%    |\vbox|.  Also some combinations of |\baselinestretch|
%    |\arraystretch| and  a large font may lead to one line too much. 
%  \item if accidentally the last line of the tabular produces a
%    newpage, on the next page the tabletail will be written
%    immediately after the tablehead. Depending on the contents this
%    may result in an error message regarding misplaced |\noalign|. 
%
%    A quick but not very elegant solution: shrink the allowed height
%    of the table with the command |\shrinkheight{...pt}| after the
%    first |\\| of the supertabular. 
%  \item The \Lenv{mpsupertabular} environment sometimes has problems 
%    with pagesbreaks when footnotes appear in the lower part of the 
%    tabular. 
%  \end{itemize}
%
%  \section{Examples}
%
%  \DeleteShortVerb{\|}
%    Here is an example of a \Lenv{supertabular}. You will find the
%    definitions after the table.
%
%    \begin{center}
%    \tablefirsthead{%
%      \hline
%      \multicolumn{1}{|c}{\tbsp Number} &
%      \multicolumn{1}{c}{Number$^2$} &
%      Number$^4$ &
%      \multicolumn{1}{c|}{Number!} \\
%      \hline}
%    \tablehead{%
%      \hline
%      \multicolumn{4}{|l|}{\small\sl continued from previous page}\\
%      \hline
%      \multicolumn{1}{|c}{\tbsp Number} &
%      \multicolumn{1}{c}{Number$^2$} &
%      Number$^4$ &
%      \multicolumn{1}{c|}{Number!} \\
%      \hline}
%    \tabletail{%
%      \hline
%      \multicolumn{4}{|r|}{\small\sl continued on next page}\\
%      \hline}
%    \tablelasttail{\hline}
%    \bottomcaption{This table is split across pages}
%
%    \begin{supertabular}{|r@{\hspace{6.5mm}}|r@{\hspace{5.5mm}}|r|r|}
%    1\tbsp &  1  &        1  &           1    \\
%    2   &     4  &       16  &           2    \\
%    3   &     9  &       81  &           6    \\
%    4   &    16  &      256  &          24    \\[5mm]
%    5   &    25  &      625  &         120    \\
%    6   &    36  &     1296  &         720    \\
%    7   &    49  &     2401  &        5040    \\
%    8   &    64  &     4096  &       40320    \\
%    9   &    81  &     6561  &      362880    \\
%    10  &   100  &    10000  &     3628800    \\
%    11  &   121  &    14641  &    39916800    \\
%    12  &   144  &    20736  &   479001600    \\[.5cm]
%    \hline & & & \\
%    13  &   169  &    28561  &  6.22702080E+9 \\[1cm]
%    14  &   196  &    38416  &  8.71782912E+10\\
%    15  &   225  &    50625  &  1.30767437E+12\\
%    16  &   256  &    65536  &  2.09227899E+13\\
%    17  &   289  &    83521  &  3.55687428E+14\\[5mm]
%    18  &   324  &   104976  &  6.40237370E+15\\
%    19  &   361  &   130321  &  1.21645100E+17\\
%    20  &   400  &   160000  &  2.43290200E+18\\
%    \end{supertabular}
%    \end{center}
%
%    And here is (part of) the user input for the table above:
%\begin{verbatim}
%    \begin{center}
%    \tablefirsthead{%
%      \hline
%      \multicolumn{1}{|c}{\tbsp Number} &
%      \multicolumn{1}{c}{Number$^2$} &
%      Number$^4$ &
%      \multicolumn{1}{c|}{Number!} \\
%      \hline}
%    \tablehead{%
%      \hline
%      \multicolumn{4}{|l|}{\small\sl continued from previous page}\\
%      \hline
%      \multicolumn{1}{|c}{\tbsp Number} &
%      \multicolumn{1}{c}{Number$^2$} &
%      Number$^4$ &
%      \multicolumn{1}{c|}{Number!} \\
%      \hline}
%    \tabletail{%
%      \hline
%      \multicolumn{4}{|r|}{\small\sl continued on next page}\\
%      \hline}
%    \tablelasttail{\hline}
%    \bottomcaption{This table is split across pages}
%
%    \begin{supertabular}{|r@{\hspace{6.5mm}}|r@{\hspace{5.5mm}}|r|r|}
%    1   &     1  &        1  &           1    \\
%    2   &     4  &       16  &           2    \\
%    3   &     9  &       81  &           6    \\
%    4   &    16  &      256  &          24    \\[5mm]
%    ...
%    19  &   361  &   130321  &  1.21645100E+17\\
%    20  &   400  &   160000  &  2.43290200E+18\\
%    \end{supertabular}
%    \end{center}
%\end{verbatim}
%
%    Here is another example whith a \texttt{p} column-definition. The
%    tablehead is the same as above. The tabletail is a double
%    \verb|\hline|; \verb|\arraystretch| is set to \texttt{1.5} and
%    the font size is \verb|\small|. 
%
%    \begin{center}
%    \tablelasttail{\hline\hline}
%    \topcaption{This table should also be split accross pages.}
%    \renewcommand{\arraystretch}{1.5}
%    \small
%    \begin{supertabular}{| r@{\hspace{6.5mm}}|%
%                           r@{\hspace{5.5mm}}| r p{5cm}|}
%    1  &  1  &  1  &  \tbsp here is a relative short entry \\
%    2  &  1  &  1  &  and here is a long entry, where line breaks
%                      and line breaks and line breaks have to occur\\
%    3  &  1  &  1  &  and here is a long entry, where line breaks
%                      and line breaks and line breaks have to occur\\
%    4  &  1  &  1  &  and here is a long entry, where line breaks
%                      and line breaks and line breaks have to occur\\
%    5  &  1  &  1  &  here is a relative short entry \\
%    6  &  1  &  1  &  and here is a long entry, where line breaks
%                      and line breaks and line breaks have to occur\\
%    7  &  1  &  1  &  and here is a long entry, where line breaks
%                      and line breaks and line breaks have to occur\\
%    8  &  1  &  1  &  and here is a long entry, where line breaks
%                      and line breaks and line breaks have to occur\\
%    9  &  1  &  1  &  and here is a long entry, where line breaks
%                      and line breaks and line breaks have to occur\\
%    10 &  1  &  1  &  and here is a long entry, where line breaks
%                      and line breaks and line breaks have to occur\\
%    11 &  1  &  1  &  and here is a long entry, where line breaks
%                      and line breaks and line breaks have to occur\\
%    12 &  1  &  1  &  here is a relative short entry \\
%    13 &  1  &  1  &  and here is a long entry, where line breaks
%                      and line breaks and line breaks have to occur\\
%    14 &  1  &  1  &  and here is a long entry, where line breaks
%                      and line breaks and line breaks have to occur\\
%    15 &  1  &  1  &  and here is a long entry, where line breaks
%                      and line breaks and line breaks have to occur\\
%    16 &  1  &  1  &  and here is a long entry, where line breaks
%                      and line breaks and line breaks have to occur\\
%    17 &  1  &  1  &  and here is a long entry, where line breaks
%                      and line breaks and line breaks have to occur\\
%    18 &  1  &  1  &  and here is a long entry, where line breaks
%                      and line breaks and line breaks have to occur\\
%    \end{supertabular}
%    \end{center}
%
%    Here is the same table again, but this time using the
%    \Lenv{supertabular*} environment and stretching the table to the
%    full width of the text. 
%
%    \begin{center}
%    \tablelasttail{\hline\hline}
%    \topcaption{This table should also be split accross pages.}
%    \renewcommand{\arraystretch}{1.5}
%    \small
%    \begin{supertabular*}{\textwidth}%
%                         {| r@{\extracolsep{6.5mm plus 1fil}}|%
%                            r@{\extracolsep{5.5mm plus 0.5fil}}|%
%                            r@{\extracolsep{0mm plus 0.1fil}}%
%                            p{5cm}|}
%    1  &  1  &  1  &  \tbsp here is a relative short entry \\
%    2  &  1  &  1  &  and here is a long entry, where line breaks
%                      and line breaks and line breaks have to occur\\
%    3  &  1  &  1  &  and here is a long entry, where line breaks
%                      and line breaks and line breaks have to occur\\
%    4  &  1  &  1  &  and here is a long entry, where line breaks
%                      and line breaks and line breaks have to occur\\
%    5  &  1  &  1  &  here is a relative short entry \\
%    6  &  1  &  1  &  and here is a long entry, where line breaks
%                      and line breaks and line breaks have to occur\\
%    7  &  1  &  1  &  and here is a long entry, where line breaks
%                      and line breaks and line breaks have to occur\\
%    8  &  1  &  1  &  and here is a long entry, where line breaks
%                      and line breaks and line breaks have to occur\\
%    9  &  1  &  1  &  and here is a long entry, where line breaks
%                      and line breaks and line breaks have to occur\\
%    10 &  1  &  1  &  and here is a long entry, where line breaks
%                      and line breaks and line breaks have to occur\\
%    11 &  1  &  1  &  and here is a long entry, where line breaks
%                      and line breaks and line breaks have to occur\\
%    12 &  1  &  1  &  here is a relative short entry \\
%    13 &  1  &  1  &  and here is a long entry, where line breaks
%                      and line breaks and line breaks have to occur\\
%    14 &  1  &  1  &  and here is a long entry, where line breaks
%                      and line breaks and line breaks have to occur\\
%    15 &  1  &  1  &  and here is a long entry, where line breaks
%                      and line breaks and line breaks have to occur\\
%    16 &  1  &  1  &  and here is a long entry, where line breaks
%                      and line breaks and line breaks have to occur\\
%    17 &  1  &  1  &  and here is a long entry, where line breaks
%                      and line breaks and line breaks have to occur\\
%    18 &  1  &  1  &  and here is a long entry, where line breaks
%                      and line breaks and line breaks have to occur\\
%    \end{supertabular*}
%    \end{center}
%
%  \MakeShortVerb{\|}
%
%  \section{Known problems}
%
%    \begin{itemize}
%    \item When a float occurs on the same page as the start of a
%      supertabular you can expect unexpected results. 
%
%      When the float was defined on the same page you might end up
%      with the first part of the supertabular on a page by its own. 
%
%    \item You should not use the supertabular \emph{inside} a
%      floating-environment such as \texttt{table} as this will result
%      in \TeX\ trying to put the whole supertabular on \emph{one}
%      page. 
%
%    \item In some instances you might still end up with overfull
%      |\vbox| messages. 
%
%    \item Sometimes the last page of the supertabular contains just
%       an empty head an tail. 
%    \end{itemize}
%  \StopEventually{}
%
%  \section{The Implementation}
%
%    \begin{macrocode}
%<*package>
\newcount\c@tracingst
\DeclareOption{errorshow}{\c@tracingst\z@}
\DeclareOption{pageshow}{\c@tracingst\tw@}
\DeclareOption{debugshow}{\c@tracingst5\relax}
\ProcessOptions
%    \end{macrocode}
%
% \begin{macro}{\topcaption}
% \begin{macro}{\bottomcaption}
%    The user-commands |\topcaption| and |\bottomcaption| set the
%    flag |@topcaption| to determine where to put the
%    tablecaption. The default is to put the caption on the top of
%    the table 
%    \begin{macrocode}
\newif\if@topcaption \@topcaptiontrue
\def\topcaption{\@topcaptiontrue\tablecaption}
\def\bottomcaption{\@topcaptionfalse\tablecaption}
%    \end{macrocode}
% \end{macro}
% \end{macro}
%
% \begin{macro}{\tablecaption}
%    This command has to function exactly like |\caption| does, except
%    it has to store its argument (and the optional argument) for
%    later processing \emph{within} the supertabular environment. 
%
%    \begin{macrocode}
\long\def\tablecaption{%
  \refstepcounter{table}\@dblarg{\@xtablecaption}}
\long\def\@xtablecaption[#1]#2{%
  \long\gdef\@process@tablecaption{\ST@caption{table}[#1]{#2}}}
\global\let\@process@tablecaption\relax
%    \end{macrocode}
% \end{macro}
%
%  \begin{macro}{\ifST@star}
%    This switch is used in the internal macros to remember which
%    kind of environment was started.
%    \begin{macrocode}
\newif\ifST@star
%    \end{macrocode}
%  \end{macro}
%
%  \begin{macro}{\ifST@mp}
%    This switch is used in the internal macros to remember if the
%    tabular should be put into a minipage.
% \changes{v4.1a}{1997/09/18}{Added \cs{ifST@mp} switch}
%    \begin{macrocode}
\newif\ifST@mp
%    \end{macrocode}
%  \end{macro}
%
%  \begin{macro}{\ST@wd}
%    For the \Lenv{supertabular*} environment it is necessary to
%    store the intended width of the tabular.
%    \begin{macrocode}
\newdimen\ST@wd
%    \end{macrocode}
%  \end{macro}
%
%  \begin{macro}{\ST@rightskip}
% \changes{v4.1a}{1997/09/18}{Dimen register added}
%  \begin{macro}{\ST@leftskip}
% \changes{v4.1a}{1997/09/18}{Dimen register added}
%  \begin{macro}{\ST@parfillskip}
% \changes{v4.1a}{1997/09/18}{Dimen register added}
%    For the \Lenv{mpsupertabular} environments we need special
%    versions of |\leftskip|, |\rightskip| and |\parfillskip|.
%    \begin{macrocode}
\newskip\ST@rightskip
\newskip\ST@leftskip 
\newskip\ST@parfillskip
%    \end{macrocode}
%  \end{macro}
%  \end{macro}
%  \end{macro}
%
%  \begin{macro}{\ST@caption}
%    This is a redefinition of LaTeX's |\@caption|, |\@makecaption| is
%    called within a group so as not to return to |\normalsize|
%    globally. also a fix is made for the `feature' of the
%    |\@makecaption| of the document class \cls{article} and friends
%    that a caption \textbf{always} gets a |\vskip 10pt| at the top
%    and \textbf{none} at the bottom. If a user wants to precede his
%    table with a caption this results in a collision. 
%
%    \begin{macrocode}
\long\def\ST@caption#1[#2]#3{\par%
  \addcontentsline{\csname ext@#1\endcsname}{#1}%
                  {\protect\numberline{%
                      \csname the#1\endcsname}{\ignorespaces #2}}
  \begingroup
    \@parboxrestore
    \normalsize
    \if@topcaption \vskip -10\p@ \fi
    \@makecaption{\csname fnum@#1\endcsname}{\ignorespaces #3}\par
    \if@topcaption \vskip 10\p@ \fi
  \endgroup}
%    \end{macrocode}
%  \end{macro}
%
%  \begin{macro}{\tablehead}
% \changes{v4.0a}{1996/11/28}{Locally reset \cs{}\cs{} to \cs{cr}}
%  \begin{macro}{\tablefirsthead}
%    |\tablehead| activates the new tabular |\cr| commands.
% \changes{v4.0i}{1997/09/18}{Don't reset \cs{}\cs{} to \cs{cr}, but
%    to \cs{@tabularcr}} 
% \changes{v4.1b}{1997/10/08}{Not \cs{@tabularcr} but
%    \cs{org@tabularcr}}
%    \begin{macrocode}
\newcommand\tablehead[1]{%
  \gdef\@tablehead{%
  \noalign{%
      \global\let\@savcr=\\
      \global\let\\=\org@tabularcr}%
    #1%
    \noalign{\global\let\\=\@savcr}}}
\tablehead{}
\newcommand\tablefirsthead[1]{\gdef\@table@first@head{#1}}
%    \end{macrocode}
%  \end{macro}
%  \end{macro}
%
%  \begin{macro}{\tabletail}
%  \begin{macro}{\tablelasttail}
%    If the user uses an extra amount of tabular-data (like
%    |\multicolumn|) in |\tabletail| \TeX\ starts looping because of
%    the definition of |\ST@cr|. So make |\\| act just like a
%    |\@tabularcr| inside this tail to prevent the loop.  Save and
%    restore the value of |\\| 
%
% \changes{v4.0i}{1997/09/18}{Don't reset \cs{}\cs{} to \cs{cr}, but
%    to \cs{@tabularcr}} 
% \changes{v4.1b}{1997/10/08}{Not \cs{@tabularcr} but
%    \cs{org@tabularcr}}
%    \begin{macrocode}
\newcommand\tabletail[1]{%
  \gdef\@tabletail{%
    \noalign{%
      \global\let\@savcr=\\
      \global\let\\=\org@tabularcr}%
    #1%
    \noalign{\global\let\\=\@savcr}}}
\tabletail{}
\newcommand\tablelasttail[1]{\gdef\@table@last@tail{#1}}
%    \end{macrocode}
%  \end{macro}
%  \end{macro}
%
%  \begin{macro}{\sttraceon}
% \changes{v3.7b}{1994/05/16}{Added macro}
%  \begin{macro}{\sttraceoff}
% \changes{v3.7b}{1994/05/16}{Added macro}
%    There now is a possiblity to follow the decisions supertabular
%    makes about breaking the tabular. This has to be enabled when
%    converting this file with \texttt{docstrip} to a \texttt{.sty}
%    file. 
%    \begin{macrocode}
\newcommand\sttraceon{\c@tracingst5\relax}
\newcommand\sttraceoff{\c@tracingst\z@}
%    \end{macrocode}
%  \end{macro}
%  \end{macro}
%
%  \begin{macro}{\ST@trace}
%    A macro that gets the trace message as its argument
%    \begin{macrocode}
\newcommand\ST@trace[2]{%
  \ifnum\c@tracingst>#1\relax
    \GenericWarning
      {(supertabular)\@spaces\@spaces}
      {Package supertabular: #2}%
  \fi
  }
%    \end{macrocode}
%  \end{macro}
%
%  \begin{macro}{\ST@pageleft}
% \changes{v3.7b}{1994/05/16}{Renamed from \cs{maxsize}}
% \changes{v4.0a}{1996/11/28}{Renamed from \cs{page@left}}
%    This register holds the estimate of the amount of space left over
%    on the current page. This is used in the decision when to start a
%    new page.
%    \begin{macrocode}
\newdimen\ST@pageleft
%    \end{macrocode}
%  \end{macro}
%
%  \begin{macro}{\shrinkheight}
% \changes{v4.0a}{1996/11/28}{New command}
% \changes{v4.0h}{1997/05/20}{This command should use \cs{advance} but
%    didn't...} 
%    A command to diminish the value of |\ST@pageleft| if necessary.
%    \begin{macrocode}
\newcommand*\shrinkheight[1]{%
  \noalign{\global\advance\ST@pageleft-#1\relax}}
%    \end{macrocode}
%  \end{macro}
%
%  \begin{macro}{\setSTheight}
% \changes{v4.0h}{1997/05/10}{New command}
%    A command to set the value of |\ST@pageleft| if necessary.
%    \begin{macrocode}
\newcommand*\setSTheight[1]{%
  \noalign{\global\ST@pageleft=#1\relax}}
%    \end{macrocode}
%  \end{macro}
%
%  \begin{macro}{\ST@headht}
%  \begin{macro}{\ST@tailht}
%    The register |ST@headht| will hold the height of the first head
%    of a \Lenv{supertabular} environment; the register |\ST@tailht|
%    will hold the height of table tail (if any)
%    \begin{macrocode}
\newdimen\ST@headht
\newdimen\ST@tailht
%    \end{macrocode}
%  \end{macro}
%  \end{macro}
%
%  \begin{macro}{\ST@pagesofar}
%    The register |\ST@pagesofar| is used to store the estimate of the
%    amount of page already filled up.
%    \begin{macrocode}
\newdimen\ST@pagesofar
%    \end{macrocode}
%  \end{macro}
%
%  \begin{macro}{\ST@pboxht}
%    The measured (total) height  of a parbox-argument
%    \begin{macrocode}
\newdimen\ST@pboxht
%    \end{macrocode}
%  \end{macro}
%
% \changes{v4.0b}{1997/02/04}{Removed the use of \cs{ST@pboxcorr},
%    correction seems to be no longer necessary}
%
%  \begin{macro}{\ST@lineht}
%  \begin{macro}{\ST@stretchht}
% \changes{v4.0g}{1997/04/12}{Dimension register added}
%  \begin{macro}{\ST@prevht}
% \changes{v4.0g}{1997/04/12}{Dimension register added}
%    The estimated height of a normal line is stored in
%    |\ST@lineht|. The dimension register |\ST@stretchht| is used to
%    store the difference between the `normal' line height and the
%    line height when |\arraystretch| has a non-standard value. This
%    is used in the case where p-box entries are added to the
%    tabular. The dimension register |\ST@prevht| is use to store the
%    height of the previous line to use it as an estimate for the
%    height of the next line. This is needed for a better estimate of
%    when to break the tabular. 
%    \begin{macrocode}
\newdimen\ST@lineht
\newdimen\ST@stretchht
\newdimen\ST@prevht
%    \end{macrocode}
%  \end{macro}
%  \end{macro}
%  \end{macro}
%
%  \begin{macro}{\ST@toadd}
%    When a tabular row is ended with |\\[...]| we need to temporarily
%    store the optional argument in |\ST@toadd|.
%    \begin{macrocode}
\newdimen\ST@toadd
%    \end{macrocode}
%  \end{macro}
%
%  \begin{macro}{\ST@dimen}
%    A private scratch dimension register.
%    \begin{macrocode}
\newdimen\ST@dimen
%    \end{macrocode}
%  \end{macro}
%
%  \begin{macro}{\ST@pbox}
%    A box register to temporarily store the contents of a parbox.
%    \begin{macrocode}
\newbox\ST@pbox
%    \end{macrocode}
%  \end{macro}
%
%  \begin{macro}{\ST@tabularcr}
%  \begin{macro}{\ST@xtabularcr}
%  \begin{macro}{\ST@argtabularcr}
%    These are redefinitions of |\@tabularcr| and |\@xtabularcr|. This
%    is needed to include |\ST@cr| in the definition of
%    |\@xtabularcr|. 
%
%    All redefined macros have names that are similar to the original
%    names, except with a leading 'ST'
%    \begin{macrocode}
\def\ST@tabularcr{%
  {\ifnum0=`}\fi
  \@ifstar{\ST@xtabularcr}{\ST@xtabularcr}}
\def\ST@xtabularcr{%
  \@ifnextchar[%]
    {\ST@argtabularcr}%
    {\ifnum0=`{\fi}\cr\ST@cr}}
%    \end{macrocode}
%  \end{macro}
%  \end{macro}
%
%    \begin{macrocode}
\def\ST@argtabularcr[#1]{%
  \ifnum0=`{\fi}%
  \ifdim #1>\z@
    \unskip\ST@xargarraycr{#1}
  \else 
    \ST@yargarraycr{#1}%
  \fi}
%    \end{macrocode}
%  \end{macro}
%
%  \begin{macro}{\ST@xargarraycr}
%  \begin{macro}{\ST@yargarraycr}
%    In this case we need to copy the value of the optional argument
%    of |\\| in our private register |\ST@toadd|.
%    \begin{macrocode}
\def\ST@xargarraycr#1{%
  \@tempdima #1\advance\@tempdima \dp \@arstrutbox
  \vrule \@height\z@ \@depth\@tempdima \@width\z@ \cr
  \noalign{\global\ST@toadd=#1}\ST@cr}
%    \end{macrocode}
%  \end{macro}
%
%    Here we need to insert |\ST@cr|
%    \begin{macrocode}
\def\ST@yargarraycr#1{%
  \cr\noalign{\vskip #1\global\ST@toadd=#1}\ST@cr}
%    \end{macrocode}
%  \end{macro}
%
%  \begin{macro}{\ST@startpbox}
%    The macros that deal with parbox columns need to be redefined,
%    because we need to know the size of the parbox.
% \changes{v4.0b}{1997/02/04}{Removed use of \cs{ST@pboxcorr}}
%    \begin{macrocode}
\def\ST@startpbox#1{%
%    \end{macrocode}
%    To achieve our goal we need to save the text in box.
%    \begin{macrocode}
  \setbox\ST@pbox\vtop\bgroup\hsize#1\@arrayparboxrestore}
%    \end{macrocode}
%  \end{macro}
%
%  \begin{macro}{\ST@astartpbox}
%    Our version of |\@astartpbox|.
% \changes{v4.0b}{1997/02/04}{Removed use of \cs{ST@pboxcorr}}
%    \begin{macrocode}
\def\ST@astartpbox#1{%
  \bgroup\hsize#1%
  \setbox\ST@pbox\vtop\bgroup\hsize#1\@arrayparboxrestore}
%    \end{macrocode}
%  \end{macro}
%
%  \begin{macro}{\ST@endpbox}
%  \begin{macro}{\ST@aendpbox}
% \changes{v4.0a}{1996/11/30}{Made definitions up to date with
%    \file{latex.ltx} (1996/06/01)} 
%    Our version of |\@endpbox| and |\@aendpbox|.
%    \begin{macrocode}
\def\ST@endpbox{%
  \@finalstrut\@arstrutbox\par\egroup
  \ST@dimen=\ht\ST@pbox
  \advance\ST@dimen by \dp\ST@pbox
  \ifnum\ST@pboxht<\ST@dimen
    \global\ST@pboxht=\ST@dimen
  \fi
  \ST@dimen=\z@
  \box\ST@pbox\hfil}
%    \end{macrocode}
%    
%    \begin{macrocode}
\def\ST@aendpbox{%
  \@finalstrut\@arstrutbox\par\egroup
  \ST@dimen=\ht\ST@pbox
  \advance\ST@dimen by \dp\ST@pbox
  \ifnum\ST@pboxht<\ST@dimen
    \global\ST@pboxht=\ST@dimen
  \fi
  \ST@dimen=\z@
  \unvbox\ST@pbox\egroup\hfil}
%    \end{macrocode}
%  \end{macro}
%  \end{macro}
%
% \begin{macro}{\estimate@lineht}
%    Estimates the height of normal line taking |\arraystretch| into
%    account. Also computes the difference between a normal line and a
%    `stretched' one.
% \changes{v4.0b}{1997/02/04}{Removed use of \cs{ST@pboxcorr}}
% \changes{v4.0g}{1997/04/12}{Added the computation of
%    \cs{ST@stretchht}} 
%    \begin{macrocode}
\def\estimate@lineht{%
  \ST@lineht=\arraystretch \baslineskp
  \global\advance\ST@lineht by 1\p@
  \ST@stretchht\ST@lineht\advance\ST@stretchht-\baslineskp
  \ifdim\ST@stretchht<\z@\ST@stretchht\z@\fi
  \ST@trace\tw@{Average line height: \the\ST@lineht}%
  \ST@trace\tw@{Stretched line height: \the\ST@stretchht}%
  }
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\@calfirstpageht}
% \changes{v3.7a}{1993/04/05}{Renamed from \cmd\calpage}
%    Estimates the space left on the current page and decides whether
%    the tabular can be started on this page or on a new page.
%    \begin{macrocode}
\def\@calfirstpageht{%
  \ST@trace\tw@{Calculating height of tabular on first page}%
%    \end{macrocode}
%    The \TeX\ register |\pagetotal| contains the height of the page
%    sofar, the \LaTeX\ register |\@colroom| contains the height of
%    the column.
%    \begin{macrocode}
  \global\ST@pagesofar\pagetotal
  \global\ST@pageleft\@colroom
  \ST@trace\tw@{Height of text = \the\pagetotal; \MessageBreak
                Height of page = \the\ST@pageleft}%
%    \end{macrocode}
%    When we are in twocolumn mode \TeX\ may still be collecting
%    material for the first column although there seems to be no space
%    left. In this case we have to check against two times |\ST@pageleft|.
%    \begin{macrocode}
  \if@twocolumn
    \ST@trace\tw@{two column mode}%
    \if@firstcolumn
     \ST@trace\tw@{First column}%
      \ifnum\ST@pagesofar > \ST@pageleft 
        \global\ST@pageleft=2\ST@pageleft
        \ifnum\ST@pagesofar > \ST@pageleft
          \newpage\@calnextpageht
          \ST@trace\tw@{starting new page}%
        \else
%    \end{macrocode}
%    In this case we're in the second column, so we have to compensate
%    for the material in the first column.
%    \begin{macrocode}
          \ST@trace\tw@{Second column}%
          \global\advance\ST@pageleft -\ST@pagesofar
          \global\advance\ST@pageleft -\@colroom
        \fi
%    \end{macrocode}
%    When |\ST@pagesofar| is smaller than |\ST@pageleft| \TeX\ is
%    still collecting material for the first column, so we can start a
%    new tabular environment like we do on a single column page.
% \changes{v4.0i}{1997/09/17}{Added initialisation for the case where
%    the first column isn't full yet} 
%    \begin{macrocode}
      \else
        \global\advance\ST@pageleft by -\ST@pagesofar
        \global\ST@pagesofar\z@
      \fi
    \else
%    \end{macrocode}
%    When we end up here, \TeX\ has already decided it had enough
%    material for the first column and is building the second column.
% \changes{v4.1a}{1997/09/27}{Added initialisation for 2nd column of
%    twocolumn mode} 
%    \begin{macrocode}
      \ST@trace\tw@{Second column}
      \ifnum\ST@pagesofar > \ST@pageleft
        \ST@trace\tw@{starting new page}%
        \newpage\@calnextpageht
      \else
        \global\advance\ST@pageleft by -\ST@pagesofar
        \global\ST@pagesofar\z@
      \fi
    \fi
  \else
%    \end{macrocode}
%    In one column mode there is a simple decision.
%    \begin{macrocode}
    \ST@trace\tw@{one column mode}%
    \ifnum\ST@pagesofar > \ST@pageleft
      \ST@trace\tw@{starting new page}%
      \newpage\@calnextpageht
%    \end{macrocode}
%    When we are not starting a new page subtract the size of the
%    material already on it from the available space.
%    \begin{macrocode}
    \else
      \global\advance\ST@pageleft by -\ST@pagesofar
      \global\ST@pagesofar\z@
    \fi
  \fi
  \ST@trace\tw@{Available height: \the\ST@pageleft}%
%    \end{macrocode}
%    Now we need to know the height of the head of the table. In order
%    to measure this we typeset it in a normal \Lenv{tabular}
%    environment.
%    \begin{macrocode}
  \ifx\@@tablehead\@empty
    \ST@headht=\z@
  \else
    \setbox\@tempboxa=\vbox{\@arrayparboxrestore
      \ST@restore
      \expandafter\tabular\expandafter{\ST@tableformat}%
      \@@tablehead\endtabular}%
    \ST@headht=\ht\@tempboxa\advance\ST@headht\dp\@tempboxa
  \fi
  \ST@trace\tw@{Height of head: \the\ST@headht}%
%    \end{macrocode}
%    To decide when to start a new page, we need to know the vertical
%    size of the tail of the table.
%    \begin{macrocode}
  \ifx\@tabletail\@empty
    \ST@tailht=\z@
  \else
    \setbox\@tempboxa=\vbox{\@arrayparboxrestore
      \ST@restore
      \expandafter\tabular\expandafter{\ST@tableformat}
        \@tabletail\endtabular}
    \ST@tailht=\ht\@tempboxa\advance\ST@tailht\dp\@tempboxa
  \fi
%    \end{macrocode}
%    We add the average height of a line to this because when we
%    decide to continue the tabular we need to have enough space left
%    for one line and the tail.
%    \begin{macrocode}
  \advance\ST@tailht by \ST@lineht
  \ST@trace\tw@{Height of tail: \the\ST@tailht}%
  \ST@trace\tw@{Maximum height of tabular: \the\ST@pageleft}%
  \@tempdima\ST@headht
%    \end{macrocode}
% \changes{v4.0b}{1997/02/04}{Base the decision whether to start on a
%    new page on the total of headheight, tailht and lineht}
%    Now we decide whether we can continue on the current page or
%    whether we need to start on a new page. We assume that the
%    minimum height of a tabular is the height of the head, the tail
%    and one line of data. If that doesn't fit a new page is started.
%    \begin{macrocode}
  \advance\@tempdima\ST@lineht
  \advance\@tempdima\ST@tailht
  \ST@trace\tw@{Minimum height of tabular: \the\@tempdima}%
  \ifnum\@tempdima>\ST@pageleft
    \ST@trace\tw@{starting new page}%
    \newpage\@calnextpageht
  \fi
}
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\@calnextpageht}
% \changes{v3.7a}{1993/04/05}{Macro added}
% \changes{v4.0b}{1997/02/04}{Removed use of \cs{ST@pboxcorr}}
%    This calculates the maximum height of the tabular on all
%    subsequent pages of the supertabular environment.
%    \begin{macrocode}
\def\@calnextpageht{%
  \ST@trace\tw@{Calculating height of tabular on next page}%
  \global\ST@pageleft\@colroom
  \global\ST@pagesofar=\z@
  \ST@trace\tw@{Maximum height of tabular: \the\ST@pageleft}%
  }
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\x@supertabular}
%    The body of the beginning of both environments is stored in a
%    single macro as the code is shared.
%    \begin{macrocode}
\def\x@supertabular{%
%    \end{macrocode}
%    First save the original definition of |\tabular| and then make it
%    point to |\inner@tabular|. This is done to enable supertabular
%    cells to contain a \Lenv{tabular} environment without getting
%    unexpected results when the \Lenv{supertabular} would be split
%    accross this inner \Lenv{tabular} environment.
% \changes{v4.0d}{1997/03/06}{Save definition of \cs{tabular} and
%    \cs{tabular*}} 
%    \begin{macrocode}
  \let\org@tabular\tabular
  \let\tabular\inner@tabular
%    \end{macrocode}
%    The same needs to be done for the \Lenv{tabular*}
%    environment. The coding is slightly more verbose.
%    \begin{macrocode}
  \expandafter\let
    \csname org@tabular*\expandafter\endcsname
    \csname tabular*\endcsname
  \expandafter\let\csname tabular*\expandafter\endcsname
    \csname inner@tabular*\endcsname
%    \end{macrocode}
%    If the caption should come at the top we insert it here.
%    \begin{macrocode}
  \if@topcaption \@process@tablecaption \fi
%    \end{macrocode}
%    Save the original definition of |\\|.
%    \begin{macrocode}
  \global\let\@oldcr=\\
%    \end{macrocode}
%    Save the current value of |\baselineskip|, as we need it in the
%    calculation of the average height of a line. 
%    \begin{macrocode}
  \def\baslineskp{\baselineskip}%
%    \end{macrocode}
%    We have to check whether \texttt{array.sty} was loaded, because
%    some of the internal macros have different names.
%    \begin{macrocode}
  \ifx\undefined\@classix
%    \end{macrocode}
%    Save old |\@tabularcr| and insert the definition of
% \changes{v4.1c}{1997/11/07}{For standard \LaTeX\ we need to change
%    \cs{@@startpbox}, \emph{not} \cs{@startpbox}}
%    |\@stabularcr|. 
%    \begin{macrocode}
    \let\org@tabularcr\@tabularcr
    \let\@tabularcr\ST@tabularcr
%    \end{macrocode}
%    Activate the new parbox algorithm.
%    \begin{macrocode}
    \let\org@startpbox=\@startpbox
    \let\org@endpbox=\@endpbox
    \let\@@startpbox=\ST@startpbox
    \let\@@endpbox=\ST@endpbox
  \else
%    \end{macrocode}
%    When \texttt{array.sty} was loaded things are a bit different.
%    \begin{macrocode}
    \let\org@tabularcr\@arraycr
    \let\@arraycr\ST@tabularcr
    \let\org@startpbox=\@startpbox
    \let\org@endpbox=\@endpbox
    \let\@startpbox=\ST@astartpbox
    \let\@endpbox=\ST@aendpbox
  \fi
%    \end{macrocode}
%
%    Check if the head of the table should be different for the first
%    and subsequent pages.
%    \begin{macrocode}
  \ifx\@table@first@head\undefined
    \let\@@tablehead=\@tablehead
  \else
    \let\@@tablehead=\@table@first@head
  \fi
%    \end{macrocode}
%    The first part of a supertabular may be moved on to the next page
%    if it doesn't fit on the current page afterall. Subsequent parts
%    can not be moved; therefore we will have to switch the definition
%    of |\ST@skippart| around.
% \changes{v4.0e}{1997/04/09}{Make sure that only the first part of a
%    supertabular can be moved to the next page.} 
%    \begin{macrocode}
  \let\ST@skippage\ST@skipfirstpart
%    \end{macrocode}
%    Now we can estimate the average line height and the height of the
%    first page of the \Lenv{supertabular}.
% \changes{v4.0i}{1997/09/18}{Added \cs{noindent}}
%    \begin{macrocode}
  \estimate@lineht
  \@calfirstpageht
  \noindent
  }
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\supertabular}
%    We start by looking for an optional argument, which will be duly
%    ignored as it seems to make no sense to try to align a multipage
%    table in the middle...
%    \begin{macrocode}
\def\supertabular{%
  \@ifnextchar[{\@supertabular}%]
               {\@supertabular[]}}
%    \end{macrocode}
%    We can now save the preamble of the tabular in a macro.
%    \begin{macrocode}
\def\@supertabular[#1]#2{%
  \def\ST@tableformat{#2}%
  \ST@trace\tw@{Starting a new supertabular}%
%    \end{macrocode}
%    Then remember that this is not a \textsf{supertabular*}
%    environment.
%    \begin{macrocode}
  \global\ST@starfalse
%    \end{macrocode}
%    Don't use minipages.
% \changes{v4.1a}{1997/09/18}{Added setting of \cs{ST@mp}}
%    \begin{macrocode}
  \global\ST@mpfalse
%    \end{macrocode}
% 
%    Most of the following code is shared between the
%    \Lenv{supertabular} and \Lenv{supertabular*} environments. So to
%    avoid duplication it is stored in a macro.  
%    \begin{macrocode}
  \x@supertabular
%    \end{macrocode}
%    Finally start a normal \textsf{tabular} environment.
% \changes{v4.0d}{1997/03/06}{Use \cs{org@tabular} instead of
%    \cs{tabular}} 
%    \begin{macrocode}
  \expandafter\org@tabular\expandafter{\ST@tableformat}%
  \@@tablehead}
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\supertabular*}
%    We start by looking for the optional argument of the tabular
%    environment. 
%    \begin{macrocode}
\@namedef{supertabular*}#1{%
  \@ifnextchar[{\@nameuse{@supertabular*}{#1}}%
               {\@nameuse{@supertabular*}{#1}[]}%]
  }
%    \end{macrocode}
%    We start by saving the intended width and the preamble of the
%    \textsf{tabular*}.
%    \begin{macrocode}
\@namedef{@supertabular*}#1[#2]#3{%
  \ST@trace\tw@{Starting a new supertabular*}%
  \def\ST@tableformat{#3}%
  \ST@wd=#1\relax
  \global\ST@startrue
  \global\ST@mpfalse
%    \end{macrocode}
%    Now we can call the common code for both environments.
%    \begin{macrocode}
  \x@supertabular
%    \end{macrocode}
%    And we can start a normal \textsf{tabular*} environment.
% \changes{v4.0f}{1997/04/11}{Use \cs{org@tabular*} instead of
%    \cs{tabular*}}
%    \begin{macrocode}
  \expandafter\csname org@tabular*\expandafter\endcsname
  \expandafter{\expandafter\ST@wd\expandafter}%
  \expandafter{\ST@tableformat}%
  \@@tablehead}%
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\mpsupertabular}
% \changes{v4.1a}{1997/09/18}{Added \cs{mpsupertabular}}
%
%    This version of the supertabular environment puts each tabular 
%    into a minipage, thus making footnotes possible.
%    We start by looking for an optional argument, which will be duly
%    ignored as it seems to make no sense to try to align a multipage
%    table in the middle\dots
%    \begin{macrocode}
\def\mpsupertabular{%
  \@ifnextchar[{\@mpsupertabular}%]
               {\@mpsupertabular[]}}
%    \end{macrocode}
%    We can now save the preamble of the tabular in a macro.
%    \begin{macrocode}
\def\@mpsupertabular[#1]#2{%
  \def\ST@tableformat{#2}%
  \ST@trace\tw@{Starting a new mpsupertabular}%
%    \end{macrocode}
%    Then remember that this is not a \textsf{mpsupertabular*}
%    environment.
%    \begin{macrocode}
  \global\ST@starfalse
%    \end{macrocode}
%
%    And remember to close the minipage later.
%    \begin{macrocode}
  \global\ST@mptrue
%    \end{macrocode}
%
%    Since we are about to start a minipage of |\columnwidth| the 
%    horizontal alignment will no longer work. We have to remember the 
%    values and restore them inside the minipage.
%    \begin{macrocode}
  \ST@rightskip \rightskip
  \ST@leftskip \leftskip
  \ST@parfillskip \parfillskip
%    \end{macrocode}
%
%    Most of the following code is shared between the
%    \Lenv{mpsupertabular} and \Lenv{mpsupertabular*} environments. So
%    to avoid duplication it is stored in a macro.
%    \begin{macrocode}
  \x@supertabular
%    \end{macrocode}
%    Finally start a normal \textsf{tabular} environment.
% \changes{v4.1a}{1997/09/18}{Open minipage and adjust skips}
%    \begin{macrocode}
  \minipage{\columnwidth}%
  \parfillskip\ST@parfillskip
  \rightskip \ST@rightskip 
  \leftskip \ST@leftskip 
  \noindent\expandafter\org@tabular\expandafter{\ST@tableformat}%
  \@@tablehead}
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\mpsupertabular*}
% \changes{v4.1a}{1997/09/18}{Added \cs{mpsupertabular*}}
%
%    We start by looking for the optional argument of the tabular
%    environment. 
%    \begin{macrocode}
\@namedef{mpsupertabular*}#1{%
  \@ifnextchar[{\@nameuse{@mpsupertabular*}{#1}}%
               {\@nameuse{@mpsupertabular*}{#1}[]}%]
  }
%    \end{macrocode}
%    Now we can save the intended width and the preamble of the
%    \textsf{tabular*}.
%    \begin{macrocode}
\@namedef{@mpsupertabular*}#1[#2]#3{%
  \ST@trace\tw@{Starting a new mpsupertabular*}%
  \def\ST@tableformat{#3}%
  \ST@wd=#1\relax
  \global\ST@startrue
  \global\ST@mptrue
  \ST@rightskip \rightskip
  \ST@leftskip \leftskip
  \ST@parfillskip \parfillskip
%    \end{macrocode}
% 
%    Then we can call the common code for both environments.
%    \begin{macrocode}
  \x@supertabular
%    And we can start a normal \textsf{tabular*} environment.
%    \begin{macrocode}
  \minipage{\columnwidth}%
  \parfillskip\ST@parfillskip
  \rightskip \ST@rightskip 
  \leftskip \ST@leftskip 
  \noindent\expandafter\csname org@tabular*\expandafter\endcsname
  \expandafter{\expandafter\ST@wd\expandafter}%
  \expandafter{\ST@tableformat}%
  \@@tablehead}%
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\endsupertabular}
% \begin{macro}{\endsupertabular*}
%    This closes the environments \Lenv{supertabular} and
%    \Lenv{supertabular*}. 
%    \begin{macrocode}
\def\endsupertabular{%
  \ifx\@table@last@tail\undefined
    \@tabletail
  \else
    \@table@last@tail
  \fi
  \csname endtabular\ifST@star*\fi\endcsname
%    \end{macrocode}
%    Restore the original definition of |\@tabularcr|
%    \begin{macrocode}
  \ST@restore
%    \end{macrocode}
%    Check if we have to insert a caption and restore to default
%    behaviour of putting captions at the top.
%    \begin{macrocode}
  \if@topcaption
  \else
    \@process@tablecaption
    \@topcaptiontrue
  \fi
%    \end{macrocode}
%
%    Restore the meaning of |\\| to the one it had before the start
%    of this environment. Also re-initialize some control-sequences
%
% \changes{v4.0h}{1997/05/20}{Added missing \cs{global} commands}
% \changes{v4.1d}{1999/08/07}{No longer make \cs{@table@first@head}
%    and \cs{@table@last@tail} undefined}
%    \begin{macrocode}
  \global\let\\\@oldcr
  \global\let\@process@tablecaption\relax
  \ST@trace\tw@{Ended a supertabular\ifST@star*\fi}%
  }
%    \end{macrocode}
%
%    The definition of the ending of the \Lenv{supertabular*}
%    environment is simple:
%    \begin{macrocode}
\expandafter\let\csname endsupertabular*\endcsname\endsupertabular
%    \end{macrocode}
% \end{macro}
% \end{macro}
%
% \begin{macro}{\endmpsupertabular}
% \begin{macro}{\endmpsupertabular*}
%    This closes the environments \Lenv{mpsupertabular} and
%    \Lenv{mpsupertabular*}.
%    \begin{macrocode}
\def\endmpsupertabular{%
  \ifx\@table@last@tail\undefined
    \@tabletail
  \else
    \@table@last@tail
  \fi
  \csname endtabular\ifST@star*\fi\endcsname
  \endminipage
%    \end{macrocode}
%    Restore the original definition of |\@tabularcr|
%    \begin{macrocode}
  \ST@restore
%    \end{macrocode}
%    Check if we have to insert a caption and restore to default
%    behaviour of putting captions at the top.
%    \begin{macrocode}
  \if@topcaption
  \else
    \@process@tablecaption
    \@topcaptiontrue
  \fi
%    \end{macrocode}
%
%    Restore the meaning of |\\| to the one it had before the start
%    of this environment. Also re-initialize some control-sequences
% \changes{v4.1d}{1999/08/07}{No longer make \cs{@table@first@head}
%    and \cs{@table@last@tail} undefined}
%    \begin{macrocode}
  \global\let\\\@oldcr
  \global\let\@process@tablecaption\relax
  \ST@trace\tw@{Ended a mpsupertabular\ifST@star*\fi}%
  }
%    \end{macrocode}
%
%    The definition of the ending of the \Lenv{supertabular*}
%    environment is simple:
%    \begin{macrocode}
\expandafter\let\csname endmpsupertabular*\endcsname\endmpsupertabular
%    \end{macrocode}
% \end{macro}
% \end{macro}
%  \begin{macro}{\ST@restore}
%    This macro restores the original definitions of the macros that
%    handle parbox entries and the macros that handle the end of the
%    row. 
%    \begin{macrocode}
\def\ST@restore{%
  \ifx\undefined\@classix
    \let\@tabularcr\org@tabularcr
  \else
    \let\@arraycr\org@tabularcr
  \fi
  \let\@startpbox\org@startpbox
  \let\@endpbox\org@endpbox
  }
%    \end{macrocode}
%  \end{macro}
%
%  \begin{macro}{\inner@tabular}
%  \begin{macro}{\inner@tabular*}
%    In order to facilitate complete \Lenv{tabular} environments to be
%    in a cell of a \Lenv{supertabular} environment we need to adapt
%    the definition of the orginal environments somewhat. For the
%    inner \Lenv{tabular} a number of definitions needs to be
%    restored. 
% \changes{v4.0i}{1997/09/18}{Added \cs{noindent}}
%    \begin{macrocode}
\def\inner@tabular{%
  \ST@restore
  \let\\\@oldcr
  \noindent
  \org@tabular}
\@namedef{inner@tabular*}{%
  \ST@restore
  \let\\\@oldcr
  \noindent
  \csname org@tabular*\endcsname}
%    \end{macrocode}
%  \end{macro}
%  \end{macro}
%
% \begin{macro}{\ST@cr}
%    This macro is called by each |\\| inside the tabular environment.
%    It updates the estimate of the amount of space left on the
%    current page and starts a new page if necessary.
%    \begin{macrocode}
\def\ST@cr{%
  \noalign{%
    \ifnum\ST@pboxht<\ST@lineht
%    \end{macrocode}
%    If there is a non-empty line, but an empty parbox, then
%    |\ST@pboxht| might be non-zero, but too small thereby breaking
%    the algorithm. Therefore we estimate the height of the line to be
%    |\ST@lineht| in this case.
%    \begin{macrocode}
      \global\advance\ST@pageleft -\ST@lineht
%    \end{macrocode}
%    And we store that fact in |\ST@prevht|.
% \changes{v4.0g}{1997/04/12}{store the height of the previous line in
%    \cs{ST@prevht}} 
%    \begin{macrocode}
      \global\ST@prevht\ST@lineht
    \else
%    \end{macrocode}
%    When the parbox was not empty we take into account its height
%    (plus a bit extra).
% \changes{v4.0g}{1997/04/12}{Also take \cs{ST@stretchht} into
%    account and store the height of the parbox in \cs{ST@prevht}}
%    \begin{macrocode}
     \ST@trace\thr@@{Added par box with height \the\ST@pboxht}%
      \global\advance\ST@pageleft -\ST@pboxht
      \global\advance\ST@pageleft -0.1\ST@pboxht
      \global\advance\ST@pageleft -\ST@stretchht
      \global\ST@prevht\ST@pboxht
      \global\ST@pboxht\z@
    \fi
%    \end{macrocode}
%    |\ST@toadd| is the value of the optional argument of |\\|.
%    \begin{macrocode}
    \global\advance\ST@pageleft -\ST@toadd
    \global\ST@toadd=\z@
    \ST@trace\thr@@{Space left for tabular: \the\ST@pageleft}%
  }
%    \end{macrocode}
%    This line is necessary because the tablehead has to be inserted
%    *after* the following |\if\else\fi|-clause. For this purpose
%    |\ST@next| is used by |\ST@newpage|. But we need to make sure
%    that |\ST@next| is not undefined when |\ST@newpage| is \emph{not}
%    called. In the middle of tableprocessing it shoud be an *empty*
%    macro (*not* |\relax|).%  (15.2.91)
% \changes{v4.1e}{2001/08/21}{Moved the default definition of
%    \cs{ST@next} out of the \cs{if} clause} 
%    \begin{macrocode}
  \noalign{\global\let\ST@next\@empty}%
%    \end{macrocode}
%    When the |\ST@pageleft| has become negative, the last row was so
%    high that the supertabular doesn't fit on the current page after
%    all. In this case we will skip the current page and start at the
%    top of the next one; otherwise \TeX\ will move this part of the
%    table to a new page anyway, probably with a message about an
%    overfull |\vbox|.
%    \begin{macrocode}
  \ifnum\ST@pageleft<\z@
    \ST@skippage
  \else
%    \end{macrocode}
%    When there is not enough space left on the current page, we start
%    a new page. To compute the amount of space needed we use the
%    height of the previous line (|\ST@prevht|) as  an estimation of
%    the height of the next line. If we are processing a
%    \Lenv{mpsupertabular} we need to take the height of the footnotes
%    into account. 
% \changes{v4.0g}{1997/04/12}{Leave room for both \cs{ST@tailht}
%    \emph{and} \cs{ST@prevht}} 
% \changes{v4.1a}{1997/09/19}{Take care of space needed for 
%    footnotes and footnoterule} 
%    \begin{macrocode}
    \noalign{\global\@tempdima\ST@tailht
      \global\advance\@tempdima\ST@prevht
    \ifST@mp
      \ifvoid\@mpfootins\else
        \global\advance\@tempdima\ht\@mpfootins
        \global\advance\@tempdima 3pt
      \fi
    \fi}
    \ifnum\ST@pageleft<\@tempdima
      \ST@newpage
    \fi
  \fi
  \ST@next}
%    \end{macrocode}
% \end{macro}
%
%  \begin{macro}{\ST@skipfirstpart}
% \changes{v4.0d}{1997/03/06}{Added new macro.}
% \changes{v4.0e}{1997/04/09}{Renamed from \cs{ST@skippage}}
%    This macro skips the current page and moves the entire
%    supertabular that has been built up sofar to the next page.
%    \begin{macrocode}
\def\ST@skipfirstpart{%
  \noalign{%
    \ST@trace\tw@{Tabular too high, moving to next page}%
%    \end{macrocode}
%    In order for this to work properly we need to adapt the value of
%    |\ST@pageleft|. When this macro is called it has a negative
%    value. We should add the height of the next page to that
%    (|\@colroom|). From the result the `normal' height of the
%    supertabular should be substracted (|\@colroom| -
%    |\pagetotal|). This could be coded as follows:
%\begin{verbatim}
%      \ST@dimen\@colroom
%      \advance\ST@dimen-\pagetotal
%      \global\advance\ST@pageleft\@colroom
%      \global\advance\ST@pageleft-\ST@dimen
%\end{verbatim}
%    When you examine the code you will note that |\@colroom| is added
%    \emph{and} subtracted. Therefore the code above can be simplified
%    to:
%    \begin{macrocode}
    \global\advance\ST@pageleft\pagetotal
%    \end{macrocode}
%    Then we can set |\ST@pagesofar| to $0$ and start the new page.
%    \begin{macrocode}
    \global\ST@pagesofar\z@
    \newpage
%    \end{macrocode}
%
%    Finally we make sure that this macro can only be executed once
%    for each supertabular by changing the definition of
%    |\ST@skippage|. 
% \changes{v4.0e}{1997/04/09}{Make sure that only the first part of a
%    supertabular can be moved to the next page.} 
%    \begin{macrocode}
    \global\let\ST@skippage\ST@newpage
    }}
%    \end{macrocode}
%  \end{macro}
%
% \begin{macro}{\ST@newpage}
% \changes{v3.7b}{1994/05/16}{Added macro, split off from
%    \cmd\ST@cr}
%    This macro performs the actions necessary to start a new page.
%    \begin{macrocode}
\def\ST@newpage{%
  \noalign{\ST@trace\tw@{Starting new page, writing tail}}%
%    \end{macrocode}
%    Output |\tabletail|, close the tabular environment, close a
%    \Lenv{mnipage} if necessary, output all material and start a
%    fresh new page. 
% \changes{v4.1a}{1997/09/19}{Close minipage if we are in 
%    \Lenv{mpsupertabular}}
%    \begin{macrocode}
  \@tabletail
  \ifST@star
    \csname endtabular*\endcsname
  \else
    \endtabular
  \fi
  \ifST@mp
    \endminipage
  \fi
%    \end{macrocode}
%
%    Then we make sure that the macro |\ST@skippage| can no longer be
%    executed for this supertabular by changing the definition of it.
% \changes{v4.0d}{1997/03/06}{Use \cs{org@tabular} instead of
%    \cs{tabular}} 
% \changes{v4.0e}{1997/04/09}{Make sure that only the first part of a
%    supertabular can be moved to the next page.} 
% \changes{v4.0f}{1997/04/11}{Use \cs{org@tabular*} instead of
%    \cs{tabular*}}
% \changes{v4.0i}{1997/09/18}{Added \cs{noindent}}
% \changes{v4.1a}{1997/09/19}{Open new minipage if we are in 
%    \Lenv{mpsupertabular}}
%    \begin{macrocode}
  \global\let\ST@skippage\ST@newpage
  \newpage\@calnextpageht
  \let\ST@next\@tablehead
  \ST@trace\tw@{writing head}%
  \ifST@mp
    \noindent\minipage{\columnwidth}%
    \parfillskip\ST@parfillskip
    \rightskip \ST@rightskip 
    \leftskip \ST@leftskip 
  \fi
  \noindent
  \ifST@star
    \expandafter\csname org@tabular*\expandafter\endcsname
    \expandafter{\expandafter\ST@wd\expandafter}%
    \expandafter{\ST@tableformat}%
  \else
    \expandafter\org@tabular\expandafter{\ST@tableformat}%
  \fi}
%    \end{macrocode}
% \end{macro}
%
%    \begin{macrocode}
%</package>
%    \end{macrocode}
%
% \Finale
\endinput