From b7a0b0162c49aea864ceea62a3defd130f36660b Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sun, 12 Sep 2010 22:40:59 +0000 Subject: needspace update (12sep10) git-svn-id: svn://tug.org/texlive/trunk@19684 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/needspace/README | 79 ++++++++++++++++++ .../texmf-dist/doc/latex/needspace/needspace.pdf | Bin 274359 -> 137092 bytes .../texmf-dist/doc/latex/needspace/needspace.tex | 89 --------------------- 3 files changed, 79 insertions(+), 89 deletions(-) create mode 100644 Master/texmf-dist/doc/latex/needspace/README delete mode 100644 Master/texmf-dist/doc/latex/needspace/needspace.tex (limited to 'Master/texmf-dist/doc/latex') diff --git a/Master/texmf-dist/doc/latex/needspace/README b/Master/texmf-dist/doc/latex/needspace/README new file mode 100644 index 00000000000..46c02494ff0 --- /dev/null +++ b/Master/texmf-dist/doc/latex/needspace/README @@ -0,0 +1,79 @@ + +The NEEDSPACE package +===================== + +Provides the \needspace and \Needspace macros for +requesting a certain amount of space on the current +page for the following material. + + +INSTALLATION +------------ + +Run `pdflatex` on needspace.tex to produce the files + needspace.ins and needspace.sty, +as well as to compile the PDF documentation. + +Execute `tex needspace.ins` to produce the files above +except needspace.ins itself (and the PDF file, obviously). + + +CHANGE HISTORY +-------------- + +* v1.3c (2010/09/12): + Patch to improve behaviour with commands like `\section` that use + `\addvspace`. See [this thread][ctt] on comp.text.tex. + +[ctt]: http://groups.google.com/group/comp.text.tex/browse_frm/thread/8d849a1e0be2120e + +* v1.3b (2009/09/03): + New maintainer (Will Robertson) + +* 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} + +* 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, ...) + +* 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. + + +COPYRIGHT AND LICENSING +----------------------- + +Authors: Donald Arseneau and Peter Wilson (Herries Press) +Maintainer: Will Robertson (will dot robertson at latex-project dot org) +Copyright 1996-2003 Peter Wilson +Copyright 2010 Will Robertson + +This work may be distributed and/or modified under the +conditions of the LaTeX Project Public License, either +version 1.3c of this license or (at your option) any +later version: + +This work has the LPPL maintenance status "maintained". +The Current Maintainer of this work is Will Robertson. + +This work consists of the files needspace.tex and the +derived files needspace.sty and needspace.ins. + + +MAINTENANCE +----------- + +Please report bugs or request features: + + +Developmental and historical versions: + + +Current release version: + + diff --git a/Master/texmf-dist/doc/latex/needspace/needspace.pdf b/Master/texmf-dist/doc/latex/needspace/needspace.pdf index 0305e3819c4..6082e146bda 100644 Binary files a/Master/texmf-dist/doc/latex/needspace/needspace.pdf and b/Master/texmf-dist/doc/latex/needspace/needspace.pdf differ diff --git a/Master/texmf-dist/doc/latex/needspace/needspace.tex b/Master/texmf-dist/doc/latex/needspace/needspace.tex deleted file mode 100644 index 4dce4814d3d..00000000000 --- a/Master/texmf-dist/doc/latex/needspace/needspace.tex +++ /dev/null @@ -1,89 +0,0 @@ -\documentclass[pagesize=auto, fontsize=12pt, DIV=11]{scrartcl} - -\usepackage{fixltx2e} -\usepackage{etex} -\usepackage{xspace} -\usepackage{lmodern} -\usepackage[T1]{fontenc} -\usepackage{textcomp} -\usepackage{microtype} -\usepackage{hyperref} - -\newcommand*{\mail}[1]{\href{mailto:#1}{\texttt{#1}}} -\newcommand*{\pkg}[1]{\textsf{#1}} -\newcommand*{\cs}[1]{\texttt{\textbackslash#1}} -\makeatletter -\newcommand*{\cmd}[1]{\cs{\expandafter\@gobble\string#1}} -\makeatother -\newcommand*{\meta}[1]{\textlangle\textsl{#1}\textrangle} -\newcommand*{\marg}[1]{\texttt{\{}\meta{#1}\texttt{\}}} - -\addtokomafont{title}{\rmfamily} - -\title{The \pkg{needspace} package\thanks{This manual corresponds to \pkg{needspace}~v1.3b, dated~2009/09/03.}} -\author{Author: Peter Wilson, Herries Press\\Maintainer: Will Robertson\thanks{\mail{will.robertson@latex-project.org}}} -\date{2009/09/03} - - -\begin{document} - -\maketitle - -\noindent -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. - -\begin{quote} - \small - Copyright 1996--2003 Peter Wilson\\ - Released under the \LaTeX\ Project Public License -\end{quote} - - -\section{Example uses:} - -\begin{verbatim} -... 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 ... -\end{verbatim} - -The \cmd{\needspace} macro reserves an \emph{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 \cmd{\flushbottom} is in -effect. - -\cmd{\Needspace} is less efficient but reserves the requested space. It -should only be used between paragraphs. Short pages produced by -\cmd{\Needspace}\marg{length} will be ragged bottom but short pages produced by -\cmd{\Needspace*}\marg{length} will be flush bottom if \cmd{\flushbottom} is in effect. - - -\section{Changes:} - -\begin{description} -\item[Changes v1.3b (2009/09/03)] - New maintainer (Will Robertson) - -\item[Changes v1.3a (2003/02/18)] - At the suggestion of Donald Arseneau (private emails) changed guts of - \cmd{\needspace} from - \ldots\verb+\vskip\z@\@plus\dimen@\pagebreak[3]+\allowbreak - \verb+\vskip\z@\@plus-\dimen@\endgroup}+ - -\item[Changes v1.3 (2003/02/07)] - Added \cmd{\Needspace} (an extended version of postings by Donald Arseneau - to \texttt{comp.text.tex} e.\,g.,\ in November 1993, August 1995, September 1997, \ldots) - -\item[Changes v1.2 (2002/09/11)] - At the suggestion of Robin Fairbairns, added use of \cmd{\dimen@} to capture - the argument so that \pkg{calc} package commands can be used in the argument. -\end{description} - -\end{document} -- cgit v1.2.3