From 007f67a693e4d031fd3d792df8e4d5f43e2cb2e7 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Mon, 9 Jan 2006 00:49:07 +0000 Subject: doc/latex git-svn-id: svn://tug.org/texlive/trunk@84 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/supertabular/CATALOG | 28 +++ Master/texmf-dist/doc/latex/supertabular/ChangeLog | 233 +++++++++++++++++++++ Master/texmf-dist/doc/latex/supertabular/MANIFEST | 8 + Master/texmf-dist/doc/latex/supertabular/README | 21 ++ .../doc/latex/supertabular/supertabular.pdf | Bin 0 -> 159124 bytes 5 files changed, 290 insertions(+) create mode 100644 Master/texmf-dist/doc/latex/supertabular/CATALOG create mode 100644 Master/texmf-dist/doc/latex/supertabular/ChangeLog create mode 100644 Master/texmf-dist/doc/latex/supertabular/MANIFEST create mode 100644 Master/texmf-dist/doc/latex/supertabular/README create mode 100644 Master/texmf-dist/doc/latex/supertabular/supertabular.pdf (limited to 'Master/texmf-dist/doc/latex/supertabular') 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 Binary files /dev/null and b/Master/texmf-dist/doc/latex/supertabular/supertabular.pdf differ -- cgit v1.2.3