summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/tex/latex/ltabptch
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2006-01-12 23:58:19 +0000
committerKarl Berry <karl@freefriends.org>2006-01-12 23:58:19 +0000
commitc84b0c25046baf31ab61cc0a70b5ea4d2b372f58 (patch)
tree91458a1afb71c9ad4de52c6e25eeee907255701f /Master/texmf-dist/tex/latex/ltabptch
parent0275620b6991f1734f9ae601525480e2b00110a8 (diff)
ltabptch
git-svn-id: svn://tug.org/texlive/trunk@1054 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/tex/latex/ltabptch')
-rw-r--r--Master/texmf-dist/tex/latex/ltabptch/ltabptch.sty288
1 files changed, 288 insertions, 0 deletions
diff --git a/Master/texmf-dist/tex/latex/ltabptch/ltabptch.sty b/Master/texmf-dist/tex/latex/ltabptch/ltabptch.sty
new file mode 100644
index 00000000000..15a6d1e94f7
--- /dev/null
+++ b/Master/texmf-dist/tex/latex/ltabptch/ltabptch.sty
@@ -0,0 +1,288 @@
+%% LTabPtch.sty---Uwe L"uck---patch for Longtable.
+\def\filedate{2005/01/10} \def\fileversion{1.74d}
+%% For David Carlisle's Longtable.sty, version 4.11
+%% Fixes tools/3180 (Sebastian Rahtz) and tools/3485:
+%% missing/wrong interline glues above/below table.
+%%
+%% Copyright (C) 2002--2004 Uwe L"uck,
+%% http://www.contact-ednotes.sty.de.vu
+%% --author-maintained.
+%%
+%% Usage, no warranty, distribution as in lppl.txt on CTAN
+%% (macros/latex/base/lppl.txt).
+%%
+%% Loading Longtable.sty with options must be done earlier!
+%%
+\NeedsTeXFormat{LaTeX2e}[1994/05/20] % \CheckCommand
+\ProvidesPackage{ltabptch}[\filedate\space v\fileversion\space
+ Longtable patch for tools/3180, 3485 (ul)]
+%
+% The problem(s):
+% Sebastian Rahtz (tools/3180) observed 2000/03/05 that there be
+% a "spurios blank line" below the longtable. This impression
+% may have been due to two spacing problems:
+% (1) There is \parskip and some interline glue below longtable,
+% while there is no \parskip and no interline glue above
+% (without head as specified by \endhead or \firstendhead)
+% or just \lineskip 0.0pt (with head---\endhead, \endfirsthead).
+% (2) After longtable, \prevdepth is the depth of the last line
+% before the longtable (if there is no head) or the depth of the
+% head (otherwise). So \prevdepth may be 0pt. By contrast, the
+% last table row has depth of at least \dp\@arstrutbox--which
+% should rather matter, and this is 3.6pt or more.
+% --I have reported something like this as tools/3485, not
+% entirely correctly. Details are presented below \endinput.
+%
+% Solution presented:
+% (1) I think there should be \parskip and usual interline glue
+% above, since the same would happen with a table in a center
+% environment (e.g.).
+% \noindent seems to work fatally; moreover, \LT@start's decision
+% whether to enter a new page would ignore \parskip and interline
+% glue still needed.
+% So emulate interline glue calculation according to TeXbook p. 80
+% and add it by \vskip, along with \parskip.
+% (This is rather a hack---a proper correction should perhaps not
+% "emulate" but place the interlineglue changes of \LT@array inside
+% the \vbox \LT@bchunk starts and treat glue between chunks in a
+% new way.)
+% (2) Set \prevdepth to depth of box 0 before the latter is
+% \unvbox'ed (which leaves \prevdepth untouched, TeXbook p. 282)
+% in \endlongtable.
+%
+% I thought David Carlisle would change Longtable according to my
+% suggestions. By e-mail from 2003/04/07 however, he finds it
+% better not to change Longtable, in order not to change layouts
+% of works that have been made using Longtable so far
+% (e-Mail 2003/04/08).
+%
+%% <- TODO: change this when David has changed his mind!
+% By the way:
+% 1.) There are two successive lines in the Longtable code (v4.11)
+% together saying:
+% \prevdepth\z@\global
+% \global\let\LT@setprevdepth\relax
+% Isn't the first \global just a typo?
+% --Yes--this is David Carlisle's answer in his e-mail
+% dating from 2004/05/14.
+% 2.) Couldn't the one-column restriction easily be removed
+% by using \columnwidth instead of \hsize?
+%
+% Patching is to override Longtable.sty:
+\RequirePackage{longtable}[2004/02/01]
+%% TODO: Cf. \CheckCommand below.
+% Load earlier on your own for choosing Longtable options!
+%
+% For (1), we are patching \LT@start, assumed to have been defined
+% as follows (Longtable v4.11; sorry we can no longer handle v3.16
+% through 4.10):
+
+\CheckCommand*{\LT@start}{%
+ \let\LT@start\endgraf
+ \endgraf\penalty\z@\vskip\LTpre
+ \dimen@\pagetotal
+ \advance\dimen@ \ht\ifvoid\LT@firsthead\LT@head\else\LT@firsthead\fi
+ \advance\dimen@ \dp\ifvoid\LT@firsthead\LT@head\else\LT@firsthead\fi
+ \advance\dimen@ \ht\LT@foot
+ \dimen@ii\vfuzz
+ \vfuzz\maxdimen
+ \setbox\tw@\copy\z@
+ \setbox\tw@\vsplit\tw@ to \ht\@arstrutbox
+ \setbox\tw@\vbox{\unvbox\tw@}%
+ \vfuzz\dimen@ii
+ \advance\dimen@ \ht
+ \ifdim\ht\@arstrutbox>\ht\tw@\@arstrutbox\else\tw@\fi
+ \advance\dimen@\dp
+ \ifdim\dp\@arstrutbox>\dp\tw@\@arstrutbox\else\tw@\fi
+ \advance\dimen@ -\pagegoal
+ \ifdim \dimen@>\z@\vfil\break\fi
+ \global\@colroom\@colht
+ \ifvoid\LT@foot\else
+ \advance\vsize-\ht\LT@foot
+ \global\advance\@colroom-\ht\LT@foot
+ \dimen@\pagegoal\advance\dimen@-\ht\LT@foot\pagegoal\dimen@
+ \maxdepth\z@
+ \fi
+ \ifvoid\LT@firsthead\copy\LT@head\else\box\LT@firsthead\fi\nobreak
+%% \nobreak new with Longtable v4.11.
+ \output{\LT@output}}
+%
+% Change it:
+\def\LT@start{%
+ \let\LT@start\endgraf
+ \endgraf\penalty\z@\vskip\LTpre
+ \vskip\parskip %% U.L.
+% I want to add the interline glue before \pagetotal goes to \dimen@.
+% So I move \LT@start's \vsplit here.
+ %% U.L. start:
+ \dimen@ii\vfuzz
+ \vfuzz\maxdimen
+ \setbox\tw@\copy\z@
+ \setbox\tw@\vsplit\tw@ to \ht\@arstrutbox
+ \setbox\tw@\vbox{\unvbox\tw@}%
+ \vfuzz\dimen@ii
+ \ifdim\prevdepth>-\@m\p@
+% First we need the maximum of the heights of \tw@ and head row.
+% A little flaw might be here: I am ignoring \Lt@start's
+% \@arstrutbox concern below, cf. remark there.
+ \@tempskipa % \normalbaselineskip going to enter.
+ \ht\ifvoid\LT@firsthead\LT@head\else\LT@firsthead\fi
+% \typeout{\@tempskipa=\the\@tempskipa}% TEST
+ \@tempskipa-\ifdim\@tempskipa<\ht\tw@\ht\tw@\else\@tempskipa\fi
+% \typeout{\@tempskipa=\the\@tempskipa}% TEST
+ \advance\@tempskipa-\prevdepth
+% \typeout{\string\prevdepth=\prevdepth}% TEST
+% \typeout{\@tempskipa=\the\@tempskipa}% TEST
+ \advance\@tempskipa\normalbaselineskip
+% \typeout{\normallineskiplimit=\the\normallineskiplimit}% TEST
+% \typeout{\@tempskipa=\the\@tempskipa}% TEST
+ \vskip \ifdim\@tempskipa<\normallineskiplimit
+ \normallineskip
+ \else
+ \@tempskipa
+ \fi
+ \fi
+ \nointerlineskip % v1.4 prevent head from adding more
+% % (if only negative) glue.
+% \prevdepth -1000\p@ % Prevent head from adding more glue (v1.3).
+ %% U.L. end.
+ \dimen@\pagetotal
+ \advance\dimen@ \ht\ifvoid\LT@firsthead\LT@head\else\LT@firsthead\fi
+ \advance\dimen@ \dp\ifvoid\LT@firsthead\LT@head\else\LT@firsthead\fi
+ \advance\dimen@ \ht\LT@foot
+% \dimen@ii\vfuzz
+% \vfuzz\maxdimen
+% \setbox\tw@\copy\z@
+% \setbox\tw@\vsplit\tw@ to \ht\@arstrutbox
+% \setbox\tw@\vbox{\unvbox\tw@}%
+% \vfuzz\dimen@ii
+%
+% Remark U.L.: The following four code lines seem strange to me:
+% after all, \tw@ contains \@arstrutbox, doesn't it?
+% And even if not: why should we need room for another \@arstrutbox?
+ \advance\dimen@ \ht
+ \ifdim\ht\@arstrutbox>\ht\tw@\@arstrutbox\else\tw@\fi
+ \advance\dimen@\dp
+ \ifdim\dp\@arstrutbox>\dp\tw@\@arstrutbox\else\tw@\fi
+ \advance\dimen@ -\pagegoal
+ \ifdim \dimen@>\z@\vfil\break\fi
+ \global\@colroom\@colht
+ \ifvoid\LT@foot\else
+ \advance\vsize-\ht\LT@foot
+ \global\advance\@colroom-\ht\LT@foot
+ \dimen@\pagegoal\advance\dimen@-\ht\LT@foot\pagegoal\dimen@
+ \maxdepth\z@
+ \fi
+ \ifvoid\LT@firsthead\copy\LT@head\else\box\LT@firsthead\fi\nobreak
+%% \nobreak new with Longtable 4.11.
+ \output{\LT@output}}
+%
+%
+% For (2), we are patching \endlongtable:
+% The patch should not change essentials of \endlongtable
+% which may have changed when this patch meets longtable.
+% We just assume that the final contribution to the main vertical
+% list is done by \unvbox0 which is preceded by \LT@start.
+% \prevdepth\dp0 can be put in between, it will then
+% last till the end (TeXbook pp. 282, 277f.).
+\def\@tempa#1\LT@start{#1\LT@start \prevdepth\dp\z@}
+\expandafter\expandafter\expandafter \def
+ \expandafter\expandafter\expandafter \endlongtable
+ \expandafter\expandafter\expandafter
+ {\expandafter\@tempa\endlongtable}
+%
+\endinput
+
+DETAILED DIAGNOSIS:
+
+Concerning the question of "bugs" vs. "features", you might
+reason what features should be aimed at.
+
+%% TODO: This can be shortened when David agrees.
+
+ (A) If there is \parskip below a longtable, there should
+be \parskip above as well--shouldn't it?
+ (B) Interline glue above should (in general) depend on the
+same values of \baselineskip and \lineskip as below---OK?
+ (C) Interline glue below a longtable should depend on the
+depth of the last row, not on the depth of the head or of the
+last line above the longtable--OK?
+
+The recent versions of longtable.sty have not satisfied any
+of these three demands.
+Concerning (A), \parskip appears below the longtable, but not
+above.
+Concerning (B), (i) no interline glue appears above if there
+is no head, (ii) otherwise, only zero interline glue appears.
+Concerning (C), the interline glue below the longtable is
+calculated using the depth of (i) the last line above the
+longtable as \prevdepth when there is no head or of (ii) the
+head otherwise. (Thus I was wrong earlier when I claimed that
+\prevdepth were 0pt after longtable. This only holds in the
+previous case (i) when the last line above the longtable has
+zero depth.)
+
+You can observe this by playing with the demonstration file
+ltabptch.tex in CTAN folder macros/latex/contrib/ltabptch.
+
+Reasons: For contributing a head to the main vertical list,
+longtable uses \copy or \box, which yields a <box> according
+to TeXbook p. 278. Rows are contributed by \unvbox. Now,
+violation of (A) is due to the fact that neither \copy or
+\box of the head nor the \unvbox for table rows leads to
+execution of an \indent or \noindent (TeXbook pp. 282f., see
+also <horizontal command>).
+Violation of (B) is due either to (i) the fact that \unvbox
+is no <box> (TeXbook p. 282/278) or to (ii) the fact that at
+\copy or \box \baselineskip and \lineskip are 0pt.
+Violation of (C) is due to the fact that \unvbox does not
+change \prevdepth (TeXbook p. 282).
+
+As to recognizable effects:
+ Violation of (A), of course, has very little effect in
+general since \parskip is 0pt plus 1pt usually. This is hardly
+recognizable in the presence of the \bigskipamount above and
+below a longtable.
+ Violation of (B) results in missing appropriate interline
+glue above, which often should be 3.6pt or more. This may
+rather be recognizable and may contribute to the impression
+that there even is a spurious blank line below the longtable
+(this is what Sebastion Rahtz reported in tools/3180).
+ For the previous as well as for the details and the
+effects of violation of (C), consider the algorithm for
+calculating interline glue on p. 80 of the TeXbook. If there
+is no head, and the depth of the last line before the
+longtable is 0pt, the interline glue below the longtable is
+\baselineskip minus the height of the first line after the
+longtable. The interline glue *should be* \baselineskip minus
+height of following line *minus* depth of last table row--if
+this depth is not too large (depending on \lineskiplimit).
+This depth is at least 3.6pt. So the interline glue is often
+by 3.6pt or more greater than is appropriate. Considering the
+missing interline glue above the longtable and the \parskip
+below, the glue after the longtable is by 6.2pt (or more) plus
+1pt larger than the glue before. Due to the shrink component
+of the surrounding \bigskipamount, the glue following the
+longtable may be nearly twice as large as the glue before.
+---Usually, violation of (C) has no effect at all. Namely,
+there is a head usually, and its depth is usually the same as
+the depth of the last row, namely \dp\@arstrutbox.
+
+
+%% VERSION HISTORY:
+v1.7 2003/01/07 Sent around 2003/01/13 with first release of
+ ednotes.sty. Sent to David Carlisle. Earlier versions
+ were sent to Frank Mittelbach and the team.
+v1.71 2003/01/22 Added version history.
+v1.72 2003/01/27 Changed copyright notice.
+v1.73 2004/05/13 Adapted to Longtable v4.11; new copyright;
+ longtable -> Longtable (selectively).
+ Added `I have ... 3485'.
+v1.74 2004/08/05 Added `---Yes---...'.
+ 2004/08/21 Typo fix for `problem'; added report on 2003/04/08.
+ 2004/08/23 Corrected and extended diagnosis, sent to CTAN.
+v1.74b .../08/23 `---' -> `--'; added that (C) usually doesn't
+ matter.
+v1.74c .../08/31 `author-maintained'.
+v1.74d 2005/01/10 Contact via http.
+