summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/tex/latex/needspace
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2009-09-04 01:05:22 +0000
committerKarl Berry <karl@freefriends.org>2009-09-04 01:05:22 +0000
commitdce0ff5a005e417ac63aafe94583124544bfada3 (patch)
tree713aa0d36d14bb8df58fd176a87db48c746e2ccf /Master/texmf-dist/tex/latex/needspace
parent81805475cde677bc40f624e3e2febbd6423419d0 (diff)
needspace update (3sep09)
git-svn-id: svn://tug.org/texlive/trunk@15072 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/tex/latex/needspace')
-rw-r--r--Master/texmf-dist/tex/latex/needspace/needspace.sty80
1 files changed, 80 insertions, 0 deletions
diff --git a/Master/texmf-dist/tex/latex/needspace/needspace.sty b/Master/texmf-dist/tex/latex/needspace/needspace.sty
new file mode 100644
index 00000000000..ee286352e8e
--- /dev/null
+++ b/Master/texmf-dist/tex/latex/needspace/needspace.sty
@@ -0,0 +1,80 @@
+% needspace.sty
+%
+% Provides commands to reserve space at the bottom of a page. If there
+% is not enough space on the current page (column) a new page (column)
+% is started.
+%
+% Author: Peter Wilson, Herries Press
+% Maintainer: Will Robertson (will dot robertson at latex-project dot org)
+% Copyright 1996--2003 Peter Wilson
+% Released under the LaTeX Project Public License
+%
+%
+\NeedsTeXFormat{LaTeX2e}
+\ProvidesPackage{needspace}[2009/09/03 v1.3b reserve vertical space]
+
+\newcommand{\needspace}[1]{\begingroup\setlength{\dimen@}{#1}%
+ \vskip\z@\@plus\dimen@ \penalty -100\vskip\z@\@plus -\dimen@
+ \vskip\dimen@ \penalty 9999\vskip -\dimen@\endgroup}
+
+\newcommand{\Needspace}{\@ifstar{\@sneedsp@}{\@needsp@}}
+
+\newcommand{\@sneedsp@}[1]{\par \penalty-100\begingroup
+ \setlength{\dimen@}{#1}%
+ \dimen@ii\pagegoal \advance\dimen@ii-\pagetotal
+ \ifdim \dimen@>\dimen@ii
+ \break
+ \fi\endgroup}
+
+\newcommand{\@needsp@}[1]{\par \penalty-100\begingroup
+ \setlength{\dimen@}{#1}%
+ \dimen@ii\pagegoal \advance\dimen@ii-\pagetotal
+ \ifdim \dimen@>\dimen@ii
+ \ifdim \dimen@ii>\z@
+ \vfil
+ \fi
+ \break
+ \fi\endgroup}
+
+\endinput
+
+% Example uses:
+%
+% ... previous text.\par
+% \needspace{5\baselineskip} % need next 5 lines on a single page/column
+% The next five lines ...
+%
+% \Needspace*{4\baselineskip} % need 4 lines kept on same page
+% The major principles are:
+% \begin{itemize}
+% \item ...
+%
+%
+% The \needspace macro reserves an APPROXIMATE amount of space (depending
+% on what penalties are in effect) but is efficient and normally adequate.
+% A short page will be ragged bottom even if \flushbottom is in
+% effect.
+%
+% \Needspace is less efficient but reserves the requested space. It
+% should only be used between paragraphs. Short pages produced by
+% \Needspace{<length>} will be ragged bottom but short pages produced by
+% \Needspace*{<length>} will be flush bottom if \flushbottom is in effect.
+%
+% Changes v1.3b (2009/09/03)
+% New maintainer (Will Robertson)
+%
+% Changes v1.3a (2003/02/18)
+% At the suggestion of Donald Arseneau (private emails) changed guts of
+% \needspace from
+% ... \vskip\z@\@plus\dimen@\pagebreak[3]\vskip\z@\@plus-\dimen@\endgroup}
+%
+% Changes v1.3 (2003/02/07)
+% Added \Needspace (an extended version of postings by Donald Arseneau
+% to comp.text.tex e.g., in November 1993, August 1995, September 1997, ...)
+%
+% Changes v1.2 (2002/09/11)
+% At the suggestion of Robin Fairbairns, added use of \dimen@ to capture
+% the argument so that calc package commands can be used in the argument.
+%
+%
+%