From 37dfbcfb22cd80fe5a754250af8eda4a2843af05 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Mon, 26 Apr 2010 00:33:06 +0000 Subject: needspace doc (22apr10) git-svn-id: svn://tug.org/texlive/trunk@17999 c570f23f-e606-0410-a88d-b1316a301751 --- .../texmf-dist/doc/latex/needspace/needspace.pdf | Bin 0 -> 274359 bytes .../texmf-dist/doc/latex/needspace/needspace.tex | 89 +++++++++++++++++++++ Master/tlpkg/bin/tlpkg-ctan-check | 13 ++- 3 files changed, 95 insertions(+), 7 deletions(-) create mode 100644 Master/texmf-dist/doc/latex/needspace/needspace.pdf create mode 100644 Master/texmf-dist/doc/latex/needspace/needspace.tex (limited to 'Master') diff --git a/Master/texmf-dist/doc/latex/needspace/needspace.pdf b/Master/texmf-dist/doc/latex/needspace/needspace.pdf new file mode 100644 index 00000000000..0305e3819c4 Binary files /dev/null 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 new file mode 100644 index 00000000000..4dce4814d3d --- /dev/null +++ b/Master/texmf-dist/doc/latex/needspace/needspace.tex @@ -0,0 +1,89 @@ +\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} diff --git a/Master/tlpkg/bin/tlpkg-ctan-check b/Master/tlpkg/bin/tlpkg-ctan-check index 2fac39798c9..24cc6cfaef4 100755 --- a/Master/tlpkg/bin/tlpkg-ctan-check +++ b/Master/tlpkg/bin/tlpkg-ctan-check @@ -462,6 +462,10 @@ sub do_tlp my @compared = (); for my $file (@tpm_files) { #warn "checking file $file\n"; + # no point yet in comparing ours, we have generated too many. + # revisit this someday to see how many of ours are actually different. + next if $file =~ /\.pdf$/; + my $tl_file = "$Master/$file"; if (! -e $tl_file) { warn "$tl_file: TL file missing\n"; @@ -486,18 +490,13 @@ sub do_tlp if (! -e $ctan_file) { # we generate lots of files, eg perlmacros.sty, so might skip. warn "$ctan_file: CTAN file missing\n" - if $ctan_file && $ctan_file !~ /(cfg|dvi|sty|tex)$/; + if $ctan_file && $ctan_file !~ /(cfg|dvi|sty|tex)$/; next; } } push (@compared, $basefile); if (&files_differ ($tl_file, $ctan_file)) { - # we sometimes regenerate pdf's for TL, so we don't complain if - # they are different. On the other hand, we don't always - # regenerate them, so might as well check first. - next if $tl_file =~ /\.pdf$/; - print "# $tlpn\ndiff $ctan_file $tl_file\n"; $needed = 1; last unless $OPT{"all"}; @@ -514,7 +513,7 @@ sub do_tlp } print ((@compared + 0) . " compared (@compared)\n") if $OPT{"verbose"}; - # clean up the tmpdir possibly created when invoking 'tlpkginfo --prepare' + # clean up the tmpdir possibly created from tlpkginfo --prepare. chomp (my $ctan_root = `$mydir/tlpkginfo --ctan-root`); if ($ctan_dir !~ m,^$ctan_root, && ! $OPT{"no-clean"}) { system ("rm -rf $ctan_dir"); -- cgit v1.2.3