summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/supertabular
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2006-01-09 00:49:07 +0000
committerKarl Berry <karl@freefriends.org>2006-01-09 00:49:07 +0000
commit007f67a693e4d031fd3d792df8e4d5f43e2cb2e7 (patch)
tree90d17e00e572ecb1e24764b6f29c80e098b08d29 /Master/texmf-dist/doc/latex/supertabular
parent950209b26f70aa87ed07c54f82a95b6f03b7c3a0 (diff)
doc/latex
git-svn-id: svn://tug.org/texlive/trunk@84 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/supertabular')
-rw-r--r--Master/texmf-dist/doc/latex/supertabular/CATALOG28
-rw-r--r--Master/texmf-dist/doc/latex/supertabular/ChangeLog233
-rw-r--r--Master/texmf-dist/doc/latex/supertabular/MANIFEST8
-rw-r--r--Master/texmf-dist/doc/latex/supertabular/README21
-rw-r--r--Master/texmf-dist/doc/latex/supertabular/supertabular.pdfbin0 -> 159124 bytes
5 files changed, 290 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/supertabular/CATALOG b/Master/texmf-dist/doc/latex/supertabular/CATALOG
new file mode 100644
index 00000000000..d23ab1e3896
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/supertabular/CATALOG
@@ -0,0 +1,28 @@
+Name: supertabular (also called supertab)
+Problems-To: texniek@braams.cistron.nl
+Author: J.L. Braams and T. Jurriens
+Version: 4.1d
+
+Description:
+
+The supertabular bundle defines the environments supertabular,
+supertabular*, mpsupertabular and mpsupertabular*.
+They make it possible to have a tabular that spans multiple pages.
+Each page is its own tabular environment, thus the various parts
+may have different widths.
+The mp-variants put the tabulars that make up the supertabular in
+minipage environments to make it easy to add footnotes to the tabular
+and have them printed on the same page as where the footnotemarker
+occurs.
+
+Keywords: latex, long tables
+
+See-Also: the array package (longtable.sty);
+The LaTeX Companion, by Goossens, Mittelbach and Samarin,
+ISBN 0-201-54199-8.
+
+Address:
+TeXniek
+Kersengaarde 33
+2723 BP Zoetermeer
+The Netherlands
diff --git a/Master/texmf-dist/doc/latex/supertabular/ChangeLog b/Master/texmf-dist/doc/latex/supertabular/ChangeLog
new file mode 100644
index 00000000000..cadcb72935a
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/supertabular/ChangeLog
@@ -0,0 +1,233 @@
+2001-08-21 Johannes Braams (texniek at braams.cistron.nl)
+
+ * supertabular.dtx : The macro \ST@next needs to be defined when
+ \ST@skippage was called. Therefore I moved the default definition
+ to earlier in the code; just before the \if clause after which it
+ is called; possibly defined by \ST@newpage. This problem was
+ reported by Andrew Dorrell (dorrell@research.canon.com.au).
+
+1999-08-08 Johannes Braams (texniek at braams.cistron.nl)
+
+ * supertabular.dtx : No longer re-initialize the internal variable
+ \@table@first@head and \@table@last@tail. This made it impossible
+ to have more than one supertabular in the same document with the
+ exact same appearance of the heads and tail without repeatedly
+ redeclaring the firsthead and/or lasttail. Reported by Christian
+ Matuszewski (matuszew at informatik.uni-halle.de).
+
+Fri Nov 7 20:27:27 1997 Johannes Braams (texniek at braams.cistron.nl)
+
+ * supertabular.dtx : For standard LaTeX we need to change
+ \@@startpbox not \@startpbox. Found by Peter R Wilson
+ (Peter.Wilson@PSS.Boeing.com)
+
+Wed Oct 8 22:35:40 1997 Johannes Braams (texniek at braams.cistron.nl)
+
+ * supertabular.dtx: Running the documentation revealed a loop;
+ inside the table tail and head \\ was reset to \@tabularcr instead
+ of to \@@tabularcr (now: \org@tabularcr). First found by Thomas
+ Esser (te at informatik.uni-hannover.de)
+
+Sat Sep 27 21:35:29 1997 Johannes Braams (texniek at braams.cistron.nl)
+
+ * supertabular.dtx: Added the mpsupertabular and mpsupertabular*
+ environments provided by Axel Kielhorn (A.Kielhorn at tu-bs.de);
+ added \noindent in front of all the starts of tabulars and
+ minipages as it seems senseles to have a paragraph indent in front
+ of a large tabularl; fixed a few documentation bugs.
+ The calculation of the available height still missed the case
+ where TeX has already begun the second column.
+
+Thu Sep 18 00:31:55 1997 Johannes Braams (texniek at braams.cistron.nl)
+
+ * supertabular.dtx : The \tablehead and \tabletail commands reset
+ the command \\; they used \cr for it. That should have been
+ \@tabularcr to properly deal with it's optional argument.
+ Found by Axel Kielhorn (A.Kielhorn at tu-bs.de)
+
+Wed Sep 17 23:59:13 1997 Johannes Braams (texniek at braams.cistron.nl)
+
+ * supertabular.dtx : In two column mode the parameters that
+ determine how much space is left on the page were not correctly
+ initialised when TeX hasn't yet filled up the first column
+ completely.
+ Found by Jeffrey Spielberg (jspielberg at infinet-software.com)
+
+Tue May 20 23:46:08 1997 Johannes Braams (texniek at braams.cistron.nl)
+
+ * supertabular.dtx : \shrinkheight didn't shrink the available
+ height for a part of the tabular (as documented); it just *set* it
+ to the value given. Made it perform as documented and added
+ \setSTheight for the former functionality
+ At the end of a supertabular \@table@first@head and
+ \@table@last@tail are undefined; this shoud be done globally.
+ Found by Axel Kielhorn (A.Kielhorn at tu-bs.de)
+
+Sat Apr 12 23:37:33 1997 Johannes Braams (texniek at braams.cistron.nl)
+
+ * supertabular.dtx : Added \ST@stretchht and \ST@prevht to improve
+ decision process. \estimate@lineht now also computes the
+ difference between a normal line height and when \arraystretch is
+ in effect.
+
+Thu Apr 10 23:33:07 1997 Johannes Braams (texniek at braams.cistron.nl)
+
+ * supertabular.dtx: Had to repaire some documentation errors.
+ (found by Thomas Esser (te at informatik.uni-hannover.de))
+
+Wed Apr 9 00:29:36 1997 Johannes Braams (texniek at braams.cistron.nl)
+
+ * supertabular.dtx : Only the first part of a supertabular can be
+ moved to the next page. Therefore we need to change the definition
+ of \ST@skippage in the middle of processing the supertabular data.
+
+
+Thu Mar 6 21:56:18 1997 Johannes Braams (texniek at braams.cistron.nl)
+
+ * supertabular.dtx : Using a tabular environment in the cells of a
+ supertabular gives `interesting' results when the algorithm
+ decides to split the supertabular down the middle of an inner
+ tabular. A number of changes were necessary to make this work.
+ Found by Axel Kielhorn (i0080108 at ws.rz.tu-bs.de)
+
+Thu Feb 20 23:29:18 1997 Johannes Braams (texniek at braams.cistron.nl)
+
+ * supertabular.dtx: Renamed \tableformat into \ST@tableformat
+ because the KOPMA-packages also use \tableformat and therefore
+ clashed with babel.
+ Found by Axel Kielhorn (i0080108 at ws.rz.tu-bs.de)
+
+Tue Feb 4 23:50:50 1997 Johannes Braams (texniek at braams.cistron.nl)
+
+ * supertabular.dtx (section{The Implementation}): Removed the use
+ of the page height correction for p-columns; the current algorithm
+ no longer needs this correction.
+ Fixed the fact that the height of the head and/or tail of a
+ supertabular were counted *twice* when they contain tabular
+ material.
+ Base the decision whether to start a new supertabular on the next
+ page on a calculated minimum height of the table. The minimum is
+ the head, the tail and 1 line of tabular data.
+
+Thu Nov 28 20:38:53 1996 Johannes Braams (texniek at braams.cistron.nl)
+
+ * supertabular.dtx: Started a cleanup of the code, made source
+ file a full fledged .dtx file
+
+ Old change notes from supertabular.doc are saved here:
+%
+%
+% supertabular sty
+% original idea: Theo Jurriens 1988
+% jurriens at fwn.rug.nl P.O Box 800, 9700 AV Groningen
+%
+% revised by: Johannes Braams
+% texniek at braams.cistron.nl TeXniek (NL)
+% \def\fileversion{3.7c}
+% \def\filename{supertabular sty}
+% \def\filedate{1995/10/16}
+%
+% \changes{v3.7c}{1995/10/16}{No space after the argument of
+% supertabular led to a `mysterious' error because of the space
+% delemiting the argument}
+% \changes{v3.7b}{1994/05/16}{Rewrote the page break deciding
+% algorithm again}
+% \changes{v3.7b}{1994/05/16}{Started to convert to dtx format}
+%
+% 05.04.93 - Supertabular didn't work correctly in twocolumn mode.
+% V 3.7a Rewrote the mechanism for establishing the amount of
+% space that supertabular can use. This still needs further
+% thought. The algorithm to compute the places to break
+% the table is still a bit fragile, especially when p{}
+% columns are used.
+% 10.07.92 - Still a problem in the combination of supertabular with array.sty
+% V 3.6h I overlooked the fact that array doesn't use \@tabulacr anymore
+% and it behaves differently with respect to \@startparbox.
+% 03.07.92 - A problem in the combination of supertabular with array.sty
+% V 3.6g It can be solved by removing the \string from \def\tableformat
+% and passing \tableformat expanded to \tabular.
+% 11.02.92 - Bug found by Michael Heissmeier when p{...} is used.
+% V 3.6f A change in LaTeX.tex didn't find its way into supertabular.
+% 11/03/92 JB: The following change didn't find its way into the
+% \@sendpbox command. This caused a difference in linespacing
+% between a supertabular and a normal tabular.
+% \def\@endpbox{\unskip\strut\par\egroup\hfil}
+% % 14 Jan 89: Def of \@endpbox changed from
+% % \def\@endpbox{\par\vskip\dp\@arstrutbox\egroup\hfil}
+% % so vertical spacing works out right if the last line of a `p' entry
+% % has a descender.
+%
+% 01.08.91 - Take height of tabletail into account when computing the
+% V 3.6e maximum tableheight; add tolerance on first (partial) page
+% of the supertabular.
+% 27.06.91 - Cured bug that made the first part of the table one line
+% V 3.6d shorter than the others. Appeared when supertabular was
+% used in a twocolumn environment.
+% 26.06.91 - Made \@process@tablecaption a global macro. Previous caption
+% V 3.6c turned up on a table without one.
+% 27.05.91 - Replaced \clearpage with \newpage to make supertabulars work
+% V 3.6b in a twocolumn environment. This also prevents all floats
+% from being printed.
+% 15.02.91 - Because of the check for the use of tablefirsthead the
+% V 3.6a combination of an \hline in the head and an \hline as the first
+% thing in the data went wrong. The \futurelet in the definition
+% of \hline found \fi instead of \hline, so no \doublerulesep
+% was added.
+% Also had to modify the way the environments were defined.
+% The blank space (from the CR after the argument of \supertabular)
+% has to be gobbled. This can only be done using a construction
+% like \def\command#1 {...}. So removed the use of \newenvironment
+% 04.02.91 - Added the commands \topcaption, \bottomcaption and \tablecaption
+% V 3.6 to include a caption within the supertabular environment. The
+% default behaviour is to put the caption before the actual start
+% of the table.
+% - Also added \tablefirsthead and \tablelasttail to let the
+% user specify a different head for the first page of the table
+% and for consecutive pages as well as different tails for first
+% pages and the last one. If these commands are not used, the
+% default behaviour will be to use the value of \tablehead end
+% \tabletail
+% - Removed the need for the \noalign{\global\let\\=\@stabularcr}
+% commands by storing and resetting \@stabularcr
+%
+% 16.10.90 Added the supertabular* environment that was in an earlier
+% V 3.5 version (2.0) by the original author
+% Reintroduced the version numbering
+%
+% revised by: Gabriele Kruljac
+% kruljac at ds0mpi11 Max-Planck-Institute Stuttgart
+%
+%
+% 06.06.89 Correction: now care is taken of probably existing onecolumn
+% head (title or tables ...) in twocolumn sty.
+%
+% 10.05.89 Correction: the new \\ definition has been added to the
+% begin of each `sub'-tabular
+% Added: algorithm to produce the tabulars in twocolumn style
+%
+% 06.04.89 Correction: put \global statement in \end{supertabular}
+% into \noalign
+%
+% 22.02.89 Correction: restore the original meaning of \\ with
+% \end{supertabular}
+%
+% (Feb 89) The whole algorithm has been changed, so that I can use
+% the most features of a normal tabular:
+% \\ for new line, including \\[#1]
+% p{...} in the preamble ...
+% Account is taken to \baselinestretch and \arraystretch
+% -I'm not counting the lines because of too much rounding errors
+% but instead I add the (estimated) used space in pt.
+% -The tablehead is taken into this algorithm of proofing, so
+% I really know how much space the head uses.
+% -When no p-arg is given I add a variable \midlineheight to
+% calculate the used space. To calculate \midlineheight I
+% take the \baselineskip, which is active when the supertabular
+% starts (\baselineskip includes the \value of \baselinestretch)
+% and multiply it with \arraystretch.
+% -When a p-arg is given the text will be stored in a box. So
+% I know the height I have to add. Also I reduce the maximum
+% pagesize, so that the last parbox on a page can get up to
+% max 4 lines without producing an overfull vbox.
+% -To do so I had to make some additions to LaTeX's tabular
+% commands. These new commands got a leading `s'.
diff --git a/Master/texmf-dist/doc/latex/supertabular/MANIFEST b/Master/texmf-dist/doc/latex/supertabular/MANIFEST
new file mode 100644
index 00000000000..a80fe1b209c
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/supertabular/MANIFEST
@@ -0,0 +1,8 @@
+README - A short introduction
+MANIFEST - A list of files
+CATALOG - An entry for the macro catalog
+supertabular.dtx - The documented version of the code, including a couple
+ of examples of how to use it. Needs supertabular.sty
+ to be available (run latex supertabular.ins first).
+supertabular.dtx - The `printed version´ of supertabular.dtx
+supertabular.ins - A docstrip file to produce the stripped code
diff --git a/Master/texmf-dist/doc/latex/supertabular/README b/Master/texmf-dist/doc/latex/supertabular/README
new file mode 100644
index 00000000000..b17b79ee2fc
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/supertabular/README
@@ -0,0 +1,21 @@
+This is the supertabular bundle. It defines the supertabular and
+supertabular* environments. They make it possible to have a tabular
+that spans multiple pages. Each page is its own tabular environment,
+thus the various parts may have different widths. If that is not what
+you want you should check out longtable.sty, written by David
+Carlisle. It is part of the array bundle.
+
+For a more elaborate description of supertabular and a comparison with
+longtable, see The LaTeX Companion, by Goossens, Mittelbach and
+Samarin, ISBN 0-201-54199-8.
+
+The files contained in this bundle are listed in the file MANIFEST
+
+Supertabular can be used with LaTeX2e as a package.
+
+Copyright (C) 2004 Johannes L. Braams texniek at braams.cistron.nl
+
+This program can be redistributed and/or modified under the terms
+of the LaTeX Project Public License Distributed from CTAN
+archives in directory macros/latex/base/lppl.txt; either
+version 1 of the License, or any later version.
diff --git a/Master/texmf-dist/doc/latex/supertabular/supertabular.pdf b/Master/texmf-dist/doc/latex/supertabular/supertabular.pdf
new file mode 100644
index 00000000000..5567cc7ee03
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/supertabular/supertabular.pdf
Binary files differ