diff options
author | Karl Berry <karl@freefriends.org> | 2006-01-12 23:58:04 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2006-01-12 23:58:04 +0000 |
commit | 440d102927608f99ff10892dc8754b4f432f4aab (patch) | |
tree | 720c540625653f34e6870c8e446e63beb0ff368d /Master | |
parent | b39b97b2d27cbfd91ecbb0669d02af08c3342a93 (diff) |
lineno
git-svn-id: svn://tug.org/texlive/trunk@1041 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master')
-rw-r--r-- | Master/texmf-dist/tex/latex/lineno/ednmath0.sty | 202 | ||||
-rw-r--r-- | Master/texmf-dist/tex/latex/lineno/edtable.sty | 571 | ||||
-rw-r--r-- | Master/texmf-dist/tex/latex/lineno/lineno.sty | 3441 | ||||
-rw-r--r-- | Master/texmf-dist/tex/latex/lineno/vplref.sty | 72 |
4 files changed, 4286 insertions, 0 deletions
diff --git a/Master/texmf-dist/tex/latex/lineno/ednmath0.sty b/Master/texmf-dist/tex/latex/lineno/ednmath0.sty new file mode 100644 index 00000000000..363c6c6aa5c --- /dev/null +++ b/Master/texmf-dist/tex/latex/lineno/ednmath0.sty @@ -0,0 +1,202 @@ +%% Macro package `ednmath0.sty' for LaTeX2e, +%% copyright (C) 2004 Uwe L\"uck, +%% http://www.contact-ednotes.sty.de.vu +%% --author-maintained; +%% math support for `lineno.sty' and `ednotes.sty'. +%% +\def\fileversion{v0.2b} \def\filedate{2005/01/10} +%% This program can be redistributed and/or modified under the +%% terms of the LaTeX Project Public License distributed from +%% CTAN archives in directory macros/latex/base/lppl.txt; either +%% version 1.3a of the License, or any later version. +%% The latest version of this license is in +%% http://www.latex-project.org/lppl.txt +%% There is NO WARRANTY. +%% This code is very EXPERIMENTAL! +%% +%% Please report bugs, problems, and suggestions via +%% +%% http://www.contact-ednotes.sty@web.de +% +%% * MAIN FEATURE * +% +% lineno.sty's \linelabel and ednotes.sty's commands are enabled +% to work in math mode if it's "entered in outer mode" +% (including `displaymath' and `equation' environments). +% (lineno.sty is the package by Stephan Boettcher.) +% They will even work in tabular environments that are adjusted +% to notes by package `edtable.sty'. +% +% CAVEATS: +% -- Does not work yet in environments like LaTeX's +% `eqnarray'. (This could probably repaired along the lines +% of Edtable.sty--we're short of time and will try later.) +% -- Useful error messages when (i) math mode is entered from +% inner mode or when (ii) a math display gets not line number +% are missing at present. +% +%% * USAGE: * +% +% * Most simple: * +% --If you are working with ednotes and want to use its +% commands in math mode, load ednotes.sty--version 0.8 +% onwards--with its package option `mathnotes'. +% --If you don't work with ednotes, only with lineno, you +% get the main feature of making \linelabel work in math mode +% by loading lineno.sty--version 4.1 onwards--with its +% package option `mathrefs'. +% +% * Switch off and on: * +% To reduce danger resulting from missing error messages +% ("caveat" above), you may switch these new math facilities +% off by \NoNotesToMath where you don't expect to need them. +% You may switch them on again by \NotesToMath where you want +% to use them, being aware of the danger. Both commands work +% locally, so you can replace one of them by enclosing it in +% a group. E.g., even, after \NoNotesToMath you can use an +% environment as follows: +% \begin{NotesToMath} +% <text> +% \end{NotesToMath} +% (I am not quite sure that this is useful.) +% +% * Customize ellipsis: * +% ednotes' \lemmaellipsis is changed to expand to +% \mathlemmaellipsis when entering math, and this is preset +% to be LaTeX's \mathellipsis. (This is three dots as +% \mathinner.) You can change this by redefining +% \mathlemmaellipsis, e.g.: +% \renewcommand{\mathlemmaellipsis}{\cdots} +% If you need \cdots as the ellipsis at a single place only, +% you may, of course, use the `<...>' option of \<, e.g.: +% $ x = \Anote{a\<<\cdots>bcd\>e}{Indeed?} - y $ +% +% * Customize note mode: * +% For variant readings, you may want that the note is +% usually set in math mode--so you may want that you +% needn't type the dollar signs in the note text. +% Note that you can do this by customizing \notefmt, +% and you can do this by customizing \Anotefmt (e.g.) +% to have this feature for \Anote only. +% + +\NeedsTeXFormat{LaTeX2e} +\ProvidesPackage{ednmath0}[\filedate\space\fileversion\space + math support for lineno/ednotes (ul)] +% +%% User commands: +\def\NotesToMath{\let\@LN@mathhook\@LN@labelinmath + \@bsphack \@esphack +% For \begin{NotesToMath} +} +\def\NoNotesToMath{\@bsphack + \def\@LN@mathhook{\@parmoderr\@gobble}% + \@esphack +} +\def\endNotesToMath{\@bsphack\@Esphack} +\let\endNoNotesToMath\endNotesToMath +% +%% Core code for lineno.sty: +\@ifundefined{@LN@postlabel}{% + \PackageError{ednmath0}{% + Bad lineno.sty version% + }{% + lineno.sty from 2004/08/16 or later + must be loaded earlier.% + }% +}{% + \def\@LN@labelinmath#1{% + \ifmmode + \@LN@postlabel{#1}% + \else + \@parmoderr + \fi + } +} +% +%% Core code for ednotes.sty: +\@ifundefined{@EN@note}{% +% v0.01 sent a warning in this case. Considered superfluous now. +}{% + \def\@EN@themathlemmatag{% + \ifmmode + \toks@\expandafter{\@EN@lemmatag}% + \edef\@EN@lemmatag{% + $% + \def\noexpand\lemmaellipsis{% + \noexpand\mathlemmaellipsis}% + \the\toks@ + $% + }% +% \expandafter \def \expandafter \@EN@lemmatag +% \expandafter {\expandafter $\expandafter +% \def \expandafter \lemmaellipsis \expandafter {% +% \expandafter \mathlemmaellipsis \expandafter }% +% \@EN@lemmatag $}% + \fi + } +% To be sure, \lemmaellipsis doesn't need to be changed when +% ednotes `\<...\>' feature is not used. Though I prefer to +% use one hook only in ednotes for both situations, with and +% without `\<...\>'. +% +% The final \unskip in ednotes' \@EN@lemmatag would undo a final +% \quad. That's OK: outside math the same happens. +% In v0.01, \NoNotesToMath undid ednotes changes for math mode. +% However, re-appearence of \linelabel error messages suffices. +% +% Now add lemma switch to the left of \[No]NotesToMath: + \toks@\expandafter{\NotesToMath} + \edef\NotesToMath{% + \let \noexpand\@EN@mathlemmatag \noexpand\@EN@themathlemmatag + \the\toks@ + } +% \typeout{\string\NotesToMath: \meaning\NotesToMath} + \toks@\expandafter{\NoNotesToMath} + \edef\NoNotesToMath{% + \let \noexpand\@EN@mathlemmatag \relax + \the\toks@ + } +% \typeout{\string\NoNotesToMath: \meaning\NoNotesToMath} +} +% We need no extra device for a choice for users whether the *note* +% should be set in math mode or in horizontal mode by default +% (which might depend on the kind ["layer"] of notes). +% This can be done already by customization of ednotes' \notefmt. +% However, we might change ednotes' default \notefmt to default +% \renewcommand*{\notefmt}[1]{$#1$} +% +\let\mathlemmaellipsis\mathellipsis +%% TODO: Since when has LaTeX provided \mathellipsis? +%% -> \Needs... +% +% Default: +\NotesToMath +% +\endinput + +%% TODO: Without \linenumberdisplaymath, in displaymath, +%% an error should be shown. Use, e.g., that in a displaymath +%% \ifinner is false. +%% TODO: E.g., by changing \everymath, perhaps can be warned +%% that the math group is in a box already, so the vertical +%% items will get lost. +%% TODO: Adjust `eqnarray' (in Edtable?) as well. + +%% VERSION HISTORY: +v0.01 2004/08/16 First version, sent to Christian. +v0.02 2004/08/16 Considerably simplified for ednotes. + 2004/08/19 Added ellipsis stuff, documentation, and + instructions. Uncapitalized package names. + Added \end[No]NotesToMath. + 2004/08/20 Added \@bsphack and \@esphack; corrected + ednotes extension (too much deleted, completely + wrong), introducing \@EN@themathlemmatag. +v0.02b .../08/31 Rearranged preamble concerning maintenance. +v0.1 2004/09/20 Removed mentions of `linenox0.sty'. +v0.2 2004/10/07 Removed another mention of `linenox0.sty'; + Instructions: `lineno' or `ednotes.sty' option. +v0.2a 2004/11/07 LPPL v1.3a. +v0.2b 2005/01/10 Contact via http. + + diff --git a/Master/texmf-dist/tex/latex/lineno/edtable.sty b/Master/texmf-dist/tex/latex/lineno/edtable.sty new file mode 100644 index 00000000000..206347539e7 --- /dev/null +++ b/Master/texmf-dist/tex/latex/lineno/edtable.sty @@ -0,0 +1,571 @@ +%% `edtable.sty'---Uwe L"uck, direction Christian Tapp. +%% LaTeX package for tables with line numbers and +%% editorial notes. +%% +%% Copyright (C) 2003-2005 Uwe L"uck--author-maintained. +%% +\def\fileversion{1.3c} \def\filedate{2005/10/03} +%% +%% This file can be redistributed and/or modified under +%% the terms of the LaTeX Project Public License; either +%% version 1.3 of the License, or any later version. +%% The latest version of this license is in +%% http://www.latex-project.org/lppl.txt +%% We did our best to help you, but there is NO WARRANTY. +%% +%% Please send your comments via +%% +%% http://www.contact-ednotes.sty.de.vu +%% +%% * USAGE: * +% +% *Requirements/overview:* +% +% The package is made for the background of the LaTeX2e macro +% package and enhances functionality of the following packages: +% 1.) Stephan I. B"ottcher's `lineno.sty' for printing line +% numbers in the margin and a \label version \linelabel +% relating labels to line numbers; +% 2.) our `ednotes.sty' for indicating variant readings and +% other editorial remarks in separate footnote apparatuses; +% 3.) David Carlisle's `longtable.sty' for multi-page tables. +% %% TODO: supertabular etc.!? +% 4.) our `ltabptch.sty' for a patch of `longtable.sty' +% (i.e., optionally, see below). +% +% Actually, only the first package is necessary for using the +% present one. The present one needs your line numbering commands +% according to the first one and its documentation to which we +% refer here. We likewise refer to the remaining packages for the +% details of their functionality. +% +% `lineno.sty' version 4.1 and (in case it is used) `ednotes.sty' +% version 0.8 (onwards) are needed. For obtaining recent versions +% of required packages, see the CTAN folder +% /macros/latex/contrib/ednotes. +% +% *Install/load:* +% 1.) To be used, the present file must be put into a folder +% that (La)TeX searches. You should have obtained a file +% containing more detailed hints about this. +% 2.) We recommend loading this file *not* by +% \usepackage[<options>]{edtable} but by loading `lineno.sty' +% or `ednotes.sty' with package option `edtable'. +% 3.) To use the package options `longtable' and +% `nolongtablepatch' that are described below, enter them +% as options for `lineno.sty' or `ednotes.sty'. +% +% *User Commands:* +% +% 1. The package defines an environment `edtable' -- for its +% syntax we consider two cases: +% (a) Let <stdtable> be a tabular environment "like `tabular'". +% "Like" here means: (i) we have tested it with `tabular', but +% it should work with many more (e.g., from the `array' and +% `tabularx' packages) -- which share certain properties of +% implementation and requirements. Sorry, you must try, or we +% hope you will (and tell us). (For wizards: <stdtable> may +% probably be anything using a single \halign and \tabskip=0pt.) +% Definitively: +% (ii) LaTeX's standard `array' and other environments are *not* +% "like" `tabular'. Namely, environments that work only in math +% mode are not meant here. They are considered below in `b.'. +% (iii) `longtable' from the `longtable' package of the `tools' +% bundle neither is meant. An option of the present package +% deals with it as described below. Neither `supertabular' is +% meant. +% (iv) In general, usage with tabular environments that can +% break across pages as in (iii) is not recommended, at least +% when working with `ednotes.sty'. Even if some worked here, a +% shortcoming with `ednotes.sty' would be that the footnotes can +% appear on bad pages. +% -- Now the syntax is: +% \begin{edtable}{<stdtable>}<args><entries>\end{edtable} +% -- where <args> and <entries> are usual arguments and entries +% for <stdtable>. So an example is: +% \begin{edtable}{tabular}{cc} +% left upper & right upper \\ left lower & right lower +% \end{edtable} +% This produces just what <stdtable> does in an extra line, +% only adding line numbers in the margin and processing `ednotes' +% commands in the entries appropriately. +% (b) Let <stdarray> be an "array environment" like -- standard +% LaTeX's `array'! "Like" here means (i) ... analogously to +% <stdtable> above. (ii) "Text" ... oh, sorry, this is not clear +% to me at present, and I am in a hurry. %% TODO +% (iii) Nothing from the `amsmath' package seems to work here, +% sorry, I have tried a lot ... (iv) For standard LaTeX's +% `eqnarray', it is better to try the `linenomath' environment +% of `lineno.sty' [with package option `mathlines']. Its +% modifications in `amsmath' produce (at best) a spurious line +% number with the `linenomath' environment (up to now). +% -- Now the syntax is: +% \begin{edtable}[<$$$>]{<stdarray>} +% <args><entries>\end{edtable} +% -- where <args> and <entries> are usual arguments and entries +% for <stdarray>. <$$$> can be one of `$' or `$$'. Indeed, the +% <stdtable> syntax above (without [<$$$>]) *does not work* +% inside $...$ or $$...$$. -- An example: +% \begin{edtable}[$$]{array}{cc} +% a_{11} & a_{12} \\ a_{21} & a_{22} +% \end{edtable} +% Now, this produces just what <stdarray> does in an extra line +% etc. as with <stdtable>. However, \linelabel and `ednotes.sty' +% footnotes may need the `mathrefs' option of `lineno.sty'. For +% the difference between `[$]' and `[$$]', see below. +% +% 2. When working with `ednotes.sty', in +% \Anote{L1\<L2\>L3}{NOTE} +% L2 may contain &'s and \\'s, but L1, L3 must not! Analogously +% for \Bnote, etc., \Anotelabel...\donote..., etc. -- Well this +% holds for <stdtable>, hardly for <stdarray> ... %% TODO +% +% 3. On positioning: You may have wondered about `extra line' +% above. This means that `edtable' starts a new line at +% \begin{edtable} and at \end{edtable}. %% TODO: sure!? +% (a) It should be placed within a `center', `flushleft', or +% `flushright' environment for proper (vertical) spacing, but +% also works without. However, with <stdarray> and optional +% parameter `$$' of `edtable' (i.e., \begin{edtable}[$$]...), +% you can obtain the usual math display spacing *within a +% paragraph*; especially, the vertical space is less when the +% previous line is short ... and so on. +% (b) Horizontal positioning of line numbers (usually) needs a +% second run (after changing a table)! %% TODO: automatic warning. +% (For wizards: It may fail if some of \leftskip, \rightskip, +% \linewidth, and \@totalleftmargin are used in an unusual way.) +% A <dimen> register \ETextraoffset is provided whose value is +% 0pt by default and which additionally moves line numbers +% to the left (right) if given a positive (negative) value. +% %% TODO: any use? +% +% *Package options:* +% +% 1. Option `longtable' adjusts the `longtable' environment +% defined by David Carlisle's longtable.sty for use with +% `lineno.sty' and `ednotes.sty'. The option makes `longtable' +% environments appear with line numbers in the margin, according +% to `lineno.sty', and process `ednotes.sty' commands if line +% numbering is active according to `lineno.sty'. +% [We maintain an alternative package with just this function +% in a slightly different implementation.] %% -> ulnltab.sty. +% Lemmas may go across table entries as with `edtable' (see above). +% ---There might be options like `supertabular' for adjusting +% other tabular environments that cannot be handled by the +% `edtable' environment provided here---they have not been +% implemented yet! %% TODO +% +% 2. Option `nolongtablepatch' avoids loading/asking for +% `ltabptch.sty'. I.e.: according to LaTeX bugs database, +% tools/3180 and tools/3485, there have been problems with +% vertical spacing around `longtable' environments. By default +% the present package loads our `ltabptch.sty' or asks for it. +% Option `nolongtablepatch' overrides this. This is useful when +% you don't want to have the patch, especially when you use an +% "emergency stop" installation of TeX. +% +% *Wizard interface:* +% Macros \@ET@makeLineNumber, \@ET@use@outerhook, +% \@ET@execute@outerhook, \@ET@ampnotes \@ET@startlinewith, +% \@ET@trivialize@linelabel are provided as tools for adjusting +% tabular environments for use with `lineno.sty' and +% `ednotes.sty'. \@ET@step@linenumber is \let \stepLineNumber +% (from `lineno.sty'), but could be used as a hook for +% something different. See Environment `edtable' and Option +% `longtable' below for examples of application. +% %% TODO: specification here. +% +% +%% * Acknowledgements: * +% +% Stephan I. B"ottcher told us how to do it in extensive discussion +% and by providing some first code lines. We changed these essentially +% in some respects, but kept his general ideas and some parts of his +% macros, the latter even without knowing what we are doing. +% +% v1.3 is due to a request by Martin Brandenburg. +% +% * Now for internals: * +% +\NeedsTeXFormat{LaTeX2e}[1994/12/01] +% 1994/12/01: \newenvironment* etc. %% TODO: more recent needed? +\ProvidesPackage{edtable}[\filedate\space v\fileversion\space + arrays with lineno + ednotes (ul)] +% +% Alternative ideas for implementation: +% 1. There is a German package `TABMAC' enhancing `EDMAC' (cf. +% documentation of `ednotes.sty'). We could have rewritten its +% macros so it would work with `lineno.sty' and `ednotes.sty' +% in place of `EDMAC'. [TODO: "tabmac.sty"] +% 2. We redefine `longtable' by Option `longtable' because +% there seems to be only one reasonable use of the `longtable' +% environment in the course of a critical edition. This may be +% different for environments like `array' and `tabular' which +% can be used within text lines. Therefore, these environments +% are not redefined. +% 3. One might use \everycr, however: (a) it is executed +% before the first row, (b) it is executed in fake lines that +% `longtable' uses. +% 4. As an alternative to \everycr, there is the approach of +% redefining \cr and \crcr for setting \noalign. This needs +% redefining \@tabularcr etc.---not nice. We use this approach +% here for `longtable' which uses a stretching \tabskip. +% For \tabskip=0pt, we attach line numbers by a template. +% +% \RequirePackage{lineno}[2004/10/06] +% Wanted to check lineno version--causes unknown option error. +% See LaTeX bug latex/3730. + +% Options: + +%% TODO: underful page with `longtable.sty'!? +\let\if@ET@longtable\iffalse % \newif\if@ET@longtable@ +\DeclareOption{longtable}{\let\if@ET@longtable\iftrue} +\let\if@ET@ltabptch\iftrue +\DeclareOption{nolongtablepatch}{\let\if@ET@ltabptch\iffalse} +\ProcessOptions + +% Redefine \longtable if option: +\if@ET@longtable + % Stephan's direction for attaching a line number to each row + % is using \noalign in the course of \\. + % However, (1) the user should not worry about closing the table + % with \\ or without, and (2) the line number thing should not + % happen twice if \\ is the last token before \end{longtable}. + % Our solution: attach something to the beginning of \endlongtable + % which attaches line number unless an unsucceeded \\ has done it. + % This thing is activated by each row start and turned off by \\. + % Since the switch at row start may happen to be in a pbox, + % let it act globally on \endlongtable. (The \crcr at the beginning + % of \endlongtable must not be changed directly, since original + % \crcr may be required in table entries using \oalign etc.) + % + \RequirePackage{longtable}% +% \IfFileExists{longtable.sty}{\RequirePackage{longtable}}% +% {\RequirePackage{longtabl}}% +% For Atari problem, it suffices to rename `longtable.sty' +% into `longtabl.sty'. +% +% Patch for tools/3180 and tools/3485 of LaTeX bug database: + \if@ET@ltabptch + \IfFileExists{ltabptch.sty}{\RequirePackage{ltabptch}}{% + \PackageError{edtable}{% + ltabptch.sty (for improving spacing around\MessageBreak + longtable) missing! Be sure to use it always\MessageBreak + or never!% + }{% + To omit ltabptch.sty *and* escape this error,\MessageBreak + use package option `nolongtablepatch'.% + }% + } + \fi + \let\@ET@@longtable\longtable + \def\longtable{% + \ifLineNumbers + \expandafter\@ET@longtable + \else + \let\@ET@sw@cr\@ET@crcr % ... in \endlongtable. + \expandafter\@ET@@longtable + \fi + } + \def\@ET@longtable{% + % Since we have made it anyway, we use the method of redefining + % \halign for inserting the activating row start as well. + % However, redefinition must be repeated before every \LT@bchunk. + % \longtable and \LT@get@withs are good places for this. + \@ET@startlinewith\@ET@sw@cr@on + \@ET@trivialize@linelabel + \@ET@use@outerhook + \@ET@ampnotes + \let\LT@tabularcr\@ET@LT@tabularcr + \expandafter\def\expandafter\LT@get@widths\expandafter + {\LT@get@widths\@ET@startlinewith\@ET@sw@cr@on} + % Admittedly, we could make it less of a hack by using @{...} + % ---we could then leave \LT@get@widths untouched. + \@ET@@longtable + } + \def\@ET@sw@cr@on{\global\let\@ET@sw@cr\@ET@cr@attach} + % We are hacking a longtable version offering + % \def\LT@tabularcr{% + % \relax\iffalse{\fi\ifnum0=`}\fi + % \@ifstar + % {\def\crcr{\LT@crcr\noalign{\nobreak}}\let\cr\crcr + % \LT@t@bularcr}% + % {\LT@t@bularcr}} + % We need a redefinition of \cr which is not overridden by \@ifstar: + \def\@ET@LT@tabularcr{% + \relax\iffalse{\fi\ifnum0=`}\fi + \def\cr{\@ET@sw@cr}% + % So \crcr is affected by change of \@ET@sw@cr, cf. below. + \let\crcr\cr + \@ifstar + {\gdef\@ET@sw@nobreak{\nobreak + \global\let\@ET@sw@nobreak\relax}% + % {\def\cr{\@ET@sw@cr\noalign{\nobreak}}\let\cr\crcr + % Why didn't this work? %% TODO: try shorter again. + \LT@t@bularcr}% + \LT@t@bularcr + % {\let\cr\@ET@sw@cr \let\crcr\cr + % \LT@t@bularcr}% This accompanied \def\cr... above. + } + % Attach \@ET@sw@cr to beginning of \endlongtable: + \expandafter\def\expandafter\endlongtable\expandafter + {\expandafter\@ET@sw@cr\endlongtable} + \def\@ET@cr@attach{% Actually attaching line numbers. + \@ET@crcr\noalign{% Basically Stephan's approach. + % If we were not careful, following box containing line number + % could fool interline glue after longtable, even if tools/3485 + % is repaired in some way. This box should have same depth as + % the line composed previously. + \nobreak %% \@ET@ex... might cause page break. 2003/10/30. + \setbox\z@\@ET@makeLineNumber + \ht\z@-\prevdepth \dp\z@\prevdepth \box\z@ + \@ET@step@linenumber + \global\let\@ET@sw@cr\@ET@crcr % ... if called by \\. + % This also resets the \crcr starting \LT@echunk following + % \@xargarraycr or \@yargarraycr in \LT@argtabularcr. + % \let...\relax seems to suffice at well, but in case ... + \@ET@execute@outerhook %% 2003/10/30. + \@ET@sw@nobreak +% \@ET@execute@outerhook + }% + } + \let\@ET@crcr\crcr + \global\let\@ET@sw@nobreak\relax % Just to remind ... +\fi + +\let\@ET@step@linenumber\stepLineNumber +% \def\@ET@step@linenumber{\global\advance\c@linenumber\@ne} +\def\@ET@makeLineNumber{\hb@xt@\z@{\makeLineNumber}} +%% TODO: export to lineno.sty!? +% Special \halign: +% For `array' etc., we insert line numbers by a leftmost template. +% @{...} in the last argument of `array' etc. is difficult for this +% since `tabular*' has an additional argument. So we redefine +% \halign to put something to the right of the next \bgroup. +% Now, as a macro, \halign would break in an \edef or \xdef. +% Horribly, this danger has become quite real in longtable.sty's +% definition of \LT@bchunk. Only its latest version 4.10 has +% preceded \halign by a \noexpand (for mathtext.sty which +% redefines \halign as well). We need not rely on such a +% provision if we let \halign expand to \the<token register> +% for some token register. However, using \toks@ or \@temptokena +% is neither very safe---might be filled by macro ahead with +% something new. So reserve an own token register. +\newtoks\@ET@toks +\@ET@toks{\@ET@specialhalign} +% v1.3: In 'AMSmath', there are \halign's followed by explicit +% left braces. Thus '\def\@ET@specialhalign#1\bgroup{%' broke. +%% TODO ... +\def\@ET@specialhalign{% + \ifmeasuring@ \expandafter\@firstoftwo +% v1.3 2005/03/04, for `amsmath'. + \else \expandafter\@secondoftwo + \fi + {\let\halign\@ET@@halign \halign}% + {\@ifnextchar\bgroup\@ET@replace@arg\@ET@sphalign@to}} +%% TODO: change back, commenting out code above, report +%% error with `alignat'. +% \@ifnextchar\bgroup\@ET@replace@arg\@ET@sphalign@to} +% If `amsmath' not loaded (v1.3): +\AtBeginDocument{\@ifundefined{measuring@true}{% + \let\ifmeasuring@\iffalse}\relax} +\def\@ET@replace@arg#1{% + \def\@EN@tempa{#1}\def\@EN@tempb{\bgroup}% Corr. after v1.3b. + \ifx\@EN@tempa\@EN@tempb + \def\@EN@tempa{\@ET@sphalign@to\bgroup}% + \else + \def\@EN@tempa{\@ET@sphalign@to{#1}}% +% This may be wrong, #1 might be `t' from `to' ... + \fi + \@EN@tempa} +\def\@ET@sphalign@to#1\bgroup{% + \let\halign\@ET@@halign % Reset for nested arrays. + \halign#1\bgroup +% \ifmeasuring@\else % For `amsmath', moved backwards. + \@ET@startline % [Wizard interface, via \@ET@starlinewith.] +% \fi +} +% Wizard interface: +\def\@ET@startlinewith{% Next token precedes preamble. +% \let\@ET@@halign\halign % Or \AtBeginDocument? +% ... indeed: bad loop with long longtable (\LT@get@widths!?) + \def\halign{\the\@ET@toks}% + \let\@ET@startline +} +\AtBeginDocument{\let\@ET@@halign\halign} +% Or save it at start of environment only +% (don't repeat inside longtable). +% +% Outer hook for inserts: (wizard interface) +\def\@ET@execute@outerhook{% To be placed outside inner mode. + \@ET@outerhook \global\let\@ET@outerhook\@empty +} +\global\let\@ET@outerhook\@empty % Just to remind: global! +% \@EN@hookfn (ednotes) sends to outer hook: +\def\@ET@use@outerhook{% Wizard interface. + \def\@EN@hookfn{\g@addto@macro\@ET@outerhook}% +}%% TODO: move last line to `ednotes', \let\@ET@use...\@empty. +%% But this requires re-installing both packages +%% at the same time. See the `ampnotes' thing as well. +% +% Trivialize \linelabel: (wizard interface) +\def\@ET@trivialize@linelabel{\let\linelabel\@ET@linelabel} +\def\@ET@linelabel{% + \protected@edef\@currentlabel{\theLineNumber}% + \label +} +% Change ampersand at \Anote etc.: (wizard interface) +%% 2003/10/31. +% & is changed by \Anote etc. No \begin...\endgroup, +% next \\ or & after % note/donote command switches back. +% ---Global change seems to break table setup. +\begingroup +\gdef\@ET@hideamps{\catcode`\&\active} +\@ET@hideamps +\gdef\@ET@ampnotes{% + \let&\@ET@hideamp + %% & would be undefined after \\ in lemma. + \let\@ET@EN@rnote\@EN@note + \def\@EN@note{\@ET@hideamps\@ET@EN@rnote}% + \let\@ET@EN@rnotelb\@EN@notelabel + \def\@EN@notelabel{\@ET@hideamps\@ET@EN@rnotelb}% +} +%% TODO: & and \\ in \@EN@lemmaexpands!? +\endgroup +\def\@ET@hideamp{&} + +\newenvironment*{edtable}[2][]{% +% #1 $ or $$, #2 standard environment name. +%% TODO: star version!? cf. lineno.sty's `numquote'. + \def\@ET@mode{#1}% + \def\@ET@currenvir{#2}% + \ifhmode \ifnum\the\lastpenalty=-\@M\else +% \par must be executed for printing/stopping line numbers: + \@centercr\relax \noindent + \fi \fi + \ifvmode \noindent \fi % Otherwise linenumbers are indented +% -- however, not recommended. + \@ET@use@outerhook + \@ET@trivialize@linelabel + \@ET@ampnotes + \@ET@startlinewith\@ET@normal@startline + \global\advance\c@linenumber\m@ne % Stepping correction. +% (Must come after closing previous paragraph.) +% Calculate offset: + \global\advance\c@ET@array\@ne +% Saving/calling width of table (`longtable's algorithm). +% Test if there is \@flushglue on the left (center or flushleft): + \edef\@EN@tempa{\the\@flushglue}% +% ... v1.3: fool this for "$$". + \in@{$$}{#1\@nil}% \in@{#1}{#2} searches #1 in #2#1 ... + \edef\@EN@tempb{\the\ifin@\@flushglue\else\leftskip\fi}% + \ifx\@EN@tempa\@EN@tempb +% Assume \@ET@offset is 0pt else here. + \@ET@offset\linewidth + \advance\@ET@offset-% + \@ifundefined\@ET@arraywidth@csn % Shortened for v1.3. + {\linewidth\G@refundefinedtrue + \PackageWarningNoLine{edtab}{^^JLine numbers at + \@ET@currenvir\space need \jobname.aux}}% + {\csname\@ET@arraywidth@csn\endcsname}% +% Test if \@flushglue on the right (center): +% ... v1.3: fool it again. Repeat \in@ in case ... + \in@{$$}{#1\@nil}% + \edef\@EN@tempb{\the\ifin@\@flushglue\else\rightskip\fi}% + \ifx\@EN@tempa\@EN@tempb \divide\@ET@offset\tw@ \fi + \fi + \advance\@ET@offset\@totalleftmargin + \advance\@ET@offset\ETextraoffset % Offset ready. + \setbox\@tempboxa\hbox\bgroup +% v1.3: `alignat' complains later when this is \vbox instead. +% \vbox\bgroup % Tried in vain. + \ifx\@ET@mode\@empty\else $\fi + \csname#2\endcsname +}{% + \csname end\@ET@currenvir \endcsname + \ifx\@ET@mode\@empty\else $\fi + \egroup + \@ET@step@linenumber % Stepping correction. + \if@filesw + \immediate\write\@auxout{% + \gdef\expandafter\noexpand + \csname\@ET@arraywidth@csn\endcsname + {\the\wd\@tempboxa}}% +%% TODO: warning if changed!? + \fi +% No automatic line number at array line: + \nolinenumbers + \@ET@mode\ensuremath{\vcenter{\box\@tempboxa}}\@ET@mode % v1.3. + \@ET@execute@outerhook + \ifhmode \@centercr\relax \fi +% \par must be executed for proper restart of printing line numbers +% (think so). + \@endpetrue % Outside \@flushglue environment, avoid indent ahead. +%% TODO: slightly change for math mode around? Or give an error +%% in math mode. +} +%% TODO: make \edtable \outer!? +\def\@ET@normal@startline{% + \@ET@step@linenumber + \llap{\@ET@makeLineNumber \hskip\@ET@offset}% +} +\newdimen\@ET@offset +\newdimen\ETextraoffset +%% TODO: export to lineno.sty!? +\newcount\c@ET@array +\def\@ET@arraywidth@csn{ET@a@\romannumeral\c@ET@array} +% +%% TODO: .dtx +\endinput + +%% VERSION HISTORY: +v0.22 2003/01/13 First version, named `edtab02.sty', sent around, + together with ednotes.sty. +v0.23 2003/01/22 Added version history. +v0.24 2003/01/27 Copyright notice. +%%% v0.3 2003/03/03 Requires linenox0.sty. %% RETREATED +%% TODO: reconsider, see `lineno[x].sty'. +v0.25 2003/03/05 Added <ednotes.sty@web.de>. +v0.26 2003/03/23 Added \@ET@startlinewith to wizard command list; + moved redefinition \LT@get@widths from option code + into \@ET@longtable so this really happens in + line number mode only; moved \let\@ET@@halign\halign + from \@ET@startlinewith to \AtBeginDocument. +v0.27 2003/06/02 Added \ifvmode \noindent \fi to `edtable' definition; + 2003/06/10 added `lemma cannot run' to instructions. +v0.28 2003/10/31 \@ET@cr@attach: moved \@ET@execu..., added \nobreak. + Added \@ET@ampnotes and documentation: now working + across entries. +v1.0 2004/05/13 `ednotes.sty' etc., updated copyright. Renamed as + `edtable.sty' for TUGboat article. + \RequirePackage{lineno}, changed doc. accordingly. + Removed `may be released under different name'. +v1.10 2004/07/27 Looking for `longtabl.sty' for my Atari! + 2004/08/22 Added warning (screen/documentation) concerning + ltabptch.sty. + 2004/08/23 Added suggestion of option `nolongtablepatch'; + LPPL v1.3. +v1.2 2004/08/31 Rearranged preamble concerning maintenance, + removed `preliminary release'. + 2004/10/06 \newif -> \let...; option `nolongtablepatch'; + changed documentation accordingly and for + loading edtable.sty by lineno/ednotes option; + \let\@ET@step@linenumber\stepLineNumber; use + \ifLineNumbers. + 2004/10/07 Needed version numbers. + 2004/10/08 ltabptch warning -> error! + 2004/10/11 Disabled \RequirePackage{lineno}[...]; undid + the `longtabl.sty' thing from 2004/07/27. + 2004/10/12 latex/3730. +v1.2a 2004/11/07 LPPL v1.3a. +v1.2b 2005/01/10 Contact via http. +v1.3b 2005/03/04 Support for environments like `array' + environment. The description of `edtable' was + wrong in this respect! +v1.3 2005/03/07 Adaptations in documentation, and extended usage + instructions very much, correcting some + errors as well. Acknowledgement to M. B. +v1.3a 2005/03/09 Corrected numbering in `usage'. +v1.3c 2005/03/15 \@centercr\relax, TODO on math mode. + 2005/04/09 `editory' -> `editorial'. diff --git a/Master/texmf-dist/tex/latex/lineno/lineno.sty b/Master/texmf-dist/tex/latex/lineno/lineno.sty new file mode 100644 index 00000000000..f9cd1db616a --- /dev/null +++ b/Master/texmf-dist/tex/latex/lineno/lineno.sty @@ -0,0 +1,3441 @@ + \iffalse; awk '/S[H]ELL1/' lineno.sty|sh;exit; + ... see bottom for .tex documentation ... + +Macro file lineno.sty for LaTeX: attach line numbers, refer to them. + \fi +\def\fileversion{v4.32} \def\filedate{2005/10/17} %VERSION + +%%% Copyright 1995--2003 Stephan I. B"ottcher <boettcher@physik.uni-kiel.de>; +%%% Copyright 2002--2005 Uwe L"uck, http://www.contact-ednotes.sty.de.vu +%%% for version 4 and code from former Ednotes bundle +%%% --author-maintained. +%%% +%%% This file can be redistributed and/or modified under +%%% the terms of the LaTeX Project Public License; either +%%% version 1.3a of the License, or any later version. +%%% The latest version of this license is in +%%% http://www.latex-project.org/lppl.txt +%%% We did our best to help you, but there is NO WARRANTY. +% +%%% $Id: lineno.sty,v 3.14.2.2 2004/09/13 19:30:39 stephan Exp $ %% was v4.00. +% \title{\texttt{\itshape +%% %% (UL 2004/10/09:) Italic TT is evil +%% %% ... or nice front page layout!? +%% +% lineno.sty \ \fileversion\ \filedate +% \unskip}\\\ \\ +% A \LaTeX\ package to attach +% \\ line numbers to paragraphs +% \unskip}\author{% +% Stephan I. B\"ottcher +% \\ Uwe L\"uck +% \unskip}\date{% +% boettcher@physik.uni-kiel.de +% \\ http://contact-ednotes.sty.de.vu +%% \\ stephan@nevis.columbia.edu +%% \\ Stephan.Boettcher@cern.ch +% \\} +% +% \documentclass[a4paper,12pt]{article}%D +% \usepackage{lineno}%D +%% %% (New v4.00) +% \catcode`\_\active\let_~ +%% %% Beware math!? (/New v4.00) +% \def~{\verb~} +% \let\lessthan< +% \catcode`\<\active +% \def<#1>{$\langle${\itshape#1}\/$\rangle$} +% \catcode`\|\active +%% (New v4.1: \tt star; in box anyway.) +% \def|#1{\ttfamily\string#1} +%% \def|#1{{\ttfamily\string#1}} +%% (/New v4.1) +% \newenvironment{code} +% {\par\runninglinenumbers +% \modulolinenumbers[1]% +% \linenumbersep.3em +% \footnotesize +% \def\linenumberfont +% {\normalfont\tiny\itshape}} +% {} +%% %% (New v4.00) +% {\makeatletter \gdef\scs#1{\texttt +% {\protect\@backslashchar#1}}} +% \def\old{\par\footnotesize} +%% %% (/New v4.00) +%% %% (New v4.1) +% {\catcode`\/\active +% \gdef\path{\begingroup\catcode`\/\active +% \let/\slash\dopath} +% \gdef\dopath#1{\slash\unpenalty#1\endgroup}} +%% %% (/New v4.1) +% +% \begin{document}%D +%% \DocInput{lineno}%D +% \pagewiselinenumbers +% \maketitle +% \pagestyle{headings} +% \tableofcontents +% \sloppy +% +%% %% New v4.00: `...section{%' + \unskip +% \section{% +% Introductions +%% %% New v4.00: `s' +% \unskip} +% +% (New v4.00) Parts of former first section +% have been rendered separate subsections for package +% version_v4.00. (/New v4.00) +% +% \subsection{% +% Introduction to versions $\textrm{v}\lessthan4$ +% \unskip} +% +% This package provides line numbers on paragraphs. +% After \TeX\ has broken a paragraph into lines there will +% be line numbers attached to them, with the possibility to +% make references through the \LaTeX\ ~\ref~, ~\pageref~ +% cross reference mechanism. This includes four issues: +% \begin{itemize} +% \item attach a line number on each line, +% \item create references to a line number, +% \item control line numbering mode, +% \item count the lines and print the numbers. +% \end{itemize} +% The first two points are implemented through patches to +% the output routine. The third by redefining ~\par~, ~\@par~ +% and ~\@@par~. The counting is easy, as long as you want +% the line numbers run through the text. If they shall +% start over at the top of each page, the aux-file as well +% as \TeX s memory have to carry a load for each counted line. +% +% I wrote this package for my wife Petra, who needs it for +% transcriptions of interviews. This allows her to +% precisely refer to passages in the text. It works well +% together with ~\marginpar~s, but not too well with displaymath. +% ~\footnote~s are a problem, especially when they +% are split, but we may get there. +% (New v4.00 UL) Version v4.00 overcomes the problem, I believe. +% (/UL /New v4.00) +% +% lineno.sty works +% surprisingly well with other packages, for +% example, ~wrapfig.sty~. So please try if it +% works with whatever you need, and if it does, +% please tell me, and if it does not, tell me as +% well, so I can try to fix it. +% +% \subsection{% +% Introduction to versions v4.00ff. (UL) +% \unskip} +% +% ~lineno.sty~ has been maintained by Stephan until version_v3.14. +% From version_v4.00 onwards, maintenance is shifting towards +% Uwe L\"uck (UL), who is the author of v4\dots code and of v4\dots +% changes in documentation. This came about as follows. +% +% Since late 2002, Christian Tapp and Uwe L\"uck have employed +% ~lineno.sty~ for their ~ednotes.sty~, a package supporting +% critical editions---cf. +% \[\mbox{\tt +% http://ednotes.sty.de.vu +% \unskip}\] +% ---while you find ~ednotes.sty~ and surrounding files in +% CTAN folder \path{macros/latex/contrib/ednotes}. +% +% Soon, some weaknesses of ~lineno.sty~ showed up, mainly since +% Christian's critical editions (using ~ednotes.sty~) needed lots +% of ~\linelabel~s and footnotes. (These weaknesses are due to +% weaknesses of \LaTeX's ~\marginpar~ mechanism that Stephan +% used for ~\linelabel~.) So we changed some ~lineno.sty~ +% definitions in some extra files, which moreover offered new +% features. We sent these files to Stephan, hoping he would take +% the changes into ~lineno.sty~. However, he was too short of time. +% +% Writing a TUGboat article on Ednotes in 2004, we hoped to +% reduce the number of files in the Ednotes bundle and so asked +% Stephan again. Now he generously offered maintenance to me, so +% I could execute the changes on my own. +% +% The improvements are as follows: +% \begin{itemize}\item +% [(i)] Footnotes placement approaches intentions better +% (footnotes formerly liked to pile up at late pages). +% \item +% [(ii)] The number of ~\linelabel~s in one paragraph is no longer +% limited to 18. +% \item +% [(iii)] ~\pagebreak~, ~\nopagebreak~, ~\vspace~, and the star +% and optional versions of ~\\~ work as one would expect +% (section_\ref{s:MVadj}). %% Added for v4.1 +% \item +% [(iv)] A command is offered which chooses the first line number +% to be printed in the margin +% (subsection_\ref{ss:Mod}). %% Added for v4.1 +% \item +% [(v)] (New v4.1) \LaTeX\ tabular environments (optionally) +% get line numbers as well, and you can refer to them in the +% usual automatic way. (It may be considered a shortcoming that, +% precisely, \emph{rows} are numbered, not lines.---See +% subsection_\ref{ss:Tab}.) +% \item +% [(vi)] We are moving towards referring to math items +% (subsection_\ref{ss:MathRef} and the hooks in +% subsection_\ref{ss:LL}). +% (/New v4.1) +% \end{itemize} +% (Thanks to Stephan for making this possible!) +% +%% Unpublish: +%% You may trace the earlier developments of these changes by +%% requesting our files ~linenox0.sty~, ~linenox1.sty~, and +%% ~lnopatch.sty~. Most of our changes have been in ~linenox0.sty~. +%% Our ~linenox1.sty~ has extended ~linenox0.sty~ for one single +%% purpose in a not very stable way. +%%% (See ~\linenumberpar~ below). +%% ~lnopatch.sty~ has done the first line number thing referred +%% to in case_(iv) up to now. +%% (New v4.1) +%% Case_(v) earlier was provided by our ~edtab02.sty~---now +%% called ~edtable.sty~. +%% (/New v4.1) +% +% Ednotes moreover profits from Stephan's offer with regard +% to the documentation of our code which yielded these +% improvements formerly. This documentation now becomes +% printable, being part of the ~lineno.sty~ documentation. +% +% Of course, Stephan's previous ~lineno.sty~ versions were a great +% and ingenious work and exhibit greatest \TeX pertise. I never +% could have done this. I learnt a lot in studying the code when +% Christian pointed out strange output results and error +% messages, and there are still large portions of ~lineno.sty~ +% which I don't understand (consider only pagewise numbering of +% lines). Fortunately, Stephan has offered future help if +% needed.---My code for attaching line numbers to \emph{tabular +% environments} (as mentioned above, now still in +% ~edtable.sty~) %% %% TODO +% developed from macros which Stephan and Christian experimented +% with in December 2002. Stephan built the basics. +% (However, I then became too proud to follow his advice only to +% use and modify ~longtable.sty~.) +% +% There are some issues concerning use of counters on which I +% don't agree with Stephan and where I would like to change the +% code if ~lineno.sty~ is ``mine'' as Stephan offered. However, +% Stephan is afraid of compatibility problems from which, in +% particular, his wife could suffer in the near future. So he +% demanded that I change as little as possible for my first +% version. Instead of executing changes that I plan I just offer +% my opinions at the single occasions. I hope to get in touch +% this way with users who consider subtle features vital which I +% consider strange. +% +% On the other hand, the sections on improvements of the +% implementation have been blown up very much and may be tiring +% and litte understandable for mere \emph{users}. These users +% may profit from the present presentation just by jumping to +% sections_\ref{s:Opts} and_\ref{s:UserCmds}. There is a user's +% guide ulineno.tex which may be even more helpful, but it has +% not been updated for a while. %% TODO +% +% \subsection{% +% Availability +% \unskip} +% +% In case you have found the present file otherwise than from +% CTAN: A recent version and documentation of this package +% should be available from CTAN folder +% \path{macros/latex/contrib/lineno}. +% Or mail to one of the addresses at top of file. +% +% \subsection{% +% Introductory code +% \unskip} +% +% This style option is written for \LaTeXe, November 1994 or later, +% since we need the ~\protected@write~ macro. +% +% (New v4.00) And we use ~\newcommand*~ for +% controlling length of user macro arguments, which has been +% available since December 1994. +%% + +\NeedsTeXFormat{LaTeX2e}[1994/12/01] +%% [1994/11/04] +\ProvidesPackage{lineno} + [\filedate\space line numbers on paragraphs \fileversion] +% (/New v4.00) +%% +%% History of versions: +%% v1.00 1995/03/31 SIB: first release for Petra's interview transcriptions +%% v1.01 1995/10/28 SIB: added ~pagewise~ mode +%% v1.02 1995/11/15 SIB: added ~modulo~ option +%% v1.03 1995/12/05 SIB: pagewise: try to reduce the hash-size requirements +%% v2.00 1995/12/06 SIB: .. it works, new user interface +%% v2.01 1996/09/17 SIB: put into CVS +%% v2.02 1997/03/17 SIB: add: \@reinserts, for footnotes +%% v2.04 1998/03/09 SIB: add: linenomath environment +%% v2.05 1998/04/26 SIB: add: prevgraf test +%% v2.06 1999/03/02 SIB: LPPL added +%% v3.00 1999/06/11 SiB: include the extension in the main file +%% v3.01 1999/08/28 SiB: \@reinserts -> \holdinginserts +%% v3.02 2000/03/10 SiB: \@LN@output +%% v3.03 2000/07/01 SiB: \@LN@ExtraLabelItems, hyperref +%% v3.04 2000/12/17 SiB: longtable compatibility. +%% v3.05 2001/01/02 SiB: [fleqn] detection. +%% v3.05a 2001/01/04 SiB: [fleqn] detection reverted for eqnarray. +%% v3.06 2001/01/17 SiB: [twocolumn] mode support. +%% v3.07 2001/07/30 SiB: [hyperref] option obsoleted. +%% v3.08 2001/08/02 SiB: linenomath wrapping for \[ \] +%% v3.08a 2001/08/04 SiB: linenomath wrapping for \[ \] fixed +%% v3.08b 2002/01/27 SiB: enquotation typo fix +%% v3.09 2003/01/14 SIB: hyperref detection fix +%% v3.10 2003/04/15 FMi: \MakeLineNo fix for deep boxes +%% v3.10a 2003/11/12 Uwe Lück: \lineref typo fix +%% v4.00 2004/09/02 UL: included linenox0, linenox1, lnopatch code with +%% documentation, usually indicated by `New v4.00'; +%% discussions of old code, indicated by `UL'; +%% LPPL v.1 -> LPPL v1.3, `program' -> `file'; +%% first lines with \filedate and \fileversion, +%% according nawk lines; `November 1994 or later', +%% some earlier documentation typos (including a few +%% bad minus signs), { -> {% and } -> \unskip} at +%% line ends (so, e.g., alignment in TOC works); \scs. +%% 2004/09/03 UL: removed everything which indicated that the +%% present file were named `lineno4.sty'. +%% v4.1 2004/09/19 UL: Inserted Stephan's identification line, removed +%% some TODOs and remarks from v4.00. +%% 2004/10/04 UL: Added acknowledgement for Daniel Doherty; +%% `(New v4.00)' with [|\firstlinenumber]; changed +%% TODOs; Refining -> Redefining (\vadjust). +%% 2004/10/05 UL: ednmath0 -> mathrefs; \catcode`\~ -> \active; +%% \path; refined section on options `mathrefs'; +%% changes in introduction. +%% 2004/10/06 UL: Changed/removed TODOs, e.g., for edtable.sty. +%% 2004/10/11 UL: Reminders: linenox0/1/lnopatch.sty obsolete; +%% \tt star in list of commands. +%% 2004/10/12 UL: Corrected blank lines in lineno.tex. +%% 2004/10/19 UL: Fixed minor typos; remark on \if@LN@edtable. +%% v4.1a 2004/11/07 UL: LPPL v1.3a. +%% v4.1b 2004/11/13 UL: Comment on \outputpenalty values. +%% v4.1c 2005/01/10 UL: Contact via http. +%% v4.11 2005/02/20 UL: Error message with \linelabel when not numbering. +%% 2005/03/07 UL: Removed \linelabel from ss:Tab heading, consider +%% marginal line numbers as well, revised ss:Tab. +%% Added a few lines on missing explanations to +%% s:UserCmds. Corrected some code alignments. +%% 2005/03/08 UL: Require recent edtable.sty. +%% + +%% v4.2 2005/03/21 UL: "Physical page" counter works with \include. +%% 2005/04/17 UL: Raised options section above extensions section +%% (v4.00 disabled `displaymath' option); +%% third arg for \@ifundefined{mathindent}; +%% "bunch of options"; +%% 2005/04/24 UL: compatibility with tamefloats; vplref.sty. +%% 2005/04/25 UL: \number -> \the; wondered -> $$; subsec. appbas; +%% CrtlLN sec -> subsec.; \newcommand* wherever ...; +%% doc. on `other output routines' and `addpageno' +%% (this changed from `varioref'). +%% 2005/04/27 UL: =1\relax -> =\@ne, 0\relax ..., \hb@xt@, +%% \ifx\@@par\@@@par -> \ifLineNumbers, typos, +%% \pagestyle{headings}, LaTeX -> \LaTeX. +%% v4.21 2005/04/28 UL: linenomath section: removed wrong \else's, +%% \holding...: \thr@@, \@LN@outer@holdins, \global. +%% v4.22 2005/05/01 UL: \unvbox\@outputbox; \@LN@col without #1, +%% 2005/05/08 UL: global/local \internall..., \resetl... global, +%% shortened discussions of this and of \newcounter. +%% 2005/05/09 UL: corr.: doc. typo, version history, bad lines; +%% percent; \chardef for modulo, +%% \value{firstlinenumber}. +%% v4.3 2005/05/10 UL: \@backslashchar -> \char`\\ in \scs. +%% 2005/05/11 UL: \linenumbers sets ...outer@holdins; tidied up +%% documentation regarding earlier versions. +%% 2005/05/12 UL: `linenomath' without spurious number above; +%% `displaymath' default; edmac homepage -> +%% ednotes.sty.de.vu, \endlinenomath without +%% numbers: no change of \holdinginserts; +%% \linelabel doesn't go to .aux or mark, +%% hyperref detected; undone 2005/05/10 (bad mark). +%% 2005/05/13 UL: Reworked hyperref detection (new subsec.). +%% 2005/05/15 UL: More typo fixes, corrected terrible confusions in +%% the discussion (v4.22/v4.3) of \new/\stepcounter; +%% new subsec. in `Line number ...'; another +%% implementation of `hyperref' detection. +%% 2005/05/16 UL: Final minor changes. +%% v4.31b /06/14 UL: Extended explanation of \firstlinenumbers +%% and package options; \@LN@ifgreat@critical; +%% \modulolinenumbers*. Sent to Ednotes.news only. +%% v4.31 2005/06/15 UL: \modulolinenumbers* with \firstlinenumber{1}; +%% " -> ``/''; more doc. on \firstlinenumber . +%% 2005/06/20 UL: Typo fix. +%% 2005/10/01 UL: Warning about \mod...* with pagewise mode. +%% v4.31a /10/02 UL: Minor changes of appearance of doc., e.g., +%% \[ for $$. +%% v4.32b /10/15 UL: Support for \addvspace; removed comments that +%% had been invisible already for some time; +%% made clear with which environments the +%% linenomath environment is not needed. +%% v4.32ab /10/15 UL: Observe \if@nobreak with support for \addvspace. +%% v4.32 2005/10/17 UL: Just made it official and sent it to CTAN. +%% +%% Acknowledgements: +%% v3.06: Donald Arseneau, pointed to mparhack.sty. +%% v3.07+: Frank Mittelbach, points out inconsistencies in the +%% user interface. +%% v3.10: Frank Mittelbach \MakeLineNo fix for deep boxes +%% v4.00: Daniel Doherty points out clash of \pagewise... with resetting +%% page number. +%% v4.21: Much testing work by Erik Luijten. +%% v4.3: `displaymath' default by Erik Luijten's suggestion. +%% v4.31: \modulolinenumbers* is an idea of Hillel Chayim Yisraeli's. +%% v4.32: Support for \addvspace due to Saravanan M.'s observation. +% +% \section{% +% Put the line numbers to the lines +% \unskip} +% +% (New v4.00) This section contained the most +% basic package code previously. For various purposes of +% version_4\dots, much of these basics have been to be modified. +% Much of my (UL's) reasoning on these modifications has been to +% be reported. Sorry, the present section has been blown up +% awfully thus and contains ramifications that may be difficult +% to trace. We add some ~\subsection~ commands in order to cope +% with the new situation. (/New v4.00) +% +% \subsection{% +% Basic code of \texttt{lineno.sty} \scs{output} +% \unskip}\label{ss:output} +% +% The line numbers have to be attached by the output +% routine. We simply set the ~\interlinepenalty~ to $-100000$. +% The output routine will be called after each line in the +% paragraph, except the last, where we trigger by ~\par~. +% The ~\linenopenalty~ is small enough to compensate a bunch of +% penalties (e.g., with ~\samepage~). +% +% (New v3.04) Longtable uses +% ~\penalty~$-30000$. The lineno penalty range was +% shrunk to $-188000 \dots -32000$. (/New v3.04) +% (New v4.00) New values are listed below (11111f.). (/New v4.00) + +\newcount\linenopenalty\linenopenalty=-100000 + +%% TODO v4.3+: +% (UL) Hm. It is never needed below +% that this is a counter. ~\def\linenopenalty{-100000\relax}~ +% would do. (I guess this consumes more memory, but it +% is more important to save counters than to save memory.) +% I was frightened by ~-\linenopenalty~ below, but indeed +% \TeX\ interprets the string ~--100000~ as 100000. +% Has any user or extension package writer ever called +% ~\linenopenalty=xxx~, or could I really change this?---The +% counter is somewhat faster than the macro. Together with the +% compatibility question this seems to support keeping the +% counter. (???) +%% Note that Stephan chose ~\mathchardef~ below, +%% so his choice above seems to have been deliberate. +%% <- no point, \mathchardef token is fast. +% (/UL) + +\mathchardef\linenopenaltypar=32000 + +% So let's make a hook to ~\output~, the direct way. The \LaTeX\ +% macro ~\@reinserts~ puts the footnotes back on the page. +% +% (New v3.01) ~\@reinserts~ badly +% screws up split footnotes. The bottom part is +% still on the recent contributions list, and the +% top part will be put back there after the bottom +% part. Thus, since lineno.sty does not play well +% with ~\inserts~ anyway, we can safely experiment +% with ~\holdinginserts~, without making things +% much worse. +% +% Or that's what I thought, but: Just activating +% ~\holdinginserts~ while doing the ~\par~ will +% not do the trick: The ~\output~ routine may be +% called for a real page break before all line +% numbers are done, and how can we get control +% over ~\holdinginserts~ at that point? +% +% Let's try this: When the ~\output~ routine is +% run with ~\holdinginserts=3~ for a real page +% break, then we reset ~\holdinginserts~ and +% restart ~\output~. +% +% Then, again, how do we keep the remaining +% ~\inserts~ while doing further line numbers? +% +% If we find ~\holdinginserts~=$-3$ we activate it again +% after doing ~\output~. (/New v3.01) +% +% (New v3.02) To work with +% multicol.sty, the original output routine is now +% called indirectly, instead of being replaced. +% When multicol.sty changes ~\output~, it is a +% toks register, not the real thing. (/New v3.02) +% +% (New v4.00) Two further complications are added. +%% +%% TODO v4.3+: Or three, ~\@nobreakfalse~ after ~\MakeLineNo~ +%% for getting rid of ~\my@nopagebreak~. +% \begin{itemize}\item +% [(i)] Problems with footnotes formerly resulted from +% \LaTeX's ~\@reinserts~ in ~\@specialoutput~ which Stephan's +% ~\linelabel~ called via the ~\marginpar~ mechanism. +% \item +% [(ii)] \LaTeX\ commands using ~\vadjust~ formerly didn't work +% as one would have hoped. The problem is as follows: +% Printing the line number results from +% a box that the output routine inserts at the place of the +% ~\interlinepenalty~. ~\vadjust~ items appear \emph{above} the +% ~\interlinepenalty~ (\TeX book p._105). So ~\pagebreak~, e.g., +% formerly sent the line number to the next page, while the +% penalty from ~\nopagebreak~ could not tie the following line, +% since it was screened off by the line number box.---Our trick +% is putting the ~\vadjust~ items into a list macro from which +% the output routine transfers them into the vertical list, +% below the line number box. +% \end{itemize} +% In this case_(ii), like in case_(i), footnotes would suffer +% if ~\holdinginserts~ were non-positive. Indeed, in both +% cases_(i) and_(ii) we tackle the footnote problem by extending +% that part of Stephan's output routine that is active when +% ~\holdinginserts~ is positive. This extension writes the line +% number ~\newlabel~ to the .aux file (which was formerly done +% under $~\holdinginserts~=-3$) and handles the ~\vadjust~ +% items.---To trigger ~\output~ and its ~\linelabel~ or, resp., +% ~\vadjust~ part, the list of signal penalties started +% immediately before is increased here (first for ~\linelabel~, +% second for postponed ~\vadjust~ items): + +\mathchardef\@Mllbcodepen=11111 +\mathchardef\@Mppvacodepen=11112 + +% (/New v4.00) (New v4.2) David Kastrup urges to use a private +% name instead of ~\the\output~ (LaTeX-L-list). Otherwise an +% ~\output~ routine loaded later and using ~\newtoks\output~ +% again may get lost entirely. So we change use of ~\@LN@output~, +% using it for the former purpose. Reference to what appeared +% with the name of ~\output~ here lasts for a few lines and then +% is given away. + +\let\@tempa\output +\newtoks\output +\let\@LN@output\output +\output=\expandafter{\the\@tempa} + +% Now we add two cases to Stephan's output routine. (New v4.00) + +\@tempa={% +% (/New 4.2) + \LineNoTest + \if@tempswa +%% +%% (UL) Learnt that even in def.s blank line means ~\par~. +%% to leave visual space in present file with having a +%% blank line neither in present nor in .tex file, +%% use double comment mark (`%%'). (/UL) +%% +% (New v4.00) +% We insert recognition of waiting ~\linelabel~ items--- +%% + \ifnum\outputpenalty=-\@Mllbcodepen + \WriteLineNo +%% +% ---and of waiting ~\vadjust~ items: +%% + \else + \ifnum\outputpenalty=-\@Mppvacodepen + \PassVadjustList + \else +%% +%% Now we give control back to Stephan. +% (/New v4.00) (New v4.2) Outsource ``Standard'' output +% ---which occurs so rarely---to subsection_\ref{ss:LLO}: +%% + \LineNoLaTeXOutput +% (/New v4.2) (New v4.00) +% Two new ~\fi~s for the ~\linelabel~ and ~\vadjust~ tests--- +%% + \fi + \fi +%% +% ---and the remaining is +%%%next three lines are +% Stephan's code again: +% (/New v4.00) +%% + \else + \MakeLineNo + \fi + } + +% (New v4.00) Our new macros +% ~\WriteLineNo~ and ~\PassVadjustList~ will be dealt with in +% sections_\ref{s:LNref} and_\ref{ss:PVadj}. (/New v4.00) +% +% \subsection{% +% \scs{LineNoTest} +% \unskip} +% +% The float mechanism inserts ~\interlinepenalty~s during +% ~\output~. So carefully reset it before going on. Else +% we get doubled line numbers on every float placed in +% horizontal mode, e.g, from ~\linelabel~. +% +% Sorry, neither a ~\linelabel~ nor a ~\marginpar~ should +% insert a penalty, else the following linenumber +% could go to the next page. Nor should any other +% float. So let us suppress the ~\interlinepenalty~ +% altogether with the ~\@nobreak~ switch. +% +% Since (ltspace.dtx, v1.2p)[1996/07/26], the ~\@nobreaktrue~ does +% it's job globally. We need to do it locally here. + +\def\LineNoTest{% + \let\@@par\@@@par + \ifnum\interlinepenalty<-\linenopenaltypar + \advance\interlinepenalty-\linenopenalty + \my@nobreaktrue + \fi + \@tempswatrue + \ifnum\outputpenalty>-\linenopenaltypar\else + \ifnum\outputpenalty>-188000\relax + \@tempswafalse + \fi + \fi + } + +\def\my@nobreaktrue{\let\if@nobreak\iftrue} + +% (UL) I would prefer ~\@LN@nobreaktrue~.---I thought here were +% another case of the save stack problem explained in \TeX book, +% p._301, namely through both local and global changing +% ~\if@nobreak~. However, ~\my@nobreak~ is called during +% ~\@LN@output~ only, while ~\@nobreaktrue~ is called by \LaTeX's +% ~\@startsection~ only. The latter never happens during +% ~\@LN@output~. So there is no local value of ~\if@nobreak~ on +% save stack when ~\@nobreaktrue~ acts, since ~\the\@LN@output~ +% (where ~\@LN@output~ is a new name for the original ~\output~) +% is executed within a group (\TeX book p._21). +%% +%% 2004/09/19 Removed nonsense here according to Stephan 2004/09/04. +%% +% (/UL) +% +% \subsection{% +% Other output routines (v4.2) +% \unskip}\label{ss:LLO} +% +% I had thought of dealing with bad interference of footnotes +% (and ~\enlargethispage~) with (real) ~\marginpar~s and floats +% \emph{here}. Yet this is done in +% \[ +% ~http://~\mbox{[CTAN]} +% ~/macros/latex/contrib/tamefloats/tameflts.sty~ +% \] +% now, and I prefer striving for compatibility with the latter. +% (See there for expanding on the problem.) +% This requires returning the special absolute value of +% ~\holdinginserts~ that ~lineno.sty~ finds at the end of a newly +% typeset paragraph---now done in subsection_\ref{ss:CtrlLN} +% (~\linenumberpar~). +% The former ~\LineNoHoldInsertsTest~ has been filled into here. +%% ---`3' is replaced by ~\thr@@~ for a while. ~\thr@@~ is +%% useful practice since plain \TeX, but Stephan may have been +%% wise in suspecting that \LaTeX\ once could forsake ~\thr@@~. +%% The same holds for ~\@M=10000~. +% Note: when the following code is invoked, we have +% ~\if@tempswa~_ =_~\iftrue~. +% WARNING: I am still not sure whether the present code is good +% for cooperating with other packages that use ~\holdinginserts~. + +\def\LineNoLaTeXOutput{% + \ifnum \holdinginserts=\thr@@ \@tempswafalse \fi +%% <- Previous ~\LineNoHoldInsertsTest~. + \if@tempswa + \if@twocolumn \let\@makecol\@LN@makecol \fi + \the\@LN@output % finally following David Kastrup's advice. + \ifnum \holdinginserts=-\thr@@ + \global\holdinginserts\thr@@ \fi + \else + \global\holdinginserts-\thr@@ + \unvbox\@cclv + \ifnum \outputpenalty=\@M \else \penalty\outputpenalty \fi + \fi +} + +% \textit{More on dealing with output routines from other +% packages:} +% Since ~lineno.sty~'s output routine is called at least once +% for each output line, I think it should be in \TeX's +% original ~\output~, while output routines dealing with +% building pages and with floats etc.\ should be filled into +% registers addressed by ~\output~ after ~\newtoks\output~. +% Therefore \begin{enumerate} +% \item +% ~tameflts.sty~ should be loaded \emph{after} ~lineno.sty~; +% \item +% if a class changes ~\output~ (APS journal class revtex4, +% e.g.), ~lineno.sty~ should be loaded by ~\RequirePackage~ +% [here presumably following some options in +% brackets]~{lineno}~ \emph{preceding} ~\documentclass~. +% \item +% If you actually maintain such a class, please consider +% loading ~lineno.sty~ on some draft option. The bunch of +% lineno's package options may be a problem, but perhaps the +% purpose of your class is offering only very few of lineno's +% options anyway, maybe just one. +% \end{enumerate} +% The latter may also be needed with classes that don't follow +% David Kastrup's rule on changing ~\output~. +% +% \subsection{% +% \scs{MakeLineNo}: Actually attach line number +% \unskip}\label{ss:MLN} +% +% We have to return all the page to the current page, and +% add a box with the line number, without adding +% breakpoints, glue or space. The depth of our line number +% should be equal to the previous depth of the page, in +% case the page breaks here, and the box has to be moved up +% by that depth. +% +% The ~\interlinepenalty~ comes after the ~\vadjust~ from a +% ~\linelabel~, so we increment the line number \emph{after} +% printing it. The macro ~\makeLineNumber~ produces the +% text of the line number, see section \ref{appearance}. +% +% (UL) I needed a while to understand +% the sentence on incrementing. Correctly: writing the +% ~\newlabel~ to the .aux file is triggered by the signal +% penalty that ~\end@float~ inserts via ~\vadjust~. +% However, this could be changed by our new ~\PostponeVadjust~. +% After ~\c@linenumber~ has been introduced as a \LaTeX\ +% counter, it might be preferable that it behaved like standard +% \LaTeX\ counters which are incremented shortly before printing. +% But this may be of little practical relevance in this case, +% as ~\c@linenumber~ is driven in a very non-standard +% way.---However still, this behaviour of ~\c@linenumber~ +% generates a problem with our ~edtable.sty~. +%% \unskip---Before, +%% I thought that Stephan had reported his reasoning incorrectly +%% and rather did this because of his ~\resetlinenumber~ which +%% initializes ~\c@linenumber~ to 1 instead of 0---the latter is +%% usual with \LaTeX\ counters. Cf._additional comment at +%% ~\resetlinenumber~. +% (/UL). +% +% Finally we put in the natural ~\interlinepenalty~, except +% after the last line. +% +% (New v3.10) Frank Mittelbach points out that box255 may be +% less deep than the last box inside, so he proposes to +% measure the page depth with ~\boxmaxdepth=\maxdimen~. +% (/New v3.10) +% +% (UL, New v4.00) We also resume the matter of +% ~\vadjust~ items that was started in section_\ref{ss:output}. +% +% \TeX\ puts only nonzero interline +% penalties into the vertical list (\TeX book p._105), while +% ~lineno.sty~ formerly replaced the signal interline penalty by +% something closing with an explicit penalty of the value that +% the interline penalty would have without ~lineno.sty~. +% This is usually 0. Now, explicit vertical penalties can be +% very nasty with respect to ~\nopagebreak~, e.g., a low (even +% positive) ~\widowpenalty~ may force a widow where you +% explicitly tried to forbid it by ~\nopagebreak~ +% (see explanation soon below). +% The ~\nopagebreak~ we create here would never work if all +% those zero penalties were present.---On +% the other hand, we cannot just omit Stephan's zero penalties, +% because \TeX\ puts a penalty of 10000 after what ~lineno.sty~ +% inserts (\TeX book p._125). This penalty must be overridden +% to allow page breaks between ordinary lines. To revive +% ~\nopagebreak~, we therefore replace those zero (or low) +% penalties by penalties that the user demanded by +% ~\nopagebreak~.---This mechanism is not perfect and does not +% exactly restore the original \LaTeX\ working of ~\pagebreak~ +% and ~\nopagebreak~. Viz., if there are several vertical +% penalties after a line which were produced by closely sitting +% ~\[no]pagebreak~s, without ~lineno.sty~ the lowest penalty would +% be effective (cf._\TeX book exercise_14.10). Our mechanism, by +% contrast, chooses the \emph{last} user-set penalty of the line +% as the effective one. It would not be very difficult to come +% more close to the original mechanism, but until someone urges +% us we will cling to the present simple way. You may consider an +% advantage of the difference between our mechanism and the +% original one that the user here can actually override low +% penalties by ~\nopagebreak~, which may be what a lay \LaTeX\ +% user would expect.---Zero glue would do instead of zero +% penalty! This could make things easier. Maybe next time. %% TODO v4.3+ +% (/UL, /New v4.00) + +\def\MakeLineNo{% + \@LN@maybe@normalLineNumber % v4.31 + \boxmaxdepth\maxdimen\setbox\z@\vbox{\unvbox\@cclv}% + \@tempdima\dp\z@ \unvbox\z@ + \sbox\@tempboxa{\hb@xt@\z@{\makeLineNumber}}% +%% +% (New v4.00) Previously, +% \begin{old}\begin{verbatim} +% % \stepcounter{linenumber}% +% \end{verbatim} +% \end{old} +%% %% TODO: Still first `\begin{old}'? +% followed. (Of course, there was no +% comment mark; I put it there to make +% reading the actual code easy.) +% +% (New v4.22: improved) Why not just +% \[~\global\advance\c@linenumber\@ne~?\] +% ~\stepcounter~ additionally resets ``subordinate'' +% counters, but which could these (usefully) be? +% Again, may be column counters with ~edtable.sty~!? +% +% But then, our ~edtable.sty~ and its ~longtable~ option +% should use it as well. So use a shorthand supporting +% uniformity. You can even use it as a hook for choosing +% ~\global\advance\c@linenumber\@ne~ instead of our choice. +% (/New v4.22) +%% + \stepLineNumber +%% +% (/New v4.00) +%% + \dp\@tempboxa=\@tempdima\ht\@tempboxa=\z@ + \nointerlineskip\kern-\@tempdima\box\@tempboxa +%% +% (New v4.00) +% The line number has now been placed (it may be invisible +% depending on the modulo feature), so we can insert the +% ~\vadjust~ items. We cannot do this much later, because +% their right place is above the artificial interline +% penalty which Stephan's code will soon insert +% (cf._\TeX book p._105). The next command is just ~\relax~ +% if no ~\vadjust~ items have been accumulated for the +% current line. Otherwise it is a list macro inserting +% the ~\vadjust~ items and finally resetting itself. +% (This is made in section_\ref{ss:PVadj} below.) +% If the final item is a penalty, it is stored so it can +% compete with other things about page breaking. +%% + \@LN@do@vadjusts + \count@\lastpenalty +%% +% At this place, +% \begin{old}\begin{verbatim} +% % \ifnum\outputpenalty=-\linenopenaltypar\else +% \end{verbatim} +% \end{old} +% originally followed. We need something \emph{before} the +% ~\else~: +%% + \ifnum\outputpenalty=-\linenopenaltypar + \ifnum\count@=\z@ \else +%% +% So final ~\pagebreak[0]~ or ~\nopagebreak[0]~ has no +% effect---but this will make a difference after headings only, +% where nobody should place such a thing anyway. +%% + \xdef\@LN@parpgbrk{\penalty\the\count@ + \gdef\noexpand\@LN@parpgbrk{\kern\z@}}% +%% %% TODO v4.3+: Stephan's advice +%% -- but this happens rarely. +% That penalty will replace former ~\kern\z@~ in +% ~\linenumberpar~, see subsection_\ref{ss:CtrlLN}.---A +% few days earlier, I tried to send just a penalty value. +% However, the ~\kern\z@~ in ~\linenumberpar~ is crucial, +% as I then found out. See below.---The final penalty is +% repeated, but this does no harm. (It would not be very +% difficult to avoid the repeating, but it may even be +% less efficient.) It may be repeated due to the previous +% ~\xdef~, but it may be repeated as well below in the +% present macro where artificial interline penalty is to +% be overridden. +%% + \fi + \else +%% +% (/New v4.00) +%% Corrected code alignment with v4.11. + \@tempcnta\outputpenalty + \advance\@tempcnta -\linenopenalty +%% +% (New v4.00) +% \begin{old}\begin{verbatim} +% % \penalty\@tempcnta +% \end{verbatim} +% \end{old} +% followed previously. To give ~\nopagebreak~ a chance, +% we do +%% Corrected code alignment with v4.11. + \penalty \ifnum\count@<\@tempcnta \@tempcnta \else \count@ \fi +%% +% instead.---In ~linenox0.sty~, the ~\else~ thing once was omitted. +% Sergei Mariev's complaint (thanks!) showed that it is vital +% (see comment before ~\MakeLineNo~). +% The remaining ~\fi~ from previous package version closes the +% ~\ifnum\outputpenalty~\dots +% (/New v4.00) +%% + \fi + } + +% (New v4.00) + +\newcommand\stepLineNumber{\stepcounter{linenumber}} + +% For reason, see use above. (/New v4.00) +%% %% TODO v4.3+: ~\newcommand~ more often!? +% +% \section{% +% Control line numbering +% \unskip} +% \subsection{% +% Basic code %% own subsec. v4.2. +% \unskip}\label{ss:CtrlLN} +% The line numbering is controlled via ~\par~. \LaTeX\ +% saved the \TeX-primitive ~\par~ in ~\@@par~. We push it +% one level further out, and redefine ~\@@par~ to insert +% the ~\interlinepenalty~ needed to trigger the +% line numbering. And we need to allow pagebreaks after a +% paragraph. +% +% New (2.05beta): the prevgraf test. A paragraph that ends with a +% displayed equation, a ~\noindent\par~ or ~wrapfig.sty~ produce empty +% paragraphs. These should not get a spurious line number via +% ~\linenopenaltypar~. + +\let\@@@par\@@par +\newcount\linenoprevgraf + +% (UL) And needs ~\linenoprevgraf~ +% to be a counter? Perhaps there may be a paragraph having +% thousands of lines, so ~\mathchardef~ doesn't suffice (really??). +%% +%% %% TODO: limitations of lines per paragraph elsewhere? +%% %% Signal penalties, e.g.!? ~\deadcycles~!? +%% +% A macro ending on ~\relax~ might suffice, but would be +% somewhat slow. I think I will use ~\mathchardef~ next time. +% Or has any user used ~\linenoprevgraf~? (/UL) + +\def\linenumberpar{\ifvmode\@@@par\else\ifinner\@@@par\else + \xdef\@LN@outer@holdins{\the\holdinginserts}% v4.2 + \advance\interlinepenalty \linenopenalty + \linenoprevgraf\prevgraf + \global\holdinginserts\thr@@ + \@@@par +%% +% (New v4.32) +% A ~\belowdisplayskip~ may be here when the paragraph ends on a +% display-math; or there may be a ~\topsep~ from a list, etc. +% ~\addvspace~ couldn't take account for it unless we move that +% skip down: +%% + \skip@\lastskip + \if@nobreak \nobreak \fi \vskip-\skip@ +%% +% (/New v4.32) +%% + \ifnum\prevgraf>\linenoprevgraf + \penalty-\linenopenaltypar + \fi +%% +% (New v4.00) +% \begin{old}\begin{verbatim} +% % \kern\z@ +% \end{verbatim} +% \end{old} +% was here previously. What for? +% According to \TeX book p._125, Stephan's +% interline penalty is changed into 10000. At the end of a +% paragraph, the ~\parskip~ would follow that penalty of 10000, +% so there could be a page break neither at the +% ~\parskip~ nor at the ~\baselineskip~ (\TeX book p. 110)---so +% there could never be a page break between two paragraphs. +% So something must screen off the 10000 penalty. +% Indeed, the ~\kern~ is a place to break. +% (Stephan once knew this: see `allow pagebreaks' above.) +% +% Formerly, I tried to replace ~\kern\z@~ by +% \begin{old}\begin{verbatim} +% % \penalty\@LN@parpgpen\relax +% \end{verbatim} +% \end{old} +% ---but this allows a page break after heading. So: +%% + \@LN@parpgbrk + \if@nobreak \nobreak \fi \vskip\skip@ % v4.32 +%% +% After heading, ~\kern\z@~ resulting from previous line +% (see below) is followed by ~\write~ or ~\penalty10000~, +% so causes no page break. +% +% These and similar changes were formerly done by ~linenox1.sty~. +% (/New v4.00) +%% + \global\holdinginserts\@LN@outer@holdins % v4.2 + \advance\interlinepenalty -\linenopenalty + \fi\fi} + +% (New v4.00) Initialize ~\@LN@parpgbrk~: + +\gdef\@LN@parpgbrk{\kern\z@} + +% (/New v4.00) +% +% The basic commands to enable and disable line numbers. +% ~\@par~ and ~\par~ are only touched, when they are ~\let~ +% to ~\@@@par~/~\linenumberpar~. The line number may be +% reset to 1 with the star-form, or set by an optional +% argument ~[~<number>~]~. +% +% (New v4.00) We add ~\ifLineNumbers~ etc.\ since +% a number of our new adjustments need to know whether +% linenumbering is active. This just provides a kind of +% shorthand for ~\ifx\@@par\linenumberpar~; moreover it is +% more stable: who knows what may happen to ~\@@par~?---A +% caveat: ~\ifLineNumbers~ may be wrong. E.g., it may be +% ~\iffalse~ where it acts, while a ~\linenumbers~ a few +% lines below---in the same paragraph---brings about that +% the line where the ~\ifLineNumbers~ appears gets a +% marginal number. +%% Better implementation suggested below. +%% +% (New v4.3) Just noticed: Such tricks have been +% disallowed with v4.11, see subsections_\ref{ss:LL} +% and_\ref{ss:CtrlLN}.---Moreover, the switching between +% meanings of ~\linelabel~ for a possible error message +% as of v4.11 is removed. Speed is difficult to esteem +% and also depends on applications. Just use the most +% simple code you find. (/New v4.3) + +\newif\ifLineNumbers \LineNumbersfalse + +% (/New v4.00) + +\def\linenumbers{% + \LineNumberstrue % v4.00 + \xdef\@LN@outer@holdins{\the\holdinginserts}% v4.3 +%% +% (New v4.3) The previous line is for ~{linenomath}~ +% in a first numbered paragraph. (/New v4.3) +%% + \let\@@par\linenumberpar + % \let\linelabel\@LN@linelabel % v4.11, removed v4.3 + \ifx\@par\@@@par\let\@par\linenumberpar\fi + \ifx\par\@@@par\let\par\linenumberpar\fi + \@LN@maybe@moduloresume % v4.31 + \@ifnextchar[{\resetlinenumber}%] + {\@ifstar{\resetlinenumber}{}}% + } + +\def\nolinenumbers{% + \LineNumbersfalse % v4.00 + \let\@@par\@@@par + % \let\linelabel\@LN@LLerror % v4.11, removed v4.3 + \ifx\@par\linenumberpar\let\@par\@@@par\fi + \ifx\par\linenumberpar\let\par\@@@par\fi + } + +% (New v4.00) Moreover, it is useful to switch to +% ~\nolinenumbers~ in ~\@arrayparboxrestore~. We postpone this +% to section_\ref{ss:ReDef} where we'll have an appending macro +% for doing this. (/New v4.00) +% +% What happens with a display math? Since ~\par~ is not executed, +% when breaking the lines before a display, they will not get +% line numbers. Sorry, but I do not dare to change +% ~\interlinepenalty~ globally, nor do I want to redefine +% the display math environments here. +% \begin{displaymath} +% display \ math +% \end{displaymath} +% See the subsection below, for a wrapper environment to make +% it work. But that requires to wrap each and every display +% in your \LaTeX\ source %%. +%% v4.3: +% (see option ~displaymath~ in subsections_\ref{ss:v3opts} +% and_\ref{ss:display} for some relief [UL]). +% +% The next two commands are provided to turn on line +% numbering in a specific mode. Please note the difference: +% for pagewise numbering, ~\linenumbers~ comes first to +% inhibit it from seeing optional arguments, since +% re-/presetting the counter is useless. + +\def\pagewiselinenumbers{\linenumbers\setpagewiselinenumbers} +\def\runninglinenumbers{\setrunninglinenumbers\linenumbers} + +% Finally, it is a \LaTeX\ style, so we provide for the use +% of environments, including the suppression of the +% following paragraph's indentation. +% +%% TODO: v4.3+: +% (UL) I am drawing the following +% private thoughts of Stephan's to publicity so that others may +% think about them---or to remind myself of them in an efficient +% way. (/UL) +%% UL changed `%%%' to `% %' below. +%% TODO: add \par to \linenumbers, if called from an environment. %% v4.3 +%% ToDO: add an \@endpe hack if \linenumbers are turned on +% \begin{old}\begin{verbatim} +% % TO DO: add \par to \linenumbers, if called from an environment. +% % To DO: add an \@endpe hack if \linenumbers are turned on +% % in horizontal mode. {\par\parskip\z@\noindent} or +% % something. +% \end{verbatim} +% \end{old} +% (UL) However, I rather think that ~\linenumbers~ and %% v4.31 +% ~\nolinenumbers~ should execute a ~\par~ already. (Then the +% ~\par~s in the following definitions should be removed.) (/UL) + +\@namedef{linenumbers*}{\par\linenumbers*} +\@namedef{runninglinenumbers*}{\par\runninglinenumbers*} + +\def\endlinenumbers{\par\@endpetrue} +\let\endrunninglinenumbers\endlinenumbers +\let\endpagewiselinenumbers\endlinenumbers +\expandafter\let\csname endlinenumbers*\endcsname\endlinenumbers +\expandafter\let\csname endrunninglinenumbers*\endcsname\endlinenumbers +\let\endnolinenumbers\endlinenumbers + +% +% \subsection{% +% Display math +% \unskip}\label{ss:DM} +% +% Now we tackle the problem to get display math working. +% There are different options. +% \begin{enumerate}\item[ +% 1.] Precede every display math with a ~\par~. +% Not too good. +% \item[ +% 2.] Change ~\interlinepenalty~ and associates globally. +% Unstable. +% \item[ +% 3.] Wrap each display math with a ~{linenomath}~ +% environment. +% \end{enumerate} +% We'll go for option 3. See if it works: +% \begin{linenomath} +% \begin{equation} +% display \ math +% \end{equation} +% \end{linenomath} +% The star form ~{linenomath*}~ should also number the lines +% of the display itself, +% \begin{linenomath*} +% \begin{eqnarray} +% multi && line \\ +% display && math \\ +% & +% \begin{array}{c} +% with \\ +% array +% \end{array} +% & +% \end{eqnarray} +% \end{linenomath*} +% including multline displays. +% +% First, here are two macros to turn +% on linenumbering on paragraphs preceeding displays, with +% numbering the lines of the display itself, or without. +% The ~\ifx..~ tests if line numbering is turned on. It +% does not harm to add these wrappers in sections that are +% not numbered. Nor does it harm to wrap a display +% twice, e.q, in case you have some ~{equation}~s wrapped +% explicitely, and later you redefine ~\equation~ to do it +% automatically. +% +% (New v4.3) To avoid the spurious line number above a +% display in vmode, I insert ~\ifhmode~. (/New v4.3) + +\newcommand\linenomathNonumbers{% + \ifLineNumbers +%% \ifx\@@par\@@@par\else + \ifnum\interlinepenalty>-\linenopenaltypar + \global\holdinginserts\thr@@ + \advance\interlinepenalty \linenopenalty + \ifhmode % v4.3 + \advance\predisplaypenalty \linenopenalty + \fi + \fi + \fi + \ignorespaces + } + +\newcommand\linenomathWithnumbers{% + \ifLineNumbers +%% \ifx\@@par\@@@par\else + \ifnum\interlinepenalty>-\linenopenaltypar + \global\holdinginserts\thr@@ + \advance\interlinepenalty \linenopenalty + \ifhmode % v4.3 + \advance\predisplaypenalty \linenopenalty + \fi + \advance\postdisplaypenalty \linenopenalty + \advance\interdisplaylinepenalty \linenopenalty + \fi + \fi + \ignorespaces + } + +% The ~{linenomath}~ environment has two forms, with and +% without a star. The following two macros define the +% environment, where the stared/non-stared form does/doesn't number the +% lines of the display or vice versa. + +\newcommand\linenumberdisplaymath{% + \def\linenomath{\linenomathWithnumbers}% + \@namedef{linenomath*}{\linenomathNonumbers}% + } + +\newcommand\nolinenumberdisplaymath{% + \def\linenomath{\linenomathNonumbers}% + \@namedef{linenomath*}{\linenomathWithnumbers}% + } + +\def\endlinenomath{% + \ifLineNumbers % v4.3 + \global\holdinginserts\@LN@outer@holdins % v4.21 + \fi + \global % v4.21 support for LaTeX2e earlier than 1996/07/26. + \@ignoretrue +} +\expandafter\let\csname endlinenomath*\endcsname\endlinenomath + +% The default is not to number the lines of a display. But +% the package option ~mathlines~ may be used to switch +% that behavior. + +\nolinenumberdisplaymath + +% +% \section{% +% Line number references +% \unskip}\label{s:LNref} +% \subsection{% +% Internals %% New subsec. v4.3. +% \unskip} +% The only way to get a label to a line number in a +% paragraph is to ask the output routine to mark it. +% +% (New v4.00) The following two paragraphs don't hold any +% longer, see below. (/New v4.00) +% \begin{old}\begin{verbatim} +% % We use the marginpar mechanism to hook to ~\output~ for a +% % second time. Marginpars are floats with number $-1$, we +% % fake marginpars with No $-2$. Originally, every negative +% % numbered float was considered to be a marginpar. +% % +% % The float box number ~\@currbox~ is used to transfer the +% % label name in a macro called ~\@LNL@~<box-number>. +% \end{verbatim} +% \end{old} +% A ~\newlabel~ is written to the aux-file. The reference +% is to ~\theLineNumber~, \emph{not} ~\thelinenumber~. +% This allows to hook in, as done below for pagewise line +% numbering. +% +% (New v3.03) The ~\@LN@ExtraLabelItems~ are added for a hook +% to keep packages like ~{hyperref}~ happy. (/New v3.03) +% +% (New v4.00) +% We fire the ~\marginpar~ mechanism, so we leave \LaTeX's +% ~\@addmarginpar~ untouched. +% \begin{old}\begin{verbatim} +% % \let\@LN@addmarginpar\@addmarginpar +% % \def\@addmarginpar{% +% % \ifnum\count\@currbox>-2\relax +% % \expandafter\@LN@addmarginpar +% % \else +% % \@cons\@freelist\@currbox +% % \protected@write\@auxout{}{% +% % \string\newlabel +% % {\csname @LNL@\the\@currbox\endcsname}% +% % {{\theLineNumber}{\thepage}\@LN@ExtraLabelItems}}% +% % \fi} +% \end{verbatim} +% \end{old} +% OK, we keep Stephan's ~\@LN@ExtraLabelItems~: +% (/New v4.00) + +\let\@LN@ExtraLabelItems\@empty + +% (New v4.00) +% We imitate the ~\marginpar~ mechanism without using the +% ~\@freelist~ boxes. ~\linelabel~ will indeed place a signal +% penalty (~\@Mllbcodepen~, new), and it will put a label into +% some list macro ~\@LN@labellist~. A new part of the output +% routine will take the labels from the list and will write +% ~\newlabel~s to the .aux file. +% +% The following is a version of \LaTeX's ~\@xnext~. + +\def\@LN@xnext#1\@lt#2\@@#3#4{\def#3{#1}\gdef#4{#2}} + +% This takes an item ~#1~ from a list ~#4~ into ~#3~; +% to be used as ~\expandafter\@LN@xnext#4\@@#3#4~. +% Our lists use ~\@lt~ after each item for separating. +% Indeed, there will be another list macro which can +% appear as argument ~#4~, this will be used for moving +% ~\vadjust~ items (section_\ref{ss:PVadj}). +% The list for ~\linelabel~s is the following: + +\global\let\@LN@labellist\@empty + +% The next is the new part of the output routine writing the +% ~\newlabel~ to the .aux file. Since it is no real page output, +% the page is put back to top of the main vertical list. + +\def\WriteLineNo{% + \unvbox\@cclv + \expandafter \@LN@xnext \@LN@labellist \@@ + \@LN@label \@LN@labellist + \protected@write\@auxout{}{\string\newlabel{\@LN@label}% + {{\theLineNumber}{\thepage}\@LN@ExtraLabelItems}}% +} + +% (/New v4.00) +% +% \subsection{% +% The \scs{linelabel} command +% \unskip}\label{ss:LL} +% To refer to a place in line ~\ref{~<foo>~}~ at page +% ~\pageref{~<foo>~}~ you place a ~\linelabel{~<foo>~}~ at +% that place. +% +% \linelabel{demo} +% \marginpar{\tiny\raggedright +% See if it works: This paragraph +% starts on page \pageref{demo}, line +% \ref{demo}. +% \unskip}% +% (New v4.11) +% \begin{old}\begin{verbatim} +% % If you use this command outside a ~\linenumbers~ +% % paragraph, you will get references to some bogus +% % line numbers, sorry. But we don't disable the command, +% % because only the ~\par~ at the end of a paragraph may +% % decide whether to print line numbers on this paragraph +% % or not. A ~\linelabel~ may legally appear earlier than +% % ~\linenumbers~. +% \end{verbatim} +% \end{old} +% This trick is better not allowed---see subsections_\ref{ss:LL} +% and_\ref{ss:CtrlLN}. +% (/New v4.11) +% +% ~\linelabel~ +% \begin{old}\begin{verbatim} +% %, via a fake float number $-2$, %% new mechanism v4.00 +% \end{verbatim} +% \end{old} +% puts a +% ~\penalty~ into a ~\vadjust~, which triggers the +% pagebuilder after putting the current line to the main +% vertical list. A ~\write~ is placed on the main vertical +% list, which prints a reference to the current value of +% ~\thelinenumber~ and ~\thepage~ at the time of the +% ~\shipout~. +% +% A ~\linelabel~ is allowed only in outer horizontal mode. +% In outer vertical mode we start a paragraph, and ignore +% trailing spaces (by fooling ~\@esphack~). +% +% (New v4.00) We aim at relaxing the previous condition. +% We insert a hook ~\@LN@mathhook~ and a shorthand +% ~\@LN@postlabel~ to support the ~mathrefs~ option which +% allows ~\linelabel~ in math mode. +% +% The next paragraph is no longer valid. +% \begin{old}\begin{verbatim} +% % The argument of ~\linelabel~ is put into a macro with a +% % name derived from the number of the allocated float box. +% % Much of the rest is dummy float setup. +% \end{verbatim} +% \end{old} +% (/New v4.00) +% +% (New v4.11) +% \begin{old}\begin{verbatim} +% % \def\linelabel#1{% +% \end{verbatim} +% \end{old} +% I forgot ~\linenumbers~ today, costed me hours or so. + +\def\@LN@LLerror{\PackageError{lineno}{% + \string\linelabel\space without \string\linenumbers}{% + Just see documentation. (New feature v4.11)}\@gobble} + +% (New v4.3) Here some things have changed for v4.3. +% The previous ~#1~ has been replaced by ~\@gobble~. +% Ensuing, the ~\linelabel~ error message is re-implemented. +% I find it difficult to compare efficiency of slight +% alternatives---so choose an easy one. Explicit switching +% in ~\linenumbers~ and ~\nolinenumbers~ is an additional +% command that may better be avoided. + +\newcommand\linelabel{% + \ifLineNumbers \expandafter \@LN@linelabel + \else \expandafter \@LN@LLerror \fi} +%%\let\linelabel\@LN@LLerror + +\gdef\@LN@linelabel#1{% +%% +% ~\gdef~ for hyperref ``symbolically''. (/New v4.11) +%% + \ifx\protect\@typeset@protect +%% +% $\gets$ And a ~\linelabel~ should never be replicated in a +% mark or a TOC entry. (/New v4.3) +%% + \ifvmode + \ifinner \else + \leavevmode \@bsphack \@savsk\p@ + \fi + \else + \@bsphack + \fi + \ifhmode + \ifinner + \@parmoderr + \else +%% +% (New v4.00) +%% + \@LN@postlabel{#1}% +% \begin{old}\begin{verbatim} +% % \@floatpenalty -\@Mii +% % \@next\@currbox\@freelist +% % {\global\count\@currbox-2% +% % \expandafter\gdef\csname @LNL@\the\@currbox\endcsname{#1}}% +% % {\@floatpenalty\z@ \@fltovf \def\@currbox{\@tempboxa}}% +% % \begingroup +% % \setbox\@currbox \color@vbox \vbox \bgroup \end@float +% % \endgroup +% % \@ignorefalse \@esphack +% \end{verbatim} +% \end{old} +% (/New v4.00) +%% + \@esphack +%% +% (New v4.00) +% The ~\@ignorefalse~ was appropriate before because the +% ~\@Esphack~ in ~\end@float~ set ~\@ignoretrue~. Cf._\LaTeX's +% ~\@xympar~. (/New v4.00) +%% + \fi + \else +%% +% (New v4.00) +%% + \@LN@mathhook{#1}% +% \begin{old}\begin{verbatim} +% % \@parmoderr +% \end{verbatim} +% \end{old} +% Instead of complaining, you may just do your job. +% (/New v4.00) +%% + \fi + \fi + } + +% (New v4.00) The shorthand just does what happened +% with ~linenox0.sty~ before ~ednmath0.sty~ (New v4.1: +% now ~mathrefs~ option) appeared, and +% the hook is initialized to serve the same purpose. +% So errors come just where Stephan had built them in, +% and this is just the \LaTeX\ ~\marginpar~ behaviour. + +\def\@LN@postlabel#1{\g@addto@macro\@LN@labellist{#1\@lt}% + \vadjust{\penalty-\@Mllbcodepen}} +\def\@LN@mathhook#1{\@parmoderr} + +% (/New v4.00) +% +% \modulolinenumbers[3] +% \firstlinenumber{1} +% \section{% +% The appearance of the line numbers +% \unskip}\label{appearance} +% \subsection{% +% Basic code %% own subsec. v4.2. +% \unskip} +% +% The line numbers are set as ~\tiny\sffamily\arabic{linenumber}~, +% $10pt$ left of the text. With options to place it +% right of the text, or . . . +% +% . . . here are the hooks: + +\def\makeLineNumberLeft{% + \hss\linenumberfont\LineNumber\hskip\linenumbersep} + +\def\makeLineNumberRight{% + \linenumberfont\hskip\linenumbersep\hskip\columnwidth + \hb@xt@\linenumberwidth{\hss\LineNumber}\hss} + +\def\linenumberfont{\normalfont\tiny\sffamily} + +\newdimen\linenumbersep +\newdimen\linenumberwidth + +\linenumberwidth=10pt +\linenumbersep=10pt + +% Margin switching requires ~pagewise~ numbering mode, but +% choosing the left or right margin for the numbers always +% works. + +\def\switchlinenumbers{\@ifstar + {\let\makeLineNumberOdd\makeLineNumberRight + \let\makeLineNumberEven\makeLineNumberLeft}% + {\let\makeLineNumberOdd\makeLineNumberLeft + \let\makeLineNumberEven\makeLineNumberRight}% + } + +\def\setmakelinenumbers#1{\@ifstar + {\let\makeLineNumberRunning#1% + \let\makeLineNumberOdd#1% + \let\makeLineNumberEven#1}% + {\ifx\c@linenumber\c@runninglinenumber + \let\makeLineNumberRunning#1% + \else + \let\makeLineNumberOdd#1% + \let\makeLineNumberEven#1% + \fi}% + } + +\def\leftlinenumbers{\setmakelinenumbers\makeLineNumberLeft} +\def\rightlinenumbers{\setmakelinenumbers\makeLineNumberRight} + +\leftlinenumbers* + +% ~\LineNumber~ is a hook which is used for the modulo stuff. +% It is the command to use for the line number, when you +% customize ~\makeLineNumber~. Use ~\thelinenumber~ to +% change the outfit of the digits. +% +% +% We will implement two modes of operation: +% \begin{itemize} +% \item numbers ~running~ through (parts of) the text +% \item ~pagewise~ numbers starting over with one on top of +% each page. +% \end{itemize} +% Both modes have their own count register, but only one is +% allocated as a \LaTeX\ counter, with the attached +% facilities serving both. + +\newcounter{linenumber} +\newcount\c@pagewiselinenumber +\let\c@runninglinenumber\c@linenumber + +% Only the running mode counter may be reset, or preset, +% for individual paragraphs. The pagewise counter must +% give a unique anonymous number for each line. +% +% (New v4.3) ~\newcounter{linenumber}~ +% was the only ~\newcounter~ in the whole package, and +% formerly I was near using ~\newcount~ instead. Yet +% ~\newcounter~ may be quite useful for ~\includeonly~. +% It also supports resetting ``subcounters'', but what +% could these be? Well, ~edtable~ might introduce a +% subcounter for columns. +% (Note that \LaTeX's setting commands would work with +% ~\newcount\c@linenumber~ already, apart from this. +% And perhaps sometimes ~\refstepcounter{linenumber}~ +% wouldn't work---cf._my discussion of ~\stepcounter~ in +% subsection_\ref{ss:MLN}, similarly ~\refstep...~ would +% be quite useless. +% Even the usual redefinitions of ~\thelinenumber~ would +% work. It is nice, on the other hand, that +% ~\thelinenumber~ is predefined here. \LaTeX's +% initialization of the value perhaps just serves making +% clear \LaTeX\ counters should always be changed +% globally.---Shortened and improved the discussion here.) +% (/New v4.3) +% +% (New v4.22) +% ~\c@linenumber~ usually is---globally---incremented by +% ~\stepcounter~ (at present), so resetting it locally would +% raise the save stack problem of \TeX book p._301, moreover +% it would be is useless, there is no hope of keeping the +% values local (but see subsection_\ref{ss:ILN}). So I insert +% ~\global~: (/New v4.22) + +\newcommand*\resetlinenumber[1][\@ne]{% + \global % v4.22 + \c@runninglinenumber#1\relax} + +% (New v4.00) +% \begin{old}\begin{verbatim} +% % \newcommand\resetlinenumber[1][1]{\c@runninglinenumber#1} +% \end{verbatim} +% \end{old} +% Added ~\relax~, being quite sure that this does no harm +% and is quite important, as with ~\setcounter~ etc. +% I consider this a bug fix (although perhaps no user has +% ever had a problem with this). (/New v4.00) +% +% (v4.22: I had made much fuss about resetting subordinate +% counters here---removed, somewhat postponed.) +% +%% TODO v4.3+: +%% \newcommand*\resetlinenumber[1][\@ne]{% +%% \ifx\c@linenumber\c@runninglinenumber +%% \global\c@linenumber#1\relax +%% \global\advance\c@linenumber\m@ne +%% \stepLineNumber +%% \else +%% \PackageError{lineno}%% Shorthand!? +%% {You can't reset line number in pagewise mode}% +%% {This should suffice.}% +%% \fi +%% } +% +% \subsection{% +% Running line numbers +% \unskip} +% +% Running mode is easy, ~\LineNumber~ and ~\theLineNumber~ +% produce ~\thelinenumber~, which defaults to +% ~\arabic{linenumber}~, using the ~\c@runninglinenumber~ +% counter. This is the default mode of operation. + +\def\makeRunningLineNumber{\makeLineNumberRunning} + +\def\setrunninglinenumbers{% + \def\theLineNumber{\thelinenumber}% + \let\c@linenumber\c@runninglinenumber + \let\makeLineNumber\makeRunningLineNumber + } + +\setrunninglinenumbers\resetlinenumber + +% +% \subsection{% +% Pagewise line numbers +% \unskip}\label{ss:PW} +% +% Difficult, if you think about it. The number has to be +% printed when there is no means to know on which page it +% will end up, except through the aux-file. My solution +% is really expensive, but quite robust. +% +% With version ~v2.00~ the hashsize requirements are +% reduced, because we do not need one controlsequence for +% each line any more. But this costs some computation time +% to find out on which page we are. +% +% ~\makeLineNumber~ gets a hook to log the line and page +% number to the aux-file. Another hook tries to find out +% what the page offset is, and subtracts it from the counter +% ~\c@linenumber~. Additionally, the switch +% ~\ifoddNumberedPage~ is set true for odd numbered pages, +% false otherwise. + +\def\setpagewiselinenumbers{% + \let\theLineNumber\thePagewiseLineNumber + \let\c@linenumber\c@pagewiselinenumber + \let\makeLineNumber\makePagewiseLineNumber + } + +\def\makePagewiseLineNumber{\logtheLineNumber\getLineNumber + \ifoddNumberedPage + \makeLineNumberOdd + \else + \makeLineNumberEven + \fi + } + +% Each numbered line gives a line to the aux file +% \begin{verse} +% ~\@LN{~<line>~}{~<page>~}~ +% \end{verse} +% very similar to the ~\newlabel~ business, except that we need +% an arabic representation of the page number, not what +% there might else be in ~\thepage~. + +\def\logtheLineNumber{\protected@write\@auxout{}{% +%% +% (New v4.00) (UL) +% As Daniel Doherty observed, the earlier line +% \begin{old}\begin{verbatim} +% % \string\@LN{\the\c@linenumber}{\noexpand\the\c@page}}} +% \end{verbatim} +% \end{old} +% here may lead into an infinite loop when the user resets +% the page number (think of ~\pagenumbering~, e.g.). +% Stephan and I brief\/ly discussed the matter and decided +% to introduce a ``physical''-page counter to which +% ~\logtheLineNumber~ refers. It was Stephan's idea to use +% ~\cl@page~ for reliably augmenting the ``physical''-page +% counter. However, this relies on the output routine once +% doing ~\stepcounter{page}~. Before Stephan's +% suggestion, I had thought of appending the stepping to +% \LaTeX's ~\@outputpage~.---So the macro definition ends +% as follows. +%% + \string\@LN{\the\c@linenumber}{% +%% +% (New v4.2) +%% \noexpand\number\n@LN@truepage}}} +%% +% The `truepage' counter must start with ~\c@~ so it works +% with ~\include~, and the ~\@addtoreset~ below is needed +% for the same purpose. +%% + \noexpand\the\c@LN@truepage}}} + +%% \newcount\n@LN@truepage +%% \g@addto@macro\cl@page{\global\advance\n@LN@truepage\@ne} +\newcount\c@LN@truepage +\g@addto@macro\cl@page{\global\advance\c@LN@truepage\@ne} +\@addtoreset{LN@truepage}{@ckpt} + +% (/New v4.2) I had thought of offering more +% features of a \LaTeX\ counter. However, the user should +% better \emph{not} have access to this counter. ~\c@page~ +% should suffice as a pagewise master counter.---To be sure, +% along the present lines the user \emph{can} manipulate +% ~\c@LN@truepage~ by ~\stepcounter{page}~. E.g., she might +% do this in order to manually insert a photograph. Well, +% seems not to harm. +% +% The above usage of ~\g@addto@macro~ and ~\cl@page~ may be +% not as stable as Stephan intended. His proposal used +% ~\xdef~ directly. But he used ~\cl@page~ as well, and who +% knows \dots{} And as to ~\g@addto@macro~, I have introduced +% it for list macros anyway. +% (/UL) (/New v4.00) +% +% From the aux-file we get one macro ~\LN@P~<page> for each +% page with line numbers on it. This macro calls four other +% macros with one argument each. These macros are +% dynamically defined to do tests and actions, to find out +% on which page the current line number is located. +% +% We need sort of a pointer to the first page with line +% numbers, initiallized to point to nothing: + +\def\LastNumberedPage{first} +\def\LN@Pfirst{\nextLN\relax} + +% The four dynamic macros are initiallized to reproduce +% themselves in an ~\xdef~ + +\let\lastLN\relax % compare to last line on this page +\let\firstLN\relax % compare to first line on this page +\let\pageLN\relax % get the page number, compute the linenumber +\let\nextLN\relax % move to the next page + +% During the end-document run through the aux-files, we +% disable ~\@LN~. I may put in a check here later, to give +% a rerun recommendation. + +\AtEndDocument{\let\@LN\@gobbletwo} + +% Now, this is the tricky part. First of all, the whole +% definition of ~\@LN~ is grouped, to avoid accumulation +% on the save stack. Somehow ~\csname~<cs>~\endcsname~ pushes +% an entry, which stays after an ~\xdef~ to that <cs>. +% +% If ~\LN@P~<page> is undefined, initialize it with the +% current page and line number, with the +% \emph{pointer-to-the-next-page} pointing to nothing. And +% the macro for the previous page will be redefined to point +% to the current one. +% +% If the macro for the current page already exists, just +% redefine the \emph{last-line-number} entry. +% +% Finally, save the current page number, to get the pointer to the +% following page later. + +\def\@LN#1#2{{\expandafter\@@LN + \csname LN@P#2C\@LN@column\expandafter\endcsname + \csname LN@PO#2\endcsname + {#1}{#2}}} + +\def\@@LN#1#2#3#4{\ifx#1\relax + \ifx#2\relax\gdef#2{#3}\fi + \expandafter\@@@LN\csname LN@P\LastNumberedPage\endcsname#1% + \xdef#1{\lastLN{#3}\firstLN{#3}% + \pageLN{#4}{\@LN@column}{#2}\nextLN\relax}% + \else + \def\lastLN##1{\noexpand\lastLN{#3}}% + \xdef#1{#1}% + \fi + \xdef\LastNumberedPage{#4C\@LN@column}} + +% The previous page macro gets its pointer to the +% current one, replacing the ~\relax~ with the cs-token +% ~\LN@P~<page>. + +\def\@@@LN#1#2{{\def\nextLN##1{\noexpand\nextLN\noexpand#2}% + \xdef#1{#1}}} + +% Now, to print a line number, we need to find the page, +% where it resides. This will most probably be the page where +% the last one came from, or maybe the next page. However, it can +% be a completely different one. We maintain a cache, +% which is ~\let~ to the last page's macro. But for now +% it is initialized to expand ~\LN@first~, where the poiner +% to the first numbered page has been stored in. + +\def\NumberedPageCache{\LN@Pfirst} + +% To find out on which page the current ~\c@linenumber~ is, +% we define the four dynamic macros to do something usefull +% and execute the current cache macro. ~\lastLN~ is run +% first, testing if the line number in question may be on a +% later page. If so, disable ~\firstLN~, and go on to the +% next page via ~\nextLN~. + +\def\testLastNumberedPage#1{\ifnum#1<\c@linenumber + \let\firstLN\@gobble + \fi} + +% Else, if ~\firstLN~ finds out that we need an earlier +% page, we start over from the beginning. Else, ~\nextLN~ +% will be disabled, and ~\pageLN~ will run +% ~\gotNumberedPage~ with four arguments: the first line +% number on this column, the page number, the column +% number, and the first line on the page. + +\def\testFirstNumberedPage#1{\ifnum#1>\c@linenumber + \def\nextLN##1{\testNextNumberedPage\LN@Pfirst}% + \else + \let\nextLN\@gobble + \def\pageLN{\gotNumberedPage{#1}}% + \fi} + +% We start with ~\pageLN~ disabled and ~\nextLN~ defined to +% continue the search with the next page. + +\long\def \@gobblethree #1#2#3{} + +\def\testNumberedPage{% + \let\lastLN\testLastNumberedPage + \let\firstLN\testFirstNumberedPage + \let\pageLN\@gobblethree + \let\nextLN\testNextNumberedPage + \NumberedPageCache + } + +% When we switch to another page, we first have to make +% sure that it is there. If we are done with the last +% page, we probably need to run \TeX\ again, but for the +% rest of this run, the cache macro will just return four +% zeros. This saves a lot of time, for example if you have +% half of an aux-file from an aborted run, in the next run +% the whole page-list would be searched in vain again and +% again for the second half of the document. +% +% If there is another page, we iterate the search. + +\def\testNextNumberedPage#1{\ifx#1\relax + \global\def\NumberedPageCache{\gotNumberedPage0000}% + \PackageWarningNoLine{lineno}% + {Linenumber reference failed, + \MessageBreak rerun to get it right}% + \else + \global\let\NumberedPageCache#1% + \fi + \testNumberedPage + } + +% \linelabel{demo2} +% \marginpar{\tiny\raggedright +% Let's see if it finds the label +% on page \pageref{demo}, +% line \ref{demo}, and back here +% on page \pageref{demo2}, line +% \ref{demo2}. +% \unskip}% +% To separate the official hooks from the internals there is +% this equivalence, to hook in later for whatever purpose: + +\let\getLineNumber\testNumberedPage + +% So, now we got the page where the number is on. We +% establish if we are on an odd or even page, and calculate +% the final line number to be printed. + +\newif\ifoddNumberedPage +\newif\ifcolumnwiselinenumbers +\columnwiselinenumbersfalse + +\def\gotNumberedPage#1#2#3#4{\oddNumberedPagefalse + \ifodd \if@twocolumn #3\else #2\fi\relax\oddNumberedPagetrue\fi + \advance\c@linenumber\@ne + \ifcolumnwiselinenumbers + \subtractlinenumberoffset{#1}% + \else + \subtractlinenumberoffset{#4}% + \fi + } + +% You might want to run the pagewise mode with running line +% numbers, or you might not. It's your choice: + +\def\runningpagewiselinenumbers{% + \let\subtractlinenumberoffset\@gobble + } + +\def\realpagewiselinenumbers{% + \def\subtractlinenumberoffset##1{\advance\c@linenumber-##1\relax}% + } + +\realpagewiselinenumbers + +% For line number references, we need a protected call to +% the whole procedure, with the requested line number stored +% in the ~\c@linenumber~ counter. This is what gets printed +% to the aux-file to make a label: + +\def\thePagewiseLineNumber{\protect + \getpagewiselinenumber{\the\c@linenumber}}% + +% And here is what happens when the label is refered to: + +\def\getpagewiselinenumber#1{{% + \c@linenumber #1\relax\testNumberedPage + \thelinenumber + }} + +% % +% A summary of all per line expenses: +% \begin{description}\item +% [CPU:] The ~\output~ routine is called for each line, +% and the page-search is done. +% \item +% [DISK:] One line of output to the aux-file for each +% numbered line +% \item +% [MEM:] One macro per page. Great improvement over v1.02, +% which had one control sequence per line in +% addition. It blew the hash table after some five +% thousand lines. +% \end{description} +% +% \subsection{% +% Twocolumn mode (New v3.06) +% \unskip} +% +% Twocolumn mode requires another patch to the ~\output~ +% routine, in order to print a column tag to the .aux +% file. + +\AtBeginDocument{% v4.2, revtex4.cls (e.g.). + % <- TODO v4.3+: Or better in \LineNoLaTeXOutput!? + \let\@LN@orig@makecol\@makecol} +\def\@LN@makecol{% + \@LN@orig@makecol + \setbox\@outputbox \vbox{% + \boxmaxdepth \@maxdepth + \protected@write\@auxout{}{% + \string\@LN@col{\if@firstcolumn1\else2\fi}% + }% + \unvbox\@outputbox % v4.22, was \box + }% \vbox +} %% TODO cf. revtexln.sty. + +\def\@LN@col{\def\@LN@column} % v4.22, removed #1. +\@LN@col{1} + +% +% \subsection{% +% Numbering modulo $m$, starting at $f$ +%% Numbering modulo 5 +% \unskip}\label{ss:Mod} +% +% Most users want to have only one in five lines numbered. +% ~\LineNumber~ is supposed to produce the outfit of the +% line number attached to the line, while ~\thelinenumber~ +% is used also for references, which should appear even if +% they are not multiples of five. +% +% (New v4.00) Moreover, some users want to +% control which line number should be printed first. Support +% of this is now introduced here---see ~\firstlinenumber~ +% below.---~numline.sty~ by Michael Jaegermann and +% James Fortune offers controlling which \emph{final} +% line numbers should not be printed. What is +% it good for? We ignore this here until some user demands +% it.---Peter Wilson's ~ledmac.sty~ offers much different +% choices of line numbers to be printed, due to Wayne Sullivan. +% (/New v4.00) +% +% (New v4.22) ~\c@linenumbermodulo~ is rendered a +% fake counter, as discussed since v4.00. So it can +% no longer be set by ~\setcounter~. ~\modulolinenumbers~ +% serves this purpose. Well, does anybody want to do +% what worked with ~\addtocounter~? (Then please tell +% me.)---At least, ~\value~ still works. For the same +% purpose I rename the fake `firstlinenumber' counter +% ~\n@...~ to ~\c@...~. (/New v4.22) +% \begin{old}\begin{verbatim} +% % \newcount\c@linenumbermodulo % removed for v4.22 +% \end{verbatim} +% \end{old} +% +%% Removed for v4.22: +%% (UL) On my question why, e.g., +%% ~\chardef~ would not have sufficed, Stephan couldn't remember +%% exactly; guessed that he wanted to offer \LaTeX\ counter +%% facilities. However, the typical ones don't come this way. +%% So I'm quite sure that I will change this next time. +%% +%% However, I observed at least two times that users gave a very +%% high value to ~\c@linenumbermodulo~ in order to suppress +%% printing of the line number. One of these users preferred an +%% own way of handling line numbers, just wanted to use +%% ~\linelabel~ and ~ednotes.sty~ features. Should we support this? +%% I rather would like to advise them to +%% ~\let\makeLineNumber\relax~. (/UL) +% +% (New v4.00) \par +% ~\themodulolinenumber~ waits for being declared +% ~\LineNumber~ by ~\modulolinenumbers~. (This has +% been so before, no change.) Here is how it +% looked before: +% \begin{old}\begin{verbatim} +% % \def\themodulolinenumber{{\@tempcnta\c@linenumber +% % \divide\@tempcnta\c@linenumbermodulo +% % \multiply\@tempcnta\c@linenumbermodulo +% % \ifnum\@tempcnta=\c@linenumber\thelinenumber\fi +% % }} +% \end{verbatim} +% \end{old} +% (UL) This was somewhat slow. This arithmetic +% happens at every line. This time I tend to declare an extra +%% TODO v4.3+ +% line counter (as opposed to my usual recommendations to use +% counters as rarely as possible) which is stepped every line. +% It could be incremented in the same way as ~\c@LN@truepage~ +% is incremented via ~\cl@page~! This is another point in favour +% of ~{linenumber}~ being a \LaTeX\ counter! +% When this new counter equals ~\c@linenumbermodulo~, it is reset, +% and ~\thelinenumber~ is executed.---It gets much slower by my +% support of controlling the first line number below. I should +% improve this.---On +%% %% TODO v4.3+--pagewise!? +% the other hand, time expense means very little nowadays, +% while the number of \TeX\ counters still is limited. +% +% For the same purpose, moreover, attaching the line number +% box could be intercepted earlier (in ~\MakeLineNo~), +% without changing ~\LineNumber~. However, this may be +% bad for the latter's announcement as a wizard interface +% in section_\ref{s:UserCmds}. +%% +%% I wonder about Stephan's group. Its only effect is that +%% ~\@tempcnta~ is restored after using it. What for is this? +%% I tend to remove the group braces. %% TODO v4.3+ +% (/UL) +% +% Here is the new code. It is very near to my ~lnopatch.sty~ +% code which introduced the first line number feature +% before.---I add starting with a ~\relax~ which is so often +% recommended---without understanding this really. At least, +% it will not harm.---Former group braces appear as +% ~\begingroup~/~\endgroup~ here. + +\def\themodulolinenumber{\relax + \ifnum\c@linenumber<\c@firstlinenumber \else + \begingroup + \@tempcnta\c@linenumber + \advance\@tempcnta-\c@firstlinenumber + \divide\@tempcnta\c@linenumbermodulo + \multiply\@tempcnta\c@linenumbermodulo + \advance\@tempcnta\c@firstlinenumber + \ifnum\@tempcnta=\c@linenumber \thelinenumber \fi + \endgroup + \fi +} + +% (/New v4.00) +% +% The user command to set the modulo counter: +% (New v4.31) \dots\ a star variant is introduced to implement +% Hillel Chayim Yisraeli's idea to print the first line number +% after an interruption of the edited text by some editor's +% text, regardless of the modulo. If it is 1, it is printed only +% with ~\firstlinenumber{1}~. I.e., you use ~\modulolinenumbers*~ +% for the new feature, without the star you get the simpler +% behaviour that we have had so far. And you can switch back +% from the refined behaviour to the simple one by using +% ~\modulolinenumbers~ without the star.---This enhancement +% is accompanied by a new package option ~modulo*~ which just +% executes ~\modulolinenumbers*~ +% (subsection_\ref{ss:v3opts}).---`With ~\firstlinenumber{1}~' +% exactly means: `1' is printed if and only if the last +% ~\firstlinenumber~ before or in the paragraph that follows +% the ``interruption'' has argument `1' (or something +% \emph{expanding} to `1', or (to) something that \TeX\ +% ``reads'' as 1, e.g.: a \TeX\ count register storing +% 1).---At present, this behaviour may be unsatisfactory with +% pagewise line-numbering $\dots$ I'll make an experimental +% extra package if someone complains \dots + +\newcommand\modulolinenumbers{% + \@ifstar + {\def\@LN@maybe@moduloresume{% + \global\let\@LN@maybe@normalLineNumber + \@LN@normalLineNumber}% + \@LN@modulolinenos}% + {\let\@LN@maybe@moduloresume\relax \@LN@modulolinenos}% +} + +\global\let\@LN@maybe@normalLineNumber\relax +\let\@LN@maybe@moduloresume\relax +\gdef\@LN@normalLineNumber{% + \ifnum\c@linenumber=\c@firstlinenumber \else + \ifnum\c@linenumber>\@ne + \def\LineNumber{\thelinenumber}% + \fi + \fi +%% +% ~\def~ instead of ~\let~ enables taking account of a +% redefinition of ~\thelinenumber~ in a present numbering +% environment (e.g.). +%% + \global\let\@LN@maybe@normalLineNumber\relax} + +% Instead of changing ~\LineNumber~ directly by +% ~LN@moduloresume~, these tricks enable ~\modulolinenumbers*~ +% to act as locally as I can make it. I don't know how to +% avoid that the output routine switches back to the normal +% modulo behaviour by a global change. (An ~\aftergroup~ may +% fail in admittedly improbable cases.) + +\newcommand*\@LN@modulolinenos[1][\z@]{% +%% +% The definition of this macro is that of the former +% ~\modulolinenumbers~. (/New v4.31) +%% + \let\LineNumber\themodulolinenumber + \ifnum#1>\@ne + \chardef % v4.22, note below + \c@linenumbermodulo#1\relax + \else\ifnum#1=\@ne +% \begin{old}\begin{verbatim} +% % \def\LineNumber{\thelinenumber}% +% \end{verbatim} +% \end{old} +% (New v4.00) I am putting something here to enable +% ~\firstlinenumber~ with $~\c@linenumbermodulo~=1$. +% With ~lnopatch.sty~, a trick was offered for this purpose. +% It is now obsolete. +% + \def\LineNumber{\@LN@ifgreat\thelinenumber}% +%% +% (/New v4.00) +%% + \fi\fi + } + +% (New v4.00) The default of ~\@LN@ifgreat~ is + +\let\@LN@ifgreat\relax + +% The previous changes as soon as ~\firstlinenumber~ is used: + +\newcommand*\firstlinenumber[1]{% + \chardef\c@firstlinenumber#1\relax +%% +% No counter, little values allowed only---OK?---(UL) +% The change is local---OK? The good thing is that +% ~\global\firstlinenumber{~<number>~}~ works. Moreover, +% ~\modulolinenumbers~ acts locally as well. (/UL) +% +% (New v4.31) +%% + \let\@LN@ifgreat\@LN@ifgreat@critical} + +\def\@LN@ifgreat@critical{% + \ifnum\c@linenumber<\c@firstlinenumber + \expandafter \@gobble + \fi}% + +% (/New v4.31) +% +% The default +% value of ~\c@firstlinenumber~ %% v4.31 +% is 0. This is best for what one would expect from modulo +% printing. + +\let\c@firstlinenumber=\z@ + +% +% For usage and effects of ~\modulolinenumbers~ and %% v4.31 +% ~\firstlinenumbers~, please consult section_\ref{s:UserCmds}. +% Two details on ~\firstlinenumbers~ here: +% (i)_~\firstlinenumber~ acts on a paragraph if and only if +% (a)_the paragraph is broken into lines ``in line-numbering +% mode'' (after ~\linenumbers~, e.g.); +% (b)_it is the last occurrence of a ~\firstlinenumbers~ +% before or in the paragraph. +% (The practical applications of this that I can imagine +% don't seem appealing to me.) +% Cf._the explanation above of how ~\modulolinenumbers~ and +% ~\firstlinenumbers~ interact---for this and for (ii), +% which is concerned with possible arguments for +% ~\firstlinenumbers~. +% +% Note that the line numbers of the present section +% demonstrate the two devices. (/New v4.00) + +%%\setcounter{linenumbermodulo}{5} +\chardef\c@linenumbermodulo=5 % v4.2; ugly? +\modulolinenumbers[1] + +% (New v4.22) The new implementation through ~\chardef~ +% decreases the functionality and raises certain compatibility +% problems. I face this without fear. The maximum modulo value +% is now ~255~. I expect that this suffices for usual applications. +% However, some users have ``abused'' ~lineno.sty~ to get +% ~ednotes.sty~ features without line numbers, so have set the +% modulo to a value beyond the total number of lines in their +% edition. This ought to be replaced by +% ~\let\makeLineNumber\relax~. (/New v4.22) +% +% \section{% +% Package options +% \unskip}\label{s:Opts} +% +% (New v4.1) +% The last heading formerly was the heading of what is now +% subsection_\ref{ss:v3opts}. The options declared there were +% said to execute user commands only. This was wrong already +% concerning ~displaymath~ and ~hyperref~. At least, however, +% these options were no or almost no occasion to skip definitions +% or allocations. This is different with the options that we now +% insert. +% +%% (New v4.2) v4.00 moved the ``options'' below the +%% ``extensions''. This was bad with ~\do@mlineno~ in +%% subsection_\ref{ss:v3opts} which is to control +%% subsection_\ref{ss:display}---undone here. (/New v4.2) +% +% \subsection{% +% Extended referencing to line numbers. (v4.2) +% \unskip} +% This subsection explains and declares package option ~addpageno~. %% v4.31 +% +% If a line to whose number you refer by ~\ref~ is not on the +% present page, it may be useful to add the number of the page +% on which the line occurs---and perhaps it should not be added +% otherwise. In general, you could use the Standard \LaTeX\ +% package varioref for this. However, the latter usually +% produces verbose output like `on the preceding page'--- +% unless costumized---, while in critical editions, e.g., one +% may prefer just adding the page number and some mark on the +% left of the line number, irrespectively of how far the page is +% apart etc. To support this, package option ~addpageno~ +% provides a command ~\vpagelineref~ to be used in place of +% ~\ref~. This produces, e.g., `34.15' when referring to line_15 +% on page_34 while the present page is not 34. You can customize +% the outcome, see the package file ~vplref.sty~ where the code +% and further details are. You may conceive of +% ~\vpagelineref~ as a certain customization of varioref's +% ~\vref~. +% +% This implies that option ~addpageno~ requires the files +% ~vplref.sty~ and ~varioref.sty~. ~addpageno~ automatically +% loads both of them. Yet you can also load ~varioref.sty~ +% on your own to use its package options. +% +% Of course, you might better introduce a shorter command name +% for ~\vpagelineref~ for your work, while we cannot predict +% here what shorthand will fit your work. E.g., +% ~\newcommand{\lref}{\vpagelineref}~. +% +% If you really want to add the page number in \emph{any} case, +% use, e.g., some ~\myref~ instead of ~\ref~, after +% \[~newcommand*{\myref}{\pageref{#1}.\ref{#1}}~\] +% or what you like. You don't need the ~addpageno~ option in +% this case. +% +% ~addpageno~ is due to a suggestion by Sergei Mariev. + +\DeclareOption{addpageno}{% + \AtEndOfPackage{\RequirePackage{vplref}[2005/04/25]}} + +% \subsection{% +% \scs{linelabel} in math mode +% \unskip}\label{ss:MathRef} +% +% We have made some first steps towards allowing ~\linelabel~ in +% math mode. Because our code for this is presently experimental, +% we leave it to the user to decide for the experiment by calling +% option ~mathrefs~. We are in a hurry now and thus leave the +% code, explanations, and discussion in the separate package +% ~ednmath0.sty~. Maybe we later find the time to improve the +% code and move the relevant content of ~ednmath0.sty~ to here. +% The optimal situation would be to define ~\linelabel~ from +% the start so it works in math mode, omitting the ~mathrefs~ +% option. +% +% Actually, this package even provides adjustments for analogously +% allowing ~ednotes.sty~ commands in math mode. Loading the package +% is postponed to ~\AtBeginDocument~ when we know whether these +% adjustments are needed. + +\DeclareOption{mathrefs}{\AtBeginDocument + {\RequirePackage{ednmath0}[2004/08/20]}} + +% +% \subsection{% +% Arrays, tabular environments (Revised v4.11) +% \unskip}\label{ss:Tab} +% +% This subsection explains and declares package options %% v4.31 +% ~edtable~, ~longtable~, and ~nolongtablepatch~. +% +% The standard \LaTeX\ tabular environments come as single +% boxes, so the ~lineno.sty~ versions before v4.00 treated them as +% (parts of) single lines, printing (at most) one line number +% beside each and stepping the line number counter once only. +% Moreover, ~\linelabel~s got lost. Of course, tables are +% usually so high that you will want to treat each row like a +% line. (Christian Tapp even desires that the lines of table +% entries belonging to a single row are treated like ordinary +% lines.) Footnotes get lost in such environments as well, which +% was bad for ~ednotes.sty~. +% +% We provide adjustments to count lines, print their numbers +% etc.\ as desired at least for \emph{some} \LaTeX\ tabular +% environments. (Like with other details, ``some'' is to some +% extent explained in ~edtable.sty~.) We do this similarly as +% with option ~mathrefs~ before. We leave code +% and explanations in the separate package ~edtable.sty~. +% (For wizards: this package provides adjustments for +% ~ednotes.sty~ as well. However, in the present case we don't try +% to avoid them unless ~ednotes.sty~ is loaded.) +% Package option ~edtable~ +% defines---by loading ~edtable.sty~---an environment ~{edtable}~ +% which is able to change some \LaTeX\ tabular environments +% with the desired effects. (v4.11: ~edtable.sty~ v1.3 counts +% \LaTeX's ~{array}~ [etc.\@] as a ``tabular environment'' as +% well.) +% +% The ~{edtable}~ environment doesn't help with ~longtable.sty~, +% however. To make up for this, ~{longtable}~ is adjusted in a +% different way---and this happens only when another ~lineno.sty~ +% option ~longtable~ is called. In this case, option ~edtable~ +% needn't be called explicitly: option ~longtable~ works as if +% ~edtable~ had been called. +% +% Now, we are convinced that vertical spacing around +% ~{longtable}~ works wrongly---see \LaTeX\ bugs database +% tools/3180 and 3485, or see explanations in the package +% ~ltabptch.sty~ (which is to be obtained from CTAN folder +% \path{macros/latex/ltabptch}). Our conviction is so strong +% that the ~longtable~ option loads---after ~longtable.sty~---the +% patch package ~ltabptch.sty~. If the user doesn't want this +% (maybe preferring her own arrangement with the vertical +% spacing), she can forbid it by calling ~nolongtablepatch~. +% +% The following code just collects some choices, which are +% then executed in section_\ref{ss:ExOpt}. We use an ~\if...~ +% without ~\newif~ since ~\if...true~ and ~\if...false~ +% would occur at most two times and only within the present +% package. (~\AtEndOfClass{\RequirePackage{edtable}}~ +% could be used instead, I just overlooked this. Now I don't +% change it because it allows to change the version requirement +% at one place only.) + +\let\if@LN@edtable\iffalse + +\DeclareOption{edtable}{\let\if@LN@edtable\iftrue} + +\DeclareOption{longtable}{\let\if@LN@edtable\iftrue + \PassOptionsToPackage{longtable}{edtable}} + +\DeclareOption{nolongtablepatch}{% + \PassOptionsToPackage{nolongtablepatch}{edtable}} + +% (/New v4.1) +% +% \subsection{% +% Switch among settings +% \unskip}\label{ss:v3opts} +% +% There is a bunch of package options that execute %% v4.2 +%% There is a bunch of package options, all of them executing +%% executing only user commands (see below). %% Cf. start of section. +% user commands only. +% +% Options ~left~ (~right~) put the line numbers on the left +% (right) margin. This works in all modes. ~left~ is the +% default. + +\DeclareOption{left}{\leftlinenumbers*} + +\DeclareOption{right}{\rightlinenumbers*} + +% Option ~switch~ (~switch*~) puts the line numbers on the +% outer (inner) margin of the text. This requires running +% the pagewise mode, but we turn off the page offset +% subtraction, getting sort of running numbers again. The +% ~pagewise~ option may restore true pagewise mode later. + +\DeclareOption{switch}{\setpagewiselinenumbers + \switchlinenumbers + \runningpagewiselinenumbers} + +\DeclareOption{switch*}{\setpagewiselinenumbers + \switchlinenumbers*% + \runningpagewiselinenumbers} + +% In twocolumn mode, we can switch the line numbers to +% the outer margin, and/or start with number 1 in each +% column. Margin switching is covered by the ~switch~ +% options. + +\DeclareOption{columnwise}{\setpagewiselinenumbers + \columnwiselinenumberstrue + \realpagewiselinenumbers} + +% The options ~pagewise~ and ~running~ select the major +% linenumber mechanism. ~running~ line numbers refer to a real +% counter value, which can be reset for any paragraph, +% even getting multiple paragraphs on one page starting +% with line number one. ~pagewise~ line numbers get a +% unique hidden number within the document, but with the +% opportunity to establish the page on which they finally +% come to rest. This allows the subtraction of the page +% offset, getting the numbers starting with 1 on top of each +% page, and margin switching in twoside formats becomes +% possible. The default mode is ~running~. +% +% The order of declaration of the options is important here +% ~pagewise~ must come after ~switch~, to overide running +% pagewise mode. ~running~ comes last, to reset the running +% line number mode, e.g, after selecting margin switch mode +% for ~pagewise~ running. Once more, if you specify all +% three of the options ~[switch,pagewise,running]~, the +% result is almost nothing, but if you later say +% ~\pagewiselinenumbers~, you get margin switching, with +% real pagewise line numbers. +% +\DeclareOption{pagewise}{\setpagewiselinenumbers + \realpagewiselinenumbers} + +\DeclareOption{running}{\setrunninglinenumbers} + +% The option ~modulo~ causes only those linenumbers to be +% printed which are multiples of five. + +\DeclareOption{modulo}{\modulolinenumbers\relax} + +% Option ~modulo*~ modifies ~modulo~ in working like +% ~\modulolinenumbers*~---see section_\ref{s:UserCmds}. + +\DeclareOption{modulo*}{\modulolinenumbers*\relax} + +% The package option ~mathlines~ switches the behavior of +% the ~{linenomath}~ environment with its star-form. +% Without this option, the ~{linenomath}~ environment does +% not number the lines of the display, while the star-form +% does. With this option, its just the opposite. +% +%%% 1999-06-10: renamed ~displaymath~ to ~mathlines~. + +\DeclareOption{mathlines}{\linenumberdisplaymath} + +% ~displaymath~ now calls for wrappers of the standard +% \LaTeX\ display math environment. This was previously +% done by ~mlineno.sty~. +% +% (New v4.3) Option `displaymath' becomes default according +% to Erik \mbox{Luijten}'s suggestion. I was finally convinced +% of this as soon as I discovered how to avoid a spurious line +% number above ~\begin{linenomath}~ (subsection_\ref{ss:DM}). +% ~\endlinenomath~ provides ~\ignorespaces~, so what could go +% wrong now? + +\DeclareOption{displaymath}{\PackageWarningNoLine{lineno}{% + Option [displaymath] is obsolete -- default now!}} +%% +%%\let\do@mlineno\relax +%%\DeclareOption{displaymath}{\let\do@mlineno\@empty} +% (/New v4.3) +% +% \subsection{% +% Compatibility with \texttt{hyperref} %% own subsec. v4.3. +% \unskip} +% The ~hyperref~ package, via ~nameref~, requires three more +% groups in the second argment of a ~\newlabel~. Well, why +% shouldn't it get them? (New v3.07) The presence of the +% ~nameref~ package is now detected automatically +% ~\AtBeginDocument~. (/New v3.07) (Fixed in v3.09) We try +% to be smart, and test ~\AtBeginDocument~ if the ~nameref~ +% package is loaded, but ~hyperref~ postpones the loading of +% ~nameref~ too, so this is all in vain. +% +% (New v4.3) But we can also test at the first ~\linelabel~. +% Regarding the error-message for misplaced ~\linelabel~ from v4.11: +% previously, ~\linenumbers~ rendered ~\linelabel~ the genuine +% version of ~\linelabel~ from the start on. This doesn't work +% now, since ~\@LN@linelabel~ may change its meaning after the +% first ~\linenumbers~ and before a next one (if there is some). +% (/New v4.3) + +\DeclareOption{hyperref}{\PackageWarningNoLine{lineno}{% + Option [hyperref] is obsolete. + \MessageBreak The hyperref package is detected automatically.}} + +\AtBeginDocument{% + \@ifpackageloaded{nameref}{% +%% +% (New v4.3) ``Global'' is merely ``symbolic'' ~\AtBeginDoc...~. +% If ~nameref~ is not detected here, the next ~\@LN@linelabel~ +% will do almost the same, then globally indeed. +%% + \gdef\@LN@ExtraLabelItems{{}{}{}}% + }{% + \global\let\@LN@@linelabel\@LN@linelabel + \gdef\@LN@linelabel{% +%% +% ~\@ifpackageloaded~ is ``preamble only'', its---very +% internal---preamble definition is replicated here: +%% + \expandafter + \ifx\csname ver@nameref.sty\endcsname\relax \else + \gdef\@LN@ExtraLabelItems{{}{}{}}% + \fi +%% +% Now aim at the ``usual'' behaviour: +%% + \global\let\@LN@linelabel\@LN@@linelabel + \global\let\@LN@@linelabel\relax + \@LN@linelabel + }% + }% +} + +% (/New v4.3) +% +% (New v4.1) +% \subsection{% +% A note on calling so many options +% \unskip} +% +% The number of package options may stimulate worrying about how to +% \emph{enter} all the options that one would like to use---they may +% not fit into one line. Fortunately, you can safely break code lines +% after the commas separating the option names in the ~\usepackage~ +% command (no comment marks needed). +% +% \subsection{% +% Execute options +% \unskip}\label{ss:ExOpt} +% +% We stop declaring options and execute the ones that are +% called by the user. (/New v4.1) + +\ProcessOptions + +% (New v4.1) Now we know whether ~edtable.sty~ is wanted +% and (if it is) with which options it is to be called. + +\if@LN@edtable \RequirePackage{edtable}[2005/03/07] \fi + +% (/New v4.1) +% +% \section{% +% Former package extensions +% \label{s:Xt}\unskip} +% +% The extensions in this section were previously supplied +% in separate ~.sty~ files. +% +% \subsection{% +% $display math$ +% \unskip}\label{ss:display} +%% (New v4.32) +% (New v4.3) From now on, you no longer need to type +% the ~{linenomath}~ environment with the ~\[~, ~{equation}~, +% and ~{eqnarray}~ environments---and you no longer need to +% use the former package option ~displaymath~ for this feature. +% (/New v4.3) +%% (/New v4.32) +% +% The standard \LaTeX\ display math environments are +% wrapped in a ~{linenomath}~ environment. +% +% (New 3.05) The ~[fleqn]~ option of the standard +% \LaTeX\ classes defines the display math +% environments such that line numbers appear just +% fine. Thus, we need not do any tricks when +% ~[fleqn]~ is loaded, as indicated by presents of +% the ~\mathindent~ register. (/New 3.05) +% +% (New 3.05a) for ~{eqnarray}~s we rather keep the +% old trick. (/New 3.05a) +% +% (New 3.08) Wrap ~\[~ and ~\]~ into ~{linenomath}~, +% instead of ~{displaymath}~. Also save the definition +% of ~\equation~, instead of replicating the current +% \LaTeX\ definition. (/New 3.08) + +%%\ifx\do@mlineno\@empty + \@ifundefined{mathindent}{ + +%% \AtBeginDocument{% + \let\LN@displaymath\[% + \let\LN@enddisplaymath\]% + \renewcommand\[{\begin{linenomath}\LN@displaymath}% + \renewcommand\]{\LN@enddisplaymath\end{linenomath}}% +% + \let\LN@equation\equation + \let\LN@endequation\endequation + \renewenvironment{equation}% + {\linenomath\LN@equation}% + {\LN@endequation\endlinenomath}% +%% } + + }{}% \@ifundefined{mathindent} -- 3rd arg v4.2, was \par! + +%%\AtBeginDocument{% + \let\LN@eqnarray\eqnarray + \let\LN@endeqnarray\endeqnarray + \renewenvironment{eqnarray}% + {\linenomath\LN@eqnarray}% + {\LN@endeqnarray\endlinenomath}% +%%} + +%%\fi + +% (UL) Indeed. The \LaTeX\ macros are saved for +% unnumbered mode, which is detected by ~\linenomath~. +% (/UL) +% +% \subsection{% +% Line numbers in internal vertical mode +% \unskip}\label{ss:ILN} +% +% The command ~\internallinenumbers~ adds line numbers in +% internal vertical mode, but with limitations: we assume +% fixed baseline skip. +% +% (v4.22) v3.10 provided a global (~\global\advance~) +% as well as a local version (star-form, using +% ~\c@internallinenumber~). ~\resetlinenumbers~ acted +% locally and was here used with the global version---save +% stack danger, \TeX book p._301---in v4.00 I +% disabled the global version therefore. Now I find that +% it is better to keep a global version, and the now global +% ~\resetlinenumbers~ is perfect for this. The global version +% allows continuing the ``internal'' numbers in the ensuing +% ``external'' text, and---unless reset by brackets +% argument---continuing the above series of line numbers. +% As with v3.10, the local version always starts with +% line number one. A new ~\@LN@iglobal~ steps ~\global~ly +% in the global version, otherwise it is ~\relax~. +% (I also remove all my stupid discussions as of v4.00. +% And I use ~\newcommand~.) (v4.22) + +\let\@LN@iglobal\global % v4.22 + +\newcommand\internallinenumbers{\setrunninglinenumbers + \let\@@par\internallinenumberpar + \ifx\@par\@@@par\let\@par\internallinenumberpar\fi + \ifx\par\@@@par\let\par\internallinenumberpar\fi + \ifx\@par\linenumberpar\let\@par\internallinenumberpar\fi + \ifx\par\linenumberpar\let\par\internallinenumberpar\fi + \@ifnextchar[{\resetlinenumber}%] + {\@ifstar{\let\c@linenumber\c@internallinenumber + \let\@LN@iglobal\relax % v4.22 + \c@linenumber\@ne}{}}% + } + +\let\endinternallinenumbers\endlinenumbers +\@namedef{internallinenumbers*}{\internallinenumbers*} +\expandafter\let\csname endinternallinenumbers*\endcsname\endlinenumbers + +\newcount\c@internallinenumber +\newcount\c@internallinenumbers + +\newcommand\internallinenumberpar{% + \ifvmode\@@@par\else\ifinner\@@@par\else\@@@par + \begingroup + \c@internallinenumbers\prevgraf + \setbox\@tempboxa\hbox{\vbox{\makeinternalLinenumbers}}% + \dp\@tempboxa\prevdepth + \ht\@tempboxa\z@ + \nobreak\vskip-\prevdepth + \nointerlineskip\box\@tempboxa + \endgroup + \fi\fi + } + +\newcommand\makeinternalLinenumbers{% + \ifnum\c@internallinenumbers>\z@ % v4.2 + \hb@xt@\z@{\makeLineNumber}% + \@LN@iglobal % v4.22 + \advance\c@linenumber\@ne + \advance\c@internallinenumbers\m@ne + \expandafter\makeinternalLinenumbers\fi + } + % TODO v4.3+: star: line numbers right!? cf. lnocapt.sty + +% +% \subsection{% +% Line number references with offset +% \unskip} +% +% This extension defines macros to refer to line +% numbers with an offset, e.g., to refer to a line +% which cannot be labeled directly (display math). +% This was formerly knows as ~rlineno.sty~. +% +% To refer to a pagewise line number with offset: +% \begin{quote} +% ~\linerefp[~<OFFSET>~]{~<LABEL>~}~ +% \end{quote} +% To refer to a running line number with offset: +% \begin{quote} +% ~\linerefr[~<OFFSET>~]{~<LABEL>~}~ +% \end{quote} +% To refer to a line number labeled in the same mode as currently +% selected: +% \begin{quote} +% ~\lineref[~<OFFSET>~]{~<LABEL>~}~ +% \end{quote} + +\newcommand\lineref{% + \ifx\c@linenumber\c@runninglinenumber + \expandafter\linerefr + \else + \expandafter\linerefp + \fi +} + +\newcommand*\linerefp[2][\z@]{{% + \let\@thelinenumber\thelinenumber + \edef\thelinenumber{\advance\c@linenumber#1\relax + \noexpand\@thelinenumber}% + \ref{#2}% +}} + +% This goes deep into \LaTeX's internals. + +\newcommand*\linerefr[2][\z@]{{% + \def\@@linerefadd{\advance\c@linenumber#1}% + \expandafter\@setref\csname r@#2\endcsname + \@linerefadd{#2}% +}} + +\newcommand*\@linerefadd[2]{\c@linenumber=#1\@@linerefadd\relax + \thelinenumber} + +%% TODO v4.3+: Insert `LN' in internal command names? +% +% \subsection{% +% Numbered quotation environments +% \unskip} +% +% The ~{numquote}~ and ~{numquotation}~ +% environments are like ~{quote}~ and +% ~{quotation}~, except there will be line +% numbers. +% +% An optional argument gives the number to count +% from. A star ~*~ (inside or outside the closing +% ~}~) prevent the reset of the line numbers. +% Default is to count from one. +% +% (v4.22: A local version using ~\c@internallinenumber~ +% might be useful, see subsection_\ref{ss:ILN}.) %% TODO v4.3+ + +\newcommand\quotelinenumbers + {\@ifstar\linenumbers{\@ifnextchar[\linenumbers{\linenumbers*}}} + +\newdimen\quotelinenumbersep +\quotelinenumbersep=\linenumbersep +\let\quotelinenumberfont\linenumberfont + +\newcommand\numquotelist + {\leftlinenumbers + \linenumbersep\quotelinenumbersep + \let\linenumberfont\quotelinenumberfont + \addtolength{\linenumbersep}{-\@totalleftmargin}% + \quotelinenumbers + } + +\newenvironment{numquote} {\quote\numquotelist}{\endquote} +\newenvironment{numquotation} {\quotation\numquotelist}{\endquotation} +\newenvironment{numquote*} {\quote\numquotelist*}{\endquote} +\newenvironment{numquotation*}{\quotation\numquotelist*}{\endquotation} + +% +% \subsection{% +% Frame around a paragraph +% \unskip} +% +% The ~{bframe}~ environment draws a frame around +% some text, across page breaks, if necessary. +% +% This works only for plain text paragraphs, +% without special height lines. All lines must be +% ~\baselineskip~ apart, no display math. + +\newenvironment{bframe} + {\par + \@tempdima\textwidth + \advance\@tempdima 2\bframesep + \setbox\bframebox\hb@xt@\textwidth{% + \hskip-\bframesep + \vrule\@width\bframerule\@height\baselineskip\@depth\bframesep + \advance\@tempdima-2\bframerule + \hskip\@tempdima + \vrule\@width\bframerule\@height\baselineskip\@depth\bframesep + \hskip-\bframesep + }% + \hbox{\hskip-\bframesep + \vrule\@width\@tempdima\@height\bframerule\@depth\z@}% + \nointerlineskip + \copy\bframebox + \nobreak + \kern-\baselineskip + \runninglinenumbers + \def\makeLineNumber{\copy\bframebox\hss}% + } + {\par + \kern-\prevdepth + \kern\bframesep + \nointerlineskip + \@tempdima\textwidth + \advance\@tempdima 2\bframesep + \hbox{\hskip-\bframesep + \vrule\@width\@tempdima\@height\bframerule\@depth\z@}% + } + +\newdimen\bframerule +\bframerule=\fboxrule + +\newdimen\bframesep +\bframesep=\fboxsep + +\newbox\bframebox + +% +% +% \section{% +% Move \scs{vadjust} items (New v4.00) +% \unskip}\label{s:MVadj} +% +% This section completes reviving ~\pagebreak~, ~\nopagebreak~, +% ~\vspace~, and the star and optional form of ~\\~. This was +% started in section_\ref{ss:output} and resumed in +% section_\ref{ss:MLN} and subsection_\ref{ss:CtrlLN}. +% The problem was explained in section_\ref{ss:output}: +% ~\vadjust~ items come out at a bad position, and the +% \LaTeX\ commands named before work with ~\vadjust~ indeed. +% Our solution was sketched there as well. +% +% According to the caveat in subsection_\ref{ss:CtrlLN} concerning +% ~\ifLineNumbers~, the \LaTeX\ commands enumerated may go +% wrong if you switch line numbering inside or at the end of +% a paragraph. +%% %% TODO v4.3+ +% +% \subsection{% +% Redefining \scs{vadjust} +% \unskip}\label{ss:PVadj} +% +% ~\vadjust~ will temporarily be changed into the following +% command. + +\def\PostponeVadjust#1{% + \global\let\vadjust\@LN@@vadjust +%% +% This undoes a ~\global\let\vadjust\PostponeVadjust~ which will +% start each of the refined \LaTeX\ commands. The ~\global~s +% are most probably superfluous. They might be useful should one +% ~\vadjust~ appear in a group starting after the change of +% ~\vadjust~ into ~\PostponeVadjust~. +% (UL) Even the undoing may be superfluous, cf._discussion +% in section_\ref{ss:ReDef} below. (UL) +%% + \vadjust{\penalty-\@Mppvacodepen}% + \g@addto@macro\@LN@vadjustlist{#1\@lt}% +} +\let\@LN@@vadjust\vadjust +\global\let\@LN@vadjustlist\@empty +\global\let\@LN@do@vadjusts\relax + +% These ~\global~s are just to remind that +% all the changes of the strings after ~\let~ should be +% ~\global~ (\TeX book p._301). ~\@LN@vadjustlist~ collects +% the ~\vadjust~ items of a paragraph. ~\PassVadjustList~ +% tears one ~\vadjust~ item for the current line out of +% ~\@LN@vadjustlist~ and puts it into ~\@LN@do@vadjusts~. +% The latter is encountered each line in ~\MakeLineNo~ +% (section_\ref{ss:MLN}), while those \LaTeX\ ~\vadjust~ +% commands will come rather rarely. So I decided that +% ~\@LN@do@vadjust~ is ~\relax~ until a ~\vadjust~ item +% is waiting. In the latter case, ~\@LN@do@vadjusts~ +% is turned into a list macro which resets itself to +% ~\relax~ when the other contents have been placed in +% the vertical list.---~\PassVadjustList~ is invoked by +% the output routine (section_\ref{ss:output}), so the +% ~\box255~ must be put back. + +\def\PassVadjustList{% + \unvbox\@cclv + \expandafter \@LN@xnext \@LN@vadjustlist \@@ + \@tempa \@LN@vadjustlist + \ifx\@LN@do@vadjusts\relax + \gdef\@LN@do@vadjusts{\global\let\@LN@do@vadjusts\relax}% + \fi + \expandafter \g@addto@macro \expandafter \@LN@do@vadjusts + \expandafter {\@tempa}% +} + +% +% \subsection{% +% Redefining the \LaTeX\ commands +% \unskip}\label{ss:ReDef} +% +% Now we change ~\pagebreak~ etc.\ +% so that they use ~\PostponeVadjust~ in place of ~\vadjust~. +% We try to do this as independently as possible of the +% implementation of the \LaTeX\ commands to be redefined. +% Therefore, we don't just copy macro definition code from any +% single implementation (say, latest \LaTeX) and insert our +% changes, but attach a conditional +% ~\global\let\vadjust\PostponeVadjust~ +% to their left ends in a way which should work rather +% independantly of their actual code. +% However, ~\vadjust~ should be the primitive again after +% execution of the command. So the ~\global\let...~ may be used +% only if it's guaranteed that a ~\vadjust~ is near.---(UL) +% Sure? In line numbering mode, probably each ~\vadjust~ +% coming from a \LaTeX\ command should be ~\PostponeVadjust~. +% ~\marginpar~s and floats seem to be the only cases which +% are not explicitly dealt with in the present section. +% This would be a way to avoid ~\my@nobreaktrue~! +% Of course, the ~\vadjust~s that the present package uses +% then must be replaced by ~\@LN@@vadjust~.---Maybe +% next time. (/UL) +%% %% TODO v4.3+ +% +% The next command and something else will be added to the +% \LaTeX\ commands we are concerned with here. + +\DeclareRobustCommand\@LN@changevadjust{% + \ifvmode\else\ifinner\else + \global\let\vadjust\PostponeVadjust + \fi\fi +} + +% (UL) What about math mode? Math display? Warn? (/UL) +%% %% TODO v4.3+ +% +% ~\@tempa~ will now become a two place macro which adds first +% argument (single token), enclosed by ~\ifLineNumbers~\,\dots +% ~\fi~ to the left of second argument. As long as we need it, +% we can't use the star form of ~\DeclareRobustCommand~ or +% the like, because AMS-\LaTeX\ uses ~\@tempa~ for ~\@ifstar~. + +\def\@tempa#1#2{% + \expandafter \def \expandafter#2\expandafter{\expandafter + \ifLineNumbers\expandafter#1\expandafter\fi#2}% +} + +% (UL) This ~\ifLineNumber~ can be fooled by +% ~\linenumbers~ ahead etc. It might be better to place +% a signal penalty in any case and let the output routine +% decide what to do. +%% +%% And when this has been done, remove warnings about this. +% (/UL) +% +% We use the occasion to switch off linenumbers where they +% don't work anyway and where we don't want them, +% especially in footnotes: + +\@tempa\nolinenumbers\@arrayparboxrestore + +% We hope this suffices $\dots$ let's check one thing +% at least: + +\CheckCommand*\@parboxrestore{\@arrayparboxrestore\let\\\@normalcr} + +% Now for the main theme of the section. +% The next lines assume that ~\vspace~, ~\pagebreak~, and +% ~\nopagebreak~ use ~\vadjust~ whenever they occur outside +% vertical mode; moreover, that they don't directly read +% an argument. Indeed ~\pagebreak~ and ~\nopagebreak~ first +% call something which tests for a left bracket ahead, +% while ~\vspace~ first tests for a star. + +\@tempa\@LN@changevadjust\vspace +\@tempa\@LN@changevadjust\pagebreak +\@tempa\@LN@changevadjust\nopagebreak + +% ~\\~, however, uses ~\vadjust~ only in star or optional form. +% We relax independency of implementation in assuming +% that ~\@normalcr~ is the fragile version of ~\\~ +% (and we use ~\@ifstar~!). +%% +%% \@ifstar reimplemented 1995/10/16, but seems to be much older. +%% TODO v4.3+: +%% \def\@LN@cr{% +%% \@ifnextchar*{\@LN@changevadjust\@normalcr}% +%% {\@ifnextchar[{\@LN@changevadjust\@normalcr}\@normalcr}% +%% } +%% ---same number of tokens, expansion step less. +%% +% (Using a copy of ~\\~ would be safer, but an ugly repetition +% of ~\protect~.) +%% %% TODO v4.3+ + +\DeclareRobustCommand\\{% + \ifLineNumbers + \expandafter \@LN@cr + \else + \expandafter \@normalcr + \fi +} +\def\@LN@cr{% + \@ifstar{\@LN@changevadjust\@normalcr*}% + {\@ifnextchar[{\@LN@changevadjust\@normalcr}\@normalcr}% +} + +% Moreover we hope that ~\newline~ never leads to a ~\vadjust~, +% although names of some commands invoked by ~\\~ contain +% ~newline~. At last, this seems to have been OK since 1989 or +% even earlier. +% +% \modulolinenumbers[1] +% \firstlinenumber{0} +% Let's have a few tests.\vspace*{.5\baselineskip} +% Testing ~\pagebreak~ and ~\nopagebreak~ would be too expensive +% here, but---oops!---we have just experienced a successful +% ~\vspace*{.5\baselineskip}~. A +% ~\\*[.5\baselineskip]~\\*[.5\baselineskip] may look even more +% drastical, but this time we are happy about it. Note that the +% line numbers have moved with the lines. Without our changes, +% one line number\vadjust{\kern.5\baselineskip} would have +% ``anticipated'' the move of the next line, just as you can +% observe it now. +% (/New v4.00) +% +% \switchlinenumbers +% +% \subsection{% +% Reminder on obsoleteness +% \unskip} +% +% (New v4.1) We have completed inclusion of the earlier +% extension packages ~linenox0.sty~, ~linenox1.sty~, and +% ~lnopatch.sty~. If one of them is loaded, though, +% we produce an error message before something weird happens. +% We avoid ~\newif~ because the switchings occur so rarely. + +\AtBeginDocument{% + \let\if@LN@obsolete\iffalse + \@ifpackageloaded{linenox0}{\let\if@LN@obsolete\iftrue}\relax + \@ifpackageloaded{linenox1}{\let\if@LN@obsolete\iftrue}\relax + \@ifpackageloaded{lnopatch}{\let\if@LN@obsolete\iftrue}\relax + \if@LN@obsolete + \PackageError{lineno}{Obsolete extension package(s)}{% + With lineno.sty version 4.00 or later,\MessageBreak + linenox0/linenox1/lnopatch.sty must no longer be loaded.}% + \fi +} + +% +% \modulolinenumbers[1] +% \section{% +% The final touch +% \unskip} +% +% There is one deadcycle for each line number. + +\advance\maxdeadcycles 100 + +\endinput + +% +% \section{% +% The user commands +% \unskip}\label{s:UserCmds} +% +% The user commands to turn on and off line numbering +% are +% \begin{description}\item +% [|\linenumbers] \ \par +% Turn on line numbering in the current mode. +% +% \item +% [|\linenumbers*] \ \par$\qquad$ +% and reset the line number to 1. +% \def\NL{<number>]}\item +%% %% Boldface italic occurs here, which is evil. (UL) +% [|\linenumbers[\NL] \ \par$\qquad$ +% and start with <number>. +% \item +% [|\nolinenumbers] \ \par +% Turn off line numbering. +% \item +% [|\runninglinenumbers*[\NL] \ \par +% Turn on ~running~ line numbers, with the same optional +% arguments as ~\linenumbers~. The numbers are running +% through the text over pagebreaks. When you turn +% numbering off and on again, the numbers will continue, +% except, of cause, if you ask to reset or preset the +% counter. +% \item +% [|\pagewiselinenumbers] \ \par +% Turn on ~pagewise~ line numbers. The lines on each +% page are numbered beginning with one at the first +% ~pagewise~ numbered line. +% \item +% [|\resetlinenumber[\NL] \ \par +% Reset ~[~Set~]~ the line number to 1 +% ~[~<number>~]~. +% \item +% [|\setrunninglinenumbers] \ \par +% Switch to ~running~ line number mode. Do \emph{not} +% turn it on or off. +% \item +% [|\setpagewiselinenumbers] \ \par +% Switch to ~pagewise~ line number mode. Do \emph{not} +% turn it on or off. +% \item +% [|\switchlinenumbers*] \ \par +% Causes margin switching in pagewise modes. With the +% star, put the line numbers on the inner margin. +% \item +% [|\leftlinenumbers*] \ \par +% \item +% [|\rightlinenumbers*] \ \par +% Set the line numbers in the left/right margin. With the +% star this works for both modes of operation, without +% the star only for the currently selected mode. +% \item +% [|\runningpagewiselinenumbers] \ \par +% When using the pagewise line number mode, do not +% subtract the page offset. This results in running +% line numbers again, but with the possibility to switch +% margins. Be careful when doing line number +% referencing, this mode status must be the same while +% setting the paragraph and during references. +% \item +% [|\realpagewiselinenumbers] \ \par +% Reverses the effect of ~\runningpagewiselinenumbers~. +% \item +% [|\modulolinenumbers[\NL] \ \par +% Give a number only to lines which are multiples of +% ~[~<number>~]~. If <number> is not specified, the +% current value in the counter ~linenumbermodulo~ is +% retained. <number>=1 turns this off without changing +% ~linenumbermodulo~. The counter is initialized to 5. +%% +%% %% TODO v4.3+: `counter', he says. Cf._above. +%% +%% (New v4.31) +% \item +% [|\modulolinenumbers*[\NL] \ \par +% Like ~\modulolinenumbers~, the only difference being +% that the first line number after a ~\linenumbers~ +% (or ~\runninglinenumbers~, ~\pagewiselinenumbers~, +% ~\quotelinenumbers~) is printed regardless of the +% modulo---yet `1' is printed only after (or \dots) +% ~\firstlinenumber{1}~. +% This also applies to the first line of a +% ~{linenumbers}~ or respective environment. +% See subsection_\ref{ss:Mod} for another explanation. +% The behaviour may be unsatisfactory with pagewise +% line-numbering. +%% (/New v4.31) +%% (New v4.00) +% \item +% [|\firstlinenumber] \ \par +% ~\firstlinenumber{~<filino>~}~ brings about that +% (after it) line numbers less than <filino> do +% \emph{not} appear in the margin. Moreover, with +% ~\modulolinenumbers[~<number>~]~, just the line +% numbers which are <filino> plus a multiple of +% <number> are printed.---If you had +% ~\firstlinenumber{~<pos>~}~ with some $\mbox{<pos>}>0$ +% and want to switch to printing multiples of, e.g., +% 4, you best do ~\modulolinenumbers[4]~ and +% ~\firstlinenumber{0}~. (See subsection_\ref{ss:Mod} +% for technical details.) +%% (/New v4.00) +% \item +% [|\linenumberdisplaymath] \ \par +% Number the lines of a display math in a ~{linenomath}~ +% environment, but do not in a ~{linenomath*}~ +% environment. This is used by the package option +% ~[mathlines]~. +% \item +% [|\nolinenumberdisplaymath] \ \par +% Do not Number the lines of a display math in a +% ~{linenomath}~ environment, but do in a +% ~{linenomath*}~ environment. This is the default. +% \item +% [|\linelabel] \ \par +% Set a ~\linelabel{~<foo>~}~ to the line number where +% this commands is in. Refer to it with the \LaTeX\ +% referencing commands ~\ref{~<foo>~}~ and +% ~\pageref{~<foo>~}~. +% \end{description} +% The commands can be used globally, locally within groups +% or as environments. It is important to know that they +%% +%% %% TODO: \linelabel? others? +%% +% take action only when the ~\par~ is executed. The +%% +%% %% TODO: sure? ~\modulo...~, e.g.? well, in a sense ... +%% +% ~\end{~<mode>~linenumbers}~ commands provide a ~\par~. +% Examples: +% \begin{verse} +% ~{\linenumbers~ <text> ~\par}~ \\ +% \ \\ +% ~\begin{linenumbers}~ \\ +% <text> \\ +% ~\end{linenumbers}~ \\ +% \ \\ +% <paragraph> ~{\linenumbers\par}~ \\ +% \ \\ +% ~\linenumbers~ \\ +% <text> ~\par~ \\ +% ~\nolinenumbers~ \\ +% \ \\ +% ~\linenumbers~ \\ +% <paragraph> ~{\nolinenumbers\par}~ \\ +% \end{verse} +% (New v4.00) +% However, the examples containing <paragraph> show what you +% should \emph{not} do, at least if you use ~\pagebreak~, +% ~\nopagebreak~, ~\vspace~, ~\\*~ or +% ~\\[~<space>~]~---cf._section_\ref{s:MVadj}. +% +% The same care should be applied to the ``wizard'' devices +% ~\ifLineNumbers~ (subsection_\ref{ss:CtrlLN}) and +% ~\PostponeVadjust~ (section_\ref{ss:PVadj}). +% (/New v4.00) +% +% (New v4.11) Oh, and the commands and environments of +% section_{s:Xt} are missing. Sorry, I am in a hurry now. +% May be next time.% %% TODO v4.3+ +% ---And the environments ~{linenomath}~ and ~{linenomath*}~should +% get an own paragraph. In short, each math display, equation, +% or ~{eqnarray}~ should be ``wrapped'' in one of ~{linenomath}~ +% and ~{linenomath*}~. +% +% \subsection{% +% Customization hooks +% \unskip} +% +% There are several hooks to customize the appearance of the +% line numbers, and some low level hooks for special +% effects. +% \begin{description}\item +% [|\thelinenumber] \ \par +% This macro should give the representation of the line +% number in the \LaTeX-counter ~linenumber~. The +% default is provided by \LaTeX: \par$\qquad$ +% ~\arabic{linenumber}~ +% \item +% [|\makeLineNumberLeft] \ \par +% This macro is used to attach a line number to the left +% of the text page. This macro should fill an ~\hbox to 0pt~ +% which will be placed at the left margin of the +% page, with the reference point aligned to the line to +% which it should give a number. Please use the macro +% ~\LineNumber~ to refer to the line number. +% +% The default definition is \par$\qquad$ +% ~\hss\linenumberfont\LineNumber\hskip\linenumbersep~ +% \item +% [|\makeLineNumberRight] \ \par +% Like ~\makeLineNumberLeft~, but for line numbers on +% the right margin. +% +% The default definition is \par$\qquad$ +% ~\linenumberfont\hskip\linenumbersep\hskip\textwidth~ \par$\qquad$ +% ~\hbox to\linenumberwidth{\hss\LineNumber}\hss~ +% \item +% [|\linenumberfont] \ \par +% This macro is initialized to \par$\qquad$ +% ~\normalfont\tiny\sffamily~ +% \item +% [|\linenumbersep] \ \par +% This dimension register sets the separation of the +% linenumber to the text. Default value is ~10pt~. +% \item +% [|\linenumberwidth] \ \par +% This dimension register sets the width of the line +% number box on the right margin. The distance of the +% right edge of the text to the right edge of the line +% number is ~\linenumbersep~ + ~\linenumberwidth~. The +% default value is ~10pt~. +% \item +% [|\theLineNumber] (for wizards) \ \par +% This macro is called for printing a ~\newlabel~ entry +% to the aux-file. Its definition depends on the mode. +% For running line numbers it's just ~\thelinenumber~, +% while in pagewise mode, the page offset subtraction +% is done in here. +% \item +% [|\makeLineNumber] (for wizards) \ \par +% This macro produces the line numbers. The definition +% depends on the mode. In the running line numbers +% mode it just expands ~\makeLineNumberLeft~. +% \item +% [|\LineNumber] (for wizards) \ \par +% This macro is called by ~\makeLineNumber~ to typeset +% the line number. This hook is changed by the modulo +% mechanism +%% %%%. +% and by ~\firstlinenumber~. +%% %% New v4.00 +% \end{description} +%% +%% TODO: \stepLineNumber---another wizard command!? +%% Not sure, may be retreated. +% \end{document}%D +------------------------------------------------------------------------------ + %SSTOPP +%% TODO v4.3+: Check for unwanted comment marks in new comments +%% (resulting from manual aligning): search `New v4.2' +%% and/or ` % '! +%% TODO v4.3+: Check for missing comment marks where a paragraph +%% should end/start. Also to prevent empty "code" lines. +%% Especially, new comments at section ends must be +%% followed by comment mark lines. +%% And prevent ~\par~s from blank lines in definitions! +%% See `visual space' above. +%% For proper appearance in lineno.tex, note that a comment +%% in a final code line changes behaviour. +%% TODO v4.3+: Require README for redistribution? +%% TODO v4.3+: Since discussions of code have increased so much, it +%% would be appropriate not to give to this file +%% extension `.sty' (e.g., `dty'!??). ?? Is quickly read though! +%% A .sty extraction may be possible even if the present +%% file is neither a .doc nor a .dtx. (!???) +%% Use awk line below (etc.) for .doc at least; + .ins or so. +%% ^ must not be caps! To escape awk. +%% TODO v4.3+: Underfull lines!? (due to long code quotations) +%% TODO v4.3+: Sometimes paragraph indents may be appropriate. +%% TODO Swap first line (`\iffalse...') with corresponding below. + Or do *not* swap, maybe nawk is more reliable. +%% TODO v4.3+: Ponder Stephan's mail from 2004/09/02. +%% TODO v4.3+: +%% use \@ET@makeLineNumber. +%% plus almost all `(UL)' +%% plus lots of bad boxes messages +%% change v4.3 TODOs when postponed +%% remove {old} environments. + +------------------------------------------------------------------------------ + +# awk command lines for v4.00, mixed with former ones: + +echo "Don't bother about unknown 'iffalse'." # SHELL1 +nawk '/A[W]K/' lineno.sty | nawk -f - lineno.sty >lineno.tex; # SHELL1 +latex lineno; latex lineno; latex lineno; latex lineno; # SHELL1 + +BEGIN{DOC=-1; # AWK DOC A W K + BEGINCODE = "\\begin{code}\\begin{verbatim}"; # AWK + ENDCODE = "\\end{verbatim}\n\\end{code}"; } # AWK + BEGINCODE = "% \\begin{macrocode}"; # DOC A W K + ENDCODE = "% \\end{macrocode}"; } # DOC A W K +/^[ \t]*$/ { ECNT++; next; } # AWK DOC A W K +/\\documentclass/{ sub("article","ltxdoc") } # DOC A W K +/%D$/ { sub("^%* *",""); sub("%D$",""); # DOC A W K + print > "lineno.drv"; next } # DOC A W K +/^%%/ { next; } # AWK DOC A W K +/^%/ { if (!DOC) { print ENDCODE; } # AWK DOC A W K + DOC=1; ECNT=0; # AWK DOC A W K + sub("^% *",""); # AWK + sub("^% *","% "); # DOC A W K + print; next; } # AWK DOC A W K +/%VERSION/ { sub("%VERSION",""); print; next; } # AWK +/%SSTOPP/ { exit } # AWK +DOC<0 { next } # AWK DOC A W K +/^-+-$/ { if (!DOC) print ENDCODE; exit } # AWK DOC A W K +{ if (DOC) { ECNT=DOC=0; print BEGINCODE; } # AWK DOC A W K + while (ECNT>0) { print " "; ECNT--; } # AWK DOC A W K + print $0; } # AWK DOC A W K + +# New v4.00, UL: know nothing about awk; found present solution +# in hours of trial and error. + +% Earlier (should be inhibited by %SSTOPP above and otherwise): +echo "expect errors for unknown commands 'iffalse' and 'fi'";# SHELL0 SHELL#1 +awk '/A[W]K/' lineno.sty | awk -f - lineno.sty >lineno.tex; # SHELL0 +latex lineno; latex lineno; latex lineno; latex lineno; # SHELL0 +nawk '/A[W]K/' lineno4.sty | nawk -f - lineno4.sty >lineno4.tex; # SHELL#1 +latex lineno4; latex lineno4; latex lineno4; latex lineno4; # SHELL#1 + +awk '/DOC A [W] K/' lineno.sty | awk -f - lineno.sty >lineno.doc; # DOC SH + +BEGIN{DOC=-1; # A#WK DOC A W K + BEGINCODE = "\\begin{code}\\begin{verbatim}"; # A#WK + ENDCODE = "\\end{verbatim}\n\\end{code}"; } # A#WK + BEGINCODE = "% \\begin{macrocode}"; # DOC A W K + ENDCODE = "% \\end{macrocode}"; } # DOC A W K +/^[ \t]*$/ { ECNT++; next; } # A#WK DOC A W K +/\\documentclass/{ sub("article","ltxdoc") } # DOC A W K +/%D$/ { sub("^%* *",""); sub("%D$",""); # DOC A W K + print > "lineno.drv"; next } # DOC A W K +/^%%/ { next; } # A#WK DOC A W K +/^%/ { if (!DOC) { print ENDCODE; } # A#WK DOC A W K + DOC=1; ECNT=0; # A#WK DOC A W K + sub("^% *",""); # A#WK + sub("^% *","% "); # DOC A W K + print; next; } # A#WK DOC A W K +DOC<0 { next } # A#WK DOC A W K +/^-+-$/ { if (!DOC) print ENDCODE; exit } # A#WK DOC A W K +{ if (DOC) { ECNT=DOC=0; print BEGINCODE; } # A#WK DOC A W K + while (ECNT>0) { print " "; ECNT--; } # A#WK DOC A W K + print $0; } # A#WK DOC A W K + + +------------------------------------------------------------------------------ + +If you are looking here because of the two top lines of the file: + +A .tex documentation of this macro file can be obtained by + + sh lineno.sty + +under UNIX.--You may find this hint little helpful. One +reason may be that the awk versions to which you have access +don't work suitably. Another reason may be that you don't have +access to UNIX (in some sense). However, a .tex, .dvi, or .pdf +version of such a documentation should be available from CTAN, +in the same folder as the present file. When we typed this, that +folder was /macros/latex/contrib/lineno. If this has changed in +the meantime, a CTAN search should lead you to a folder +containing such a documentation. Or you may get help from one of +the e-mail addresses above. + + diff --git a/Master/texmf-dist/tex/latex/lineno/vplref.sty b/Master/texmf-dist/tex/latex/lineno/vplref.sty new file mode 100644 index 00000000000..51dd815bd48 --- /dev/null +++ b/Master/texmf-dist/tex/latex/lineno/vplref.sty @@ -0,0 +1,72 @@ +%% `vplref.sty' +%% -- extended line number referencing with lineno.sty. + +\def\filedate{2005/04/25} \def\fileversion{0.2} + +%% Copyright (C) 2004, 2005 Uwe Lueck, +%% http://contact-ednotes.sty.de.vu --author-maintained +%% -- support of lineno.sty for varioref.sty. + +%% This file can be redistributed and/or modified under +%% the terms of the LaTeX Project Public License; either +%% version 1.3 of the License, or any later version. +%% The latest version of this license is in +%% http://www.latex-project.org/lppl.txt +%% We did our best to help you, but there is NO WARRANTY. + +%% USAGE: +% +% \vpagelineref{<label>} expands to +% +% a) \ref{<label>} +% -- if on same page as \linelabel{<label>} +% +% b) \LineWithPage{<label>} -- otherwise. +% +% \LineWithPage{<label>} expands -- by default -- to +% +% \pageref{<label>}.\ref{<label>} +% +% This can be customized by editing +% +% \renewcommand*{\LineWithPage}[1]{\pageref{#1}.\ref{#1}} +% +% in your document preamble, after vplref.sty has been loaded +% (which may have happened through lineno.sty with option +% `addpageno'). + +%% IMPLEMENTATION: + +\NeedsTeXFormat{LaTeX2e}[1994/12/01] %% \Declare...* +\ProvidesPackage{vplref}[\filedate\space v\fileversion] + +\AtBeginDocument{\RequirePackage{lineno,varioref}} + +%% Anderer Ansatz: GPNo (\FirstOnPage) + +\DeclareRobustCommand*\vpagelineref[1]{{% +% \def\reftextcurrent{\lineref{#1}}%% First vpageref arg. + \let\reftextfaraway\LineWithPage + \def\reftextafter{\reftextfaraway{#1}}% + \let\reftextbefore\reftextafter + \let\reftextfaceafter\reftextafter + \let\reftextfacebefore\reftextafter +%% <- Looks somewhat stupid, but varioref.sty has its merits +%% as compared with the mechanism in ednotes.sty. + \vpageref[\ref{#1}][]{#1}%% The robust alternative. +%% Here and with \LineWithPage, \lineref seems more appropriate +%% than \ref, but it produces errors when labels have not been +%% defined. This seems to be an incompatibility with lineno.sty. +}} + +%% Customizable format for different page: +\newcommand*\LineWithPage[1]{\pageref{#1}.\ref{#1}} + +\endinput + +VERSION HISTORY: +v0.1 2004/10/19 First, sent to Sergei Mariev. +v0.11 2004/10/19 Fit to recent varioref version; + sent to Sergei. +v0.2 2005/04/25 \Require... \AtBeginDocument. + |