diff options
author | Karl Berry <karl@freefriends.org> | 2014-05-09 22:39:48 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2014-05-09 22:39:48 +0000 |
commit | 610c45beb863b008027a871701c889fe40bed7fb (patch) | |
tree | 5b879b56850db183fd749a497edd1d91172edf69 /Master/texmf-dist/source/latex/tools/ftnright.dtx | |
parent | 18fa80c232cf479ae713b01b17d48bdc1d653aac (diff) |
latex2e 2014/05/01 (via latex-tds)
git-svn-id: svn://tug.org/texlive/trunk@33946 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/tools/ftnright.dtx')
-rw-r--r-- | Master/texmf-dist/source/latex/tools/ftnright.dtx | 122 |
1 files changed, 61 insertions, 61 deletions
diff --git a/Master/texmf-dist/source/latex/tools/ftnright.dtx b/Master/texmf-dist/source/latex/tools/ftnright.dtx index 07f56cf7efb..b70055f38ad 100644 --- a/Master/texmf-dist/source/latex/tools/ftnright.dtx +++ b/Master/texmf-dist/source/latex/tools/ftnright.dtx @@ -3,22 +3,22 @@ % Copyright 1993 1994 1995 1996 1997 1998 1999 2000 2001 2002 2003 2004 2005 % 2006 2008 2009 2010 % The LaTeX3 Project and any individual authors listed elsewhere -% in this file. -% +% in this file. +% % This file is part of the Standard LaTeX `Tools Bundle'. % ------------------------------------------------------- -% +% % It 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. % The latest version of this license is in % http://www.latex-project.org/lppl.txt -% and version 1.3c or later is part of all distributions of LaTeX +% and version 1.3c or later is part of all distributions of LaTeX % version 2005/12/01 or later. -% +% % The list of all files belonging to the LaTeX `Tools Bundle' is % given in the file `manifest.txt'. -% +% % \fi %\iffalse % this is a METACOMMENT ! % @@ -47,7 +47,7 @@ %% Grave accent \` Left brace \{ Vertical bar \| %% Right brace \} Tilde \~} %% -% +% % % \DoNotIndex{\;} %^^A \DoNotIndex{\@cclv} @@ -158,18 +158,18 @@ % \setlength{\hfuzz}{2pt} ^^A allow small overshot in verbatim % % \GetFileInfo{ftnright.sty} -% +% % \title{Footnotes in a multi-column layout\thanks % {The \LaTeX{} package {\tt \filename} which is described % in this article has the version number \fileversion{} dated % \filedate.}} % \author{Frank Mittelbach} % -% +% % \maketitle -% +% % \pageshrink 1pt %^^A compensate for the \thanks marker -% +% % % \section{Preface to version 1.1} % @@ -191,14 +191,14 @@ % necessary corrections. % % \section{Introduction} -% -% +% +% % The placement of footnotes in a multicolumn layout always bothered % me. The approach taken by \LaTeX{} (i.e., placing the footnotes % separately under each column) might be all right if nearly no % footnotes are present. But it looks clumsy when both columns contain % footnotes, especially when they occupy different amounts of space. -% +% % In the multicolumn package~\cite{art:FMi89b}, I used page-wide % footnotes at the bottom of the page, but again the result doesn't % look very pleasant since short footnotes produce undesired gaps of @@ -211,14 +211,14 @@ % of the results it seems best to avoid footnotes in such a layout % entirely. % -% +% % Another possibility is to turn footnotes into endnotes, i.e., % printing them at the end of every chapter or the end of the entire % document. But I assume everyone who has ever read a book using such % a layout will agree with me, that it is a pain to search back and % forth, so that the reader is tempted to ignore the endnotes % entirely. -% +% % When I wrote the article about ``Future extensions of % \TeX{}''~\cite{inproc:FMi90} I was again dissatisfied with the % outcome of the footnotes, and since this article should show certain @@ -230,17 +230,17 @@ % of footnotes I also consulted books by Jan Tschichold % \cite{book:JTs87} and Manfred Simoneit \cite{book:MSi89}, books I % would recommend to everyone being able to read German texts. -% -% +% +% % \subsection{Description of the new layout} -% +% % The result of this effort is presented in this paper and the reader % can judge for himself whether it was successful or % not.\footnote{Please note, that this option only changed the % placement of footnotes. Since this article also makes use of the % {\tt doc} package \cite{bk:GMS94}, that assigns tiny numbers to % code lines sprinkled throughout the text, the resulting design is -% not perfect. This package is now a standard part of \LaTeXe.} +% not perfect. This package is now a standard part of \LaTeXe.} % The main idea for this layout is to assemble the % footnotes of all columns on a page and place them all together at % the bottom of the right column. Allowing for enough space between @@ -261,13 +261,13 @@ % preceding the footnote text and not the one used within the main % text where a raised number or symbol set in smaller type will help % to keep the flow of thoughts, uninterrupted.} -% +% % All in all, I think this generates a neat layout, and surprisingly % enough, the necessary changes to the \LaTeX{} output routine are % nevertheless astonishingly simple. -% +% % \subsection{The use of the package} -% +% % This package might be used together with any other package % for \LaTeX{} which does not change the three internals changed by % {\tt \filename}.\footnote{These are the macros {\tt\bslash @@ -285,9 +285,9 @@ % the \LaTeX3 implementation, we will certainly add some hooks that % will make such changes more easy. % -% +% % \subsection{Limitations} -% +% % If in the first column there is more than a full column worth of footnote % material the material will be split resulting in footnotes out of % order. This issue is now detected and generates an error but the package is @@ -309,10 +309,10 @@ % likely to be detached from their reference and show up on a later page! % % \StopEventually{ -% +% % \begin{small} % \begin{thebibliography}{1} -% +% % \bibitem{bk:GMS94} \textsc{M.~Goossens}, \textsc{F.~Mittelbach} % and \textsc{A.~Samarin}. % \newblock The \LaTeX{} Companion. @@ -323,46 +323,46 @@ % Hans-Joachim Koppitz, editor. % \newblock {\em {Gutenberg Jahrbuch}}. % \newblock Gutenberg-Gesellschaft, Mainz. -% +% % \bibitem{book:LLa86} % Leslie Lamport. % \newblock {\em {\LaTeX:} A Document Preparation System}. % \newblock Addison-Wesley, Reading, Massachusetts, 1986. -% +% % \bibitem{src:ltxiii94} % \LaTeX3 project. % \newblock \LaTeXe distribution, 1994. % \newblock Souces for {\LaTeXe} the successor to \LaTeX~2.09. -% +% % \bibitem{art:FMi89b} % Frank Mittelbach % \newblock An environment for multi-column output. % \newblock {\em TUGboat}, 10(3):407--415, November 1989. -% +% % \bibitem{inproc:FMi90} % Frank Mittelbach % \newblock E-{\TeX}: Guidelines to future {\TeX} extensions. % \newblock In Lincoln K. Durst, editor, {\em \TUB}, 11(3): % {\em 1990 TUG Annual Meeting Proceedings}, pages % 337--345, September 1990. -% +% % \bibitem{book:MSi89} % Manfred Siemoneit. % \newblock {\em Typographisches {G}estalten}. % \newblock Polygraph Verlag, Frankfurt am Main, second edition, 1989. -% +% % \bibitem{book:JTs87} % Jan Tschichold. % \newblock {\em {Ausgew\"ahlte Aufs\"atze \"uber Fragen der Gestalt des % Buches}}. % \newblock Birkh\"auser Verlag, Basel, 1987. % \newblock Second printing. -% +% % \bibitem{book:JWh88} % Jan White. % \newblock {\em Graphic Design for the Electronic Age}. % \newblock Watson Guptill, Xerox Press, New York, 1988. -% +% % \end{thebibliography} % \end{small} % @@ -370,7 +370,7 @@ % \PrintIndex % \PrintChanges % } -% +% % % % \section{The documentation driver} @@ -402,7 +402,7 @@ \setlength{\parskip} {2pt plus1pt minus1pt} \setlength{\headsep}{20pt} -\setlength{\columnsep}{1.5pc} +\setlength{\columnsep}{1.5pc} \renewcommand{\bottomfraction}{.4} \flushbottom @@ -424,7 +424,7 @@ % \end{macrocode} % % \section{The Implementation} -% +% % % As usual, we start by identifying the current version of this package % file in the transcript file.\footnote{Nico Poppelier suggested @@ -438,7 +438,7 @@ % This actually happens at the very top of this file so it is commented out % here. %\begin{verbatim} -%\ProvidesPackage{ftnright}[\filedate\space +%\ProvidesPackage{ftnright}[\filedate\space % LaTeX2e package \fileversion] %\end{verbatim} % @@ -478,7 +478,7 @@ % is a nice enhancement, and, I suppose, it is of some value for % preparing publications in certain disciplines, so here is the % challenge~\ldots} -% +% % % \begin{macro}{\preparefootins} % \begin{macro}{\saved@footinsskip} @@ -522,7 +522,7 @@ % assembled. Therefore, the macro will start with the following % code: % \begin{macrocode} -\def\@outputdblcol{\if@firstcolumn +\def\@outputdblcol{\if@firstcolumn \global\@firstcolumnfalse % \end{macrocode} % After changing the switch, we save the first column (which was @@ -580,7 +580,7 @@ % \end{macrocode} % \end{macro} % -% +% % \begin{macro}{\@startcolumn} % \changes{v1.0b}{1990/08/11}{Macro added to correct float problems} % There is a fundamental flaw in \LaTeX's output routine for float @@ -594,11 +594,11 @@ % be to rewrite two-thirds of \LaTeX{}'s output routine, so I am % leaving this open for the interested reader. % -% \begin{figure}[b] +% \begin{figure}[b] % \fbox{%^^A -% \newlength{\puzzlewd}%^^A -% \setlength{\puzzlewd}{\columnwidth}%^^A -% \addtolength{\puzzlewd}{-2.1\fboxsep}%^^A +% \newlength{\puzzlewd}%^^A +% \setlength{\puzzlewd}{\columnwidth}%^^A +% \addtolength{\puzzlewd}{-2.1\fboxsep}%^^A % \begin{minipage}{\puzzlewd} % \vspace{17pt} % \begin{center} @@ -607,7 +607,7 @@ % \vspace{-3pt} % \small % \begin{quote} -% \rightskip \leftmargini plus 2.5em +% \rightskip \leftmargini plus 2.5em % Given a simple \TeX{} document containing only straight text, is % it possible for the editor, after % deleting one sentence, to end up with a document @@ -616,7 +616,7 @@ % We assume that the deleted text contains no \TeX{} macros and % that the document was prepared % with a standard macro package like the one used for \TUB\/ production. -% \end{quote} +% \end{quote} % \vspace{7pt} % \begin{flushright} % The answer will be given in the next issue. @@ -658,7 +658,7 @@ % whether such footnotes are present. As we have not reinserted % them in |\@outputdblcol|, we can check the |\footins| box. % \begin{macrocode} - \ifvoid\footins\else + \ifvoid\footins\else % \end{macrocode} % If there are some, we measure the space that will be occupied by % them. This measurement is not really exact. If we have a full @@ -757,7 +757,7 @@ } % \end{macrocode} % \end{macro} -% +% % \begin{macro}{\@makecol} % The other internal macro that we have to change is |\@makecol|, a % macro that is called whenever one column of material is assembled @@ -773,7 +773,7 @@ % \begin{macrocode} \setbox\@outputbox\box\@cclv % \end{macrocode} -% +% % But if the user errously forgot to specify a twocolumn layout, we % will always typeset the first column, so that the footnotes are % never printed. Therefore we better check for this special case @@ -790,13 +790,13 @@ % \begin{macrocode} \if@twocolumn \else \ifvoid\footins \else - \@latexerr{ftnright package + \@latexerr{ftnright package used in one-column mode}% {The ftnright package was designed to work with LaTeX's standard^^Jtwocolumn option. It does *not* work with the multicol package.^^JSo please specify - `twocolumn' in the + `twocolumn' in the \noexpand\documentclass command.}% \shipout\box\footins \fi\fi % \end{macrocode} @@ -813,9 +813,9 @@ \ifnum\insertpenalties>\z@ \@latexerr{ftnright package scrambled footnotes}% - {There is too much footnote material in - the first column and ftnright^^Jis - unable to cope with this.^^JYou need + {There is too much footnote material in + the first column and ftnright^^Jis + unable to cope with this.^^JYou need to reduce the amount to get a properly formatted page.}% \fi @@ -838,12 +838,12 @@ % possibility. % \begin{macrocode} \setbox\@outputbox\vbox - {\ifvoid\@cclv \else + {\ifvoid\@cclv \else \unvbox\@cclv \vskip\skip\footins\fi % \end{macrocode} % But in any case, we place the |\footnoterule| in front of the -% footnotes even if this macro is not used by this +% footnotes even if this macro is not used by this % package.\footnote{This decision is certainly open to criticism, % since there is nothing to separate. On the other hand, a rule or % some other ornament in front of the footnotes is part of the @@ -857,7 +857,7 @@ % or not. It also ends the code which differs depending on the % column number. % \changes{v1.1d}{1998/12/02}{Added the color@group macros and -% \texttt{\protect\bslash normalcolor} to make this colorsafe} +% \texttt{\protect\bslash normalcolor} to make this colorsafe} % \begin{macrocode} \color@begingroup \normalcolor @@ -927,7 +927,7 @@ \@setfontsize\footnotesize\@viiipt{9.9}% \abovedisplayskip 6\p@\@plus2\p@\@minus4\p@ \abovedisplayshortskip \z@ \@plus\p@ - \belowdisplayshortskip + \belowdisplayshortskip 3\p@\@plus\p@\@minus2\p@ \def\@listi{\leftmargin\leftmargini \topsep 3\p@ \@plus\p@ \@minus\p@ @@ -953,7 +953,7 @@ \@setfontsize\footnotesize\@xpt{12.3}% \abovedisplayskip10\p@\@plus2\p@\@minus5\p@ \abovedisplayshortskip \z@ \@plus3\p@ - \belowdisplayshortskip + \belowdisplayshortskip 6\p@ \@plus3\p@ \@minus3\p@ \def\@listi{\leftmargin\leftmargini \topsep 6\p@ \@plus2\p@ \@minus2\p@ |