1                                 \iffalse; awk '/S[H]ELL1/' lineno.sty|sh;exit; 

     2                                      ... see bottom for .tex documentation ... 

     3 

     4 Macro file lineno.sty for LaTeX: attach line numbers, refer to them. 

     5                                                                            \fi 

     6 \def\fileversion{v4.41} \def\filedate{2005/11/02}                     %VERSION

     7 

     8 %%% Copyright 1995--2003 Stephan I. B"ottcher <boettcher@physik.uni-kiel.de>; 

     9 %%% Copyright 2002--2005 Uwe L"uck, http://www.contact-ednotes.sty.de.vu 

    10 %%%                      for version 4 and code from former Ednotes bundle 

    11 %%%                      --author-maintained. 

    12 %%% 

    13 %%% This file can be redistributed and/or modified under 

    14 %%% the terms of the LaTeX Project Public License; either 

    15 %%% version 1.3a of the License, or any later version.

    16 %%% The latest version of this license is in

    17 %%%     http://www.latex-project.org/lppl.txt

    18 %%% We did our best to help you, but there is NO WARRANTY. 

    19 % 

    20 %%% $Id: lineno.sty,v 1.1 2006/02/25 18:18:12 wenzelm Exp $ %% was v4.00.

    21 %                                                      \title{\texttt{\itshape 

    22 %%                                       %% (UL 2004/10/09:) Italic TT is evil

    23 %%                                       %% ... or nice front page layout!? 

    24 %%

    25 %         lineno.sty \ \fileversion\ \filedate 

    26 %                                                               \unskip}\\\ \\

    27 %          A \LaTeX\ package  to attach 

    28 % \\        line numbers to paragraphs

    29 %                                                            \unskip}\author{% 

    30 %              Stephan I. B\"ottcher 

    31 %  \\          Uwe L\"uck 

    32 %                                                              \unskip}\date{% 

    33 %            boettcher@physik.uni-kiel.de 

    34 %  \\        http://contact-ednotes.sty.de.vu 

    35 %% \\        stephan@nevis.columbia.edu

    36 %% \\        Stephan.Boettcher@cern.ch                     

    37 %                                                                          \\}

    38 %

    39 %                                      \documentclass[a4paper,12pt]{article}%D

    40 %                                                        \usepackage{lineno}%D 

    41 %%                                                              %% (New v4.00)

    42 %                                                     \catcode`\_\active\let_~ 

    43 %%                                               %% Beware math!? (/New v4.00) 

    44 %                                                                \def~{\verb~} 

    45 %                                                               \let\lessthan< 

    46 %                                                           \catcode`\<\active

    47 %                                   \def<#1>{$\langle${\itshape#1}\/$\rangle$}

    48 %                                                           \catcode`\|\active

    49 %%                                        (New v4.1: \tt star; in box anyway.) 

    50 %                                                  \def|#1{\ttfamily\string#1}

    51 %%                                               \def|#1{{\ttfamily\string#1}}

    52 %%                                                                 (/New v4.1) 

    53 %                                                        \newenvironment{code}

    54 %                                                     {\par\runninglinenumbers

    55 %                                                       \modulolinenumbers[1]%

    56 %                                                           \linenumbersep.3em

    57 %                                                                \footnotesize

    58 %                                                          \def\linenumberfont

    59 %                                                  {\normalfont\tiny\itshape}}

    60 %                                                                           {} 

    61 %%                                                              %% (New v4.00)

    62 %                                           {\makeatletter \gdef\scs#1{\texttt

    63 %                                                {\protect\@backslashchar#1}}}

    64 %                                                  \def\old{\par\footnotesize}

    65 %%                                                             %% (/New v4.00)

    66 %%                                                               %% (New v4.1) 

    67 %                                                          {\catcode`\/\active

    68 %                                     \gdef\path{\begingroup\catcode`\/\active

    69 %                                                          \let/\slash\dopath}

    70 %                                 \gdef\dopath#1{\slash\unpenalty#1\endgroup}}

    71 %%                                                              %% (/New v4.1)

    72 %

    73 %                                                           \begin{document}%D

    74 %%                                                         \DocInput{lineno}%D

    75 %                                                         \pagewiselinenumbers

    76 %                                                                   \maketitle 

    77 %                                                         \pagestyle{headings}

    78 %                                                             \tableofcontents

    79 %                                                                      \sloppy

    80 % 

    81 %%                                      %% New v4.00: `...section{%' + \unskip 

    82 %                                                                   \section{%

    83 %                    Introductions 

    84 %%                                                           %% New v4.00: `s'

    85 %                                                                     \unskip}

    86 % 

    87 % (New v4.00)           Parts of former first section 

    88 % have been rendered separate subsections for package 

    89 % version_v4.00.                         (/New v4.00) 

    90 % 

    91 %                                                                \subsection{% 

    92 %               Introduction to versions $\textrm{v}\lessthan4$

    93 %                                                                     \unskip} 

    94 % 

    95 % This package provides line numbers on paragraphs.

    96 % After \TeX\ has broken a paragraph into lines there will

    97 % be line numbers attached to them, with the possibility to

    98 % make references  through the \LaTeX\ ~\ref~, ~\pageref~

    99 % cross reference mechanism.  This includes four issues:

   100 %                                                              \begin{itemize}

   101 % \item   attach a line number on each line,

   102 % \item   create references to a line number,

   103 % \item   control line numbering mode,

   104 % \item   count the lines and print the numbers.

   105 %                                                                \end{itemize}

   106 % The first two points are implemented through patches to

   107 % the output routine.  The third by redefining ~\par~, ~\@par~

   108 % and ~\@@par~.  The counting is easy, as long as you want

   109 % the line numbers run through the text.  If they shall

   110 % start over at the top of each page, the aux-file as well

   111 % as \TeX s memory have to carry a load for each counted line.

   112 %

   113 % I wrote this package for my wife Petra, who needs it for

   114 % transcriptions of interviews.  This allows her to

   115 % precisely refer to passages in the text.  It works well

   116 % together with ~\marginpar~s, but not too well with displaymath.

   117 % ~\footnote~s are a problem, especially when they

   118 % are split, but we may get there. 

   119 % (New v4.00 UL) Version v4.00 overcomes the problem, I believe. 

   120 % (/UL /New v4.00)

   121 %

   122 % lineno.sty works

   123 % surprisingly well with other packages, for

   124 % example, ~wrapfig.sty~.  So please try if it

   125 % works with whatever you need, and if it does,

   126 % please tell me, and if it does not, tell me as

   127 % well, so I can try to fix it.

   128 %

   129 %                                                                \subsection{%

   130 %               Introduction to versions v4.00ff. (UL) 

   131 %                                                                     \unskip}

   132 % 

   133 % ~lineno.sty~ has been maintained by Stephan until version_v3.14.

   134 % From version_v4.00 onwards, maintenance is shifting towards 

   135 % Uwe L\"uck (UL), who is the author of v4\dots code and of v4\dots 

   136 % changes in documentation. This came about as follows. 

   137 % 

   138 % Since late 2002, Christian Tapp and Uwe L\"uck have employed 

   139 % ~lineno.sty~ for their ~ednotes.sty~, a package supporting 

   140 % critical editions---cf.

   141 %                                                                  \[\mbox{\tt 

   142 %     http://ednotes.sty.de.vu 

   143 %                                                                   \unskip}\]

   144 % ---while you find ~ednotes.sty~ and surrounding files in 

   145 % CTAN folder \path{macros/latex/contrib/ednotes}.

   146 % 

   147 % Soon, some weaknesses of ~lineno.sty~ showed up, mainly since 

   148 % Christian's critical editions (using ~ednotes.sty~) needed lots 

   149 % of ~\linelabel~s and footnotes. (These weaknesses are due to 

   150 % weaknesses of \LaTeX's ~\marginpar~ mechanism that Stephan 

   151 % used for ~\linelabel~.) So we changed some ~lineno.sty~ 

   152 % definitions in some extra files, which moreover offered new 

   153 % features. We sent these files to Stephan, hoping he would take 

   154 % the changes into ~lineno.sty~. However, he was too short of time. 

   155 % 

   156 % Writing a TUGboat article on Ednotes in 2004, we hoped to 

   157 % reduce the number of files in the Ednotes bundle and so asked 

   158 % Stephan again. Now he generously offered maintenance to me, so 

   159 % I could execute the changes on my own. 

   160 % 

   161 % The improvements are as follows: 

   162 %                                                         \begin{itemize}\item 

   163 % [(i)]   Footnotes placement approaches intentions better 

   164 % (footnotes formerly liked to pile up at late pages). 

   165 %                                                                        \item 

   166 % [(ii)]  The number of ~\linelabel~s in one paragraph is no longer 

   167 % limited to 18. 

   168 %                                                                        \item 

   169 % [(iii)] ~\pagebreak~, ~\nopagebreak~, ~\vspace~, and the star 

   170 % and optional versions of ~\\~ work as one would expect 

   171 % (section_\ref{s:MVadj}).                                   %% Added for v4.1

   172 %                                                                        \item 

   173 % [(iv)]  A command is offered which chooses the first line number 

   174 % to be printed in the margin 

   175 % (subsection_\ref{ss:Mod}).                                 %% Added for v4.1

   176 %                                                                        \item 

   177 % [(v)]   (New v4.1) \LaTeX\ tabular environments (optionally) 

   178 % get line numbers as well, and you can refer to them in the 

   179 % usual automatic way. (It may be considered a shortcoming that, 

   180 % precisely, \emph{rows} are numbered, not lines.---See 

   181 % subsection_\ref{ss:Tab}.) 

   182 %                                                                        \item 

   183 % [(vi)]  We are moving towards referring to math items 

   184 % (subsection_\ref{ss:MathRef} and the hooks in 

   185 % subsection_\ref{ss:LL}). 

   186 % (/New v4.1) 

   187 %                                                                 \end{itemize}

   188 % (Thanks to Stephan for making this possible!)

   189 % 

   190 %% Unpublish: 

   191 %% You may trace the earlier developments of these changes by 

   192 %% requesting our files ~linenox0.sty~, ~linenox1.sty~, and 

   193 %% ~lnopatch.sty~. Most of our changes have been in ~linenox0.sty~. 

   194 %% Our ~linenox1.sty~ has extended ~linenox0.sty~ for one single 

   195 %% purpose in a not very stable way. 

   196 %%% (See ~\linenumberpar~ below). 

   197 %% ~lnopatch.sty~ has done the first line number thing referred 

   198 %% to in case_(iv) up to now. 

   199 %% (New v4.1) 

   200 %% Case_(v) earlier was provided by our ~edtab02.sty~---now 

   201 %% called ~edtable.sty~. 

   202 %% (/New v4.1) 

   203 % 

   204 % Ednotes moreover profits from Stephan's offer with regard 

   205 % to the documentation of our code which yielded these 

   206 % improvements formerly. This documentation now becomes 

   207 % printable, being part of the ~lineno.sty~ documentation. 

   208 % 

   209 % Of course, Stephan's previous ~lineno.sty~ versions were a great 

   210 % and ingenious work and exhibit greatest \TeX pertise. I never 

   211 % could have done this. I learnt a lot in studying the code when 

   212 % Christian pointed out strange output results and error 

   213 % messages, and there are still large portions of ~lineno.sty~ 

   214 % which I don't understand (consider only pagewise numbering of 

   215 % lines). Fortunately, Stephan has offered future help if 

   216 % needed.---My code for attaching line numbers to \emph{tabular 

   217 % environments} (as mentioned above, now still in 

   218 % ~edtable.sty~) %%                                                      %% TODO

   219 % developed from macros which Stephan and Christian experimented 

   220 % with in December 2002. Stephan built the basics. 

   221 % (However, I then became too proud to follow his advice only to 

   222 % use and modify ~longtable.sty~.)

   223 % 

   224 % There are some issues concerning use of counters on which I 

   225 % don't agree with Stephan and where I would like to change the 

   226 % code if ~lineno.sty~ is ``mine'' as Stephan offered. However, 

   227 % Stephan is afraid of compatibility problems from which, in 

   228 % particular, his wife could suffer in the near future. So he 

   229 % demanded that I change as little as possible for my first 

   230 % version. Instead of executing changes that I plan I just offer 

   231 % my opinions at the single occasions. I hope to get in touch 

   232 % this way with users who consider subtle features vital which I 

   233 % consider strange. 

   234 % 

   235 % On the other hand, the sections on improvements of the 

   236 % implementation have been blown up very much and may be tiring 

   237 % and litte understandable for mere \emph{users}. These users 

   238 % may profit from the present presentation just by jumping to 

   239 % sections_\ref{s:Opts} and_\ref{s:UserCmds}. There is a user's 

   240 % guide ulineno.tex which may be even more helpful, but it has 

   241 % not been updated for a while.                                        %% TODO

   242 % 

   243 %                                                                \subsection{%

   244 %               Availability 

   245 %                                                                     \unskip}

   246 % 

   247 % In case you have found the present file otherwise than from 

   248 % CTAN: A recent version and documentation of this package 

   249 % should be available from CTAN folder 

   250 % \path{macros/latex/contrib/lineno}.

   251 % Or mail to one of the addresses at top of file. 

   252 % 

   253 %                                                                \subsection{% 

   254 %               Introductory code

   255 %                                                                     \unskip}

   256 % 

   257 % This style option is written for \LaTeXe, November 1994 or later,

   258 % since we need the ~\protected@write~ macro. 

   259 % 

   260 % (New v4.00)               And we use ~\newcommand*~ for 

   261 % controlling length of user macro arguments, which has been 

   262 % available since December 1994. 

   263 %% 

   264 

   265 \NeedsTeXFormat{LaTeX2e}[1994/12/01] 

   266 %%                                                                [1994/11/04] 

   267 \ProvidesPackage{lineno} 

   268   [\filedate\space line numbers on paragraphs \fileversion] 

   269 % (/New v4.00) 

   270 %% 

   271 %% History of versions: 

   272 %% v1.00 1995/03/31  SIB: first release for Petra's interview transcriptions

   273 %% v1.01 1995/10/28  SIB: added ~pagewise~ mode

   274 %% v1.02 1995/11/15  SIB: added ~modulo~ option  

   275 %% v1.03 1995/12/05  SIB: pagewise: try to reduce the hash-size requirements

   276 %% v2.00 1995/12/06  SIB:   .. it works, new user interface

   277 %% v2.01 1996/09/17  SIB: put into CVS

   278 %% v2.02 1997/03/17  SIB: add: \@reinserts, for footnotes

   279 %% v2.04 1998/03/09  SIB: add: linenomath environment

   280 %% v2.05 1998/04/26  SIB: add: prevgraf test

   281 %% v2.06 1999/03/02  SIB: LPPL added

   282 %% v3.00 1999/06/11  SiB: include the extension in the main file

   283 %% v3.01 1999/08/28  SiB: \@reinserts -> \holdinginserts

   284 %% v3.02 2000/03/10  SiB: \@LN@output

   285 %% v3.03 2000/07/01  SiB: \@LN@ExtraLabelItems, hyperref

   286 %% v3.04 2000/12/17  SiB: longtable compatibility.

   287 %% v3.05 2001/01/02  SiB: [fleqn] detection. 

   288 %% v3.05a 2001/01/04 SiB: [fleqn] detection reverted for eqnarray. 

   289 %% v3.06 2001/01/17  SiB: [twocolumn] mode support.

   290 %% v3.07 2001/07/30  SiB: [hyperref] option obsoleted.

   291 %% v3.08 2001/08/02  SiB: linenomath wrapping for \[ \]

   292 %% v3.08a 2001/08/04 SiB: linenomath wrapping for \[ \] fixed

   293 %% v3.08b 2002/01/27 SiB: enquotation typo fix

   294 %% v3.09 2003/01/14  SIB: hyperref detection fix

   295 %% v3.10 2003/04/15  FMi: \MakeLineNo fix for deep boxes

   296 %% v3.10a 2003/11/12  Uwe Lück: \lineref typo fix

   297 %% v4.00 2004/09/02  UL:  included linenox0, linenox1, lnopatch code with 

   298 %%                        documentation, usually indicated by `New v4.00'; 

   299 %%                        discussions of old code, indicated by `UL'; 

   300 %%                        LPPL v.1 ->  LPPL v1.3, `program' -> `file'; 

   301 %%                        first lines with \filedate and \fileversion, 

   302 %%                        according nawk lines; `November 1994 or later', 

   303 %%                        some earlier documentation typos (including a few 

   304 %%                        bad minus signs), { -> {% and } -> \unskip} at 

   305 %%                        line ends (so, e.g., alignment in TOC works); \scs. 

   306 %%       2004/09/03  UL:  removed everything which indicated that the 

   307 %%                        present file were named `lineno4.sty'. 

   308 %% v4.1  2004/09/19  UL:  Inserted Stephan's identification line, removed 

   309 %%                        some TODOs and remarks from v4.00. 

   310 %%       2004/10/04  UL:  Added acknowledgement for Daniel Doherty; 

   311 %%                        `(New v4.00)' with [|\firstlinenumber]; changed 

   312 %%                        TODOs; Refining -> Redefining (\vadjust). 

   313 %%       2004/10/05  UL:  ednmath0 -> mathrefs; \catcode`\~ -> \active;

   314 %%                        \path; refined section on options `mathrefs'; 

   315 %%                        changes in introduction. 

   316 %%       2004/10/06  UL:  Changed/removed TODOs, e.g., for edtable.sty. 

   317 %%       2004/10/11  UL:  Reminders: linenox0/1/lnopatch.sty obsolete; 

   318 %%                        \tt star in list of commands.

   319 %%       2004/10/12  UL:  Corrected blank lines in lineno.tex. 

   320 %%       2004/10/19  UL:  Fixed minor typos; remark on \if@LN@edtable. 

   321 %% v4.1a 2004/11/07  UL:  LPPL v1.3a. 

   322 %% v4.1b 2004/11/13  UL:  Comment on \outputpenalty values. 

   323 %% v4.1c 2005/01/10  UL:  Contact via http. 

   324 %% v4.11 2005/02/20  UL:  Error message with \linelabel when not numbering. 

   325 %%       2005/03/07  UL:  Removed \linelabel from ss:Tab heading, consider 

   326 %%                        marginal line numbers as well, revised ss:Tab. 

   327 %%                        Added a few lines on missing explanations to 

   328 %%                        s:UserCmds. Corrected some code alignments. 

   329 %%       2005/03/08  UL:  Require recent edtable.sty. 

   330 %%

   331 

   332 %% v4.2  2005/03/21  UL:  "Physical page" counter works with \include. 

   333 %%       2005/04/17  UL:  Raised options section above extensions section 

   334 %%                        (v4.00 disabled `displaymath' option); 

   335 %%                        third arg for \@ifundefined{mathindent}; 

   336 %%                        "bunch of options"; 

   337 %%       2005/04/24  UL:  compatibility with tamefloats; vplref.sty. 

   338 %%       2005/04/25  UL:  \number -> \the; wondered -> $$; subsec. appbas; 

   339 %%                        CrtlLN sec -> subsec.; \newcommand* wherever ...; 

   340 %%                        doc. on `other output routines' and `addpageno' 

   341 %%                        (this changed from `varioref'). 

   342 %%       2005/04/27  UL:  =1\relax -> =\@ne, 0\relax ..., \hb@xt@, 

   343 %%                        \ifx\@@par\@@@par -> \ifLineNumbers, typos, 

   344 %%                        \pagestyle{headings}, LaTeX -> \LaTeX. 

   345 %% v4.21 2005/04/28  UL:  linenomath section: removed wrong \else's, 

   346 %%                        \holding...: \thr@@, \@LN@outer@holdins, \global. 

   347 %% v4.22 2005/05/01  UL:  \unvbox\@outputbox; \@LN@col without #1, 

   348 %%       2005/05/08  UL:  global/local \internall..., \resetl... global, 

   349 %%                        shortened discussions of this and of \newcounter. 

   350 %%       2005/05/09  UL:  corr.: doc. typo, version history, bad lines; 

   351 %%                        percent; \chardef for modulo, 

   352 %%                        \value{firstlinenumber}. 

   353 %% v4.3  2005/05/10  UL:  \@backslashchar -> \char`\\ in \scs. 

   354 %%       2005/05/11  UL:  \linenumbers sets ...outer@holdins; tidied up 

   355 %%                        documentation regarding earlier versions. 

   356 %%       2005/05/12  UL:  `linenomath' without spurious number above; 

   357 %%                        `displaymath' default; edmac homepage -> 

   358 %%                        ednotes.sty.de.vu, \endlinenomath without 

   359 %%                        numbers: no change of \holdinginserts; 

   360 %%                        \linelabel doesn't go to .aux or mark, 

   361 %%                        hyperref detected; undone 2005/05/10 (bad mark). 

   362 %%       2005/05/13  UL:  Reworked hyperref detection (new subsec.). 

   363 %%       2005/05/15  UL:  More typo fixes, corrected terrible confusions in 

   364 %%                        the discussion (v4.22/v4.3) of \new/\stepcounter; 

   365 %%                        new subsec. in `Line number ...'; another 

   366 %%                        implementation of `hyperref' detection. 

   367 %%       2005/05/16  UL:  Final minor changes. 

   368 %% v4.31b    /06/14  UL:  Extended explanation of \firstlinenumbers 

   369 %%                        and package options; \@LN@ifgreat@critical; 

   370 %%                        \modulolinenumbers*. Sent to Ednotes.news only.

   371 %% v4.31 2005/06/15  UL:  \modulolinenumbers* with \firstlinenumber{1}; 

   372 %%                        " -> ``/''; more doc. on \firstlinenumber .

   373 %%       2005/06/20  UL:  Typo fix. 

   374 %%       2005/10/01  UL:  Warning about \mod...* with pagewise mode. 

   375 %% v4.31a    /10/02  UL:  Minor changes of appearance of doc., e.g., 

   376 %%                        \[ for $$. 

   377 %% v4.32b    /10/15  UL:  Support for \addvspace; removed comments that

   378 %%                        had been invisible already for some time; 

   379 %%                        made clear with which environments the 

   380 %%                        linenomath environment is not needed. 

   381 %% v4.32ab   /10/15  UL:  Observe \if@nobreak with support for \addvspace. 

   382 %% v4.32 2005/10/17  UL:  Just made it official and sent it to CTAN. 

   383 %% v4.33b    /10/23  UL:  \if@nobreak\nobreak\fi -> \nobreak . 

   384 %% v4.33ab   /10/24  UL:  \LineNoLaTeXOutput without \@tempswafalse; 

   385 %%                        undid v4.22: \[unv]box\@outputbox (space is OK, 

   386 %%                        \unvbox pushes short columns down); \@LN@kern@z@ . 

   387 %% v4.4b 2005/10/24  UL:  Another tidying-up of the discussion of 

   388 %%                        \stepcounter{linenumber}; \@LN@screenoff@pen 

   389 %%                        replaces \@LN@kern@z@, \@LN@depthbox . 

   390 %% v4.4  2005/10/27  UL:  Just made official for CTAN. 

   391 %% v4.4a 2005/10/29  UL:  Undid change of discussion of 

   392 %%                        \stepcounter{linenumber} (confusion again). 

   393 %% v4.41 2005/11/02  UL:  Raised \CheckCommand*. 

   394 %% 

   395 %% Acknowledgements:

   396 %% v3.06:  Donald Arseneau, pointed to mparhack.sty.

   397 %% v3.07+: Frank Mittelbach, points out inconsistencies in the

   398 %%         user interface.

   399 %% v3.10:  Frank Mittelbach \MakeLineNo fix for deep boxes

   400 %% v4.00:  Daniel Doherty points out clash of \pagewise... with resetting 

   401 %%         page number. 

   402 %% v4.21:  Much testing work by Erik Luijten. 

   403 %% v4.3:   `displaymath' default by Erik Luijten's suggestion. 

   404 %% v4.31:  \modulolinenumbers* is an idea of Hillel Chayim Yisraeli's. 

   405 %% v4.32:  Support for \addvspace due to Saravanan M.'s observation. 

   406 %% v4.33:  Different support for \addvspace due to bug reports by 

   407 %%         Saravanan M.'s and David Josef Dev. 

   408 %% v4.4:   David Josef Dev points out that \kern\z@ after a paragraph 

   409 %%         tends to place its final baseline wrongly. 

   410 %

   411 %

   412 %                                                                   \section{%

   413 %               Put the line numbers to the lines

   414 %                                                                     \unskip}

   415 % 

   416 % (New v4.00)                    This section contained the most 

   417 % basic package code previously. For various purposes of 

   418 % version_4\dots, much of these basics have been to be modified. 

   419 % Much of my (UL's) reasoning on these modifications has been to 

   420 % be reported. Sorry, the present section has been blown up 

   421 % awfully thus and contains ramifications that may be difficult 

   422 % to trace. We add some ~\subsection~ commands in order to cope 

   423 % with the new situation. (/New v4.00) 

   424 % 

   425 %                                                                \subsection{% 

   426 %               Basic code of \texttt{lineno.sty} \scs{output}

   427 %                                                    \unskip}\label{ss:output} 

   428 % 

   429 % The line numbers have to be attached by the output

   430 % routine.  We simply set the ~\interlinepenalty~ to $-100000$.

   431 % The output routine will be called after each line in the

   432 % paragraph,  except the last,  where we trigger by ~\par~.

   433 % The ~\linenopenalty~ is small enough to compensate a bunch of

   434 % penalties (e.g., with ~\samepage~).

   435 %

   436 % (New v3.04)            Longtable uses 

   437 % ~\penalty~$-30000$.  The lineno penalty range was 

   438 % shrunk to $-188000 \dots -32000$.  (/New v3.04)

   439 % (New v4.00) New values are listed below (11111f.). (/New v4.00) 

   440 

   441 \newcount\linenopenalty\linenopenalty=-100000

   442 

   443 %% TODO v4.4+: 

   444 % (UL)                              Hm. It is never needed below 

   445 % that this is a counter. ~\def\linenopenalty{-100000\relax}~ 

   446 % would do. (I guess this consumes more memory, but it 

   447 % is more important to save counters than to save memory.) 

   448 % I was frightened by ~-\linenopenalty~ below, but indeed 

   449 % \TeX\ interprets the string ~--100000~ as 100000. 

   450 % Has any user or extension package writer ever called 

   451 % ~\linenopenalty=xxx~, or could I really change this?---The 

   452 % counter is somewhat faster than the macro. Together with the 

   453 % compatibility question this seems to support keeping the 

   454 % counter. (???) 

   455 %% Note that Stephan chose ~\mathchardef~ below, 

   456 %% so his choice above seems to have been deliberate. 

   457 %% <- no point, \mathchardef token is fast. 

   458 % (/UL) 

   459 

   460 \mathchardef\linenopenaltypar=32000

   461 

   462 % So let's make a hook to ~\output~,  the direct way. The \LaTeX\ 

   463 % macro ~\@reinserts~ puts the footnotes back on the page.

   464 %

   465 % (New v3.01)                ~\@reinserts~ badly

   466 % screws up split footnotes.  The bottom part is

   467 % still on the recent contributions list, and the

   468 % top part will be put back there after the bottom

   469 % part. Thus, since lineno.sty does not play well

   470 % with ~\inserts~ anyway, we can safely experiment

   471 % with ~\holdinginserts~, without making things

   472 % much worse.    

   473 %

   474 % Or that's what I thought, but:  Just activating

   475 % ~\holdinginserts~ while doing the ~\par~ will

   476 % not do the trick:  The ~\output~ routine may be

   477 % called for a real page break before all line

   478 % numbers are done, and how can we get control

   479 % over ~\holdinginserts~ at that point?

   480 %

   481 % Let's try this:  When the ~\output~ routine is

   482 % run with ~\holdinginserts=3~ for a real page

   483 % break, then we reset ~\holdinginserts~ and

   484 % restart ~\output~.

   485 %

   486 % Then, again, how do we keep the remaining

   487 % ~\inserts~ while doing further line numbers? 

   488 %

   489 % If we find ~\holdinginserts~=$-3$ we activate it again 

   490 % after doing ~\output~.             (/New v3.01)

   491 %

   492 % (New v3.02)                    To work with

   493 % multicol.sty, the original output routine is now

   494 % called indirectly, instead of being replaced.

   495 % When multicol.sty changes ~\output~, it is a

   496 % toks register, not the real thing. (/New v3.02)

   497 % 

   498 % (New v4.00)               Two further complications are added. 

   499 %%

   500 %% TODO v4.3+: Or three, ~\@nobreakfalse~ after ~\MakeLineNo~ 

   501 %% for getting rid of ~\@LN@nopagebreak~. 

   502 %                                                         \begin{itemize}\item

   503 % [(i)]  Problems with footnotes formerly resulted from 

   504 % \LaTeX's ~\@reinserts~ in ~\@specialoutput~ which Stephan's 

   505 % ~\linelabel~ called via the ~\marginpar~ mechanism. 

   506 %                                                                        \item

   507 % [(ii)] \LaTeX\ commands using ~\vadjust~ formerly didn't work 

   508 % as one would have hoped. The problem is as follows: 

   509 % Printing the line number results from 

   510 % a box that the output routine inserts at the place of the 

   511 % ~\interlinepenalty~. ~\vadjust~ items appear \emph{above} the 

   512 % ~\interlinepenalty~ (\TeX book p._105). So ~\pagebreak~, e.g., 

   513 % formerly sent the line number to the next page, while the 

   514 % penalty from ~\nopagebreak~ could not tie the following line, 

   515 % since it was screened off by the line number box.---Our trick 

   516 % is putting the ~\vadjust~ items into a list macro from which 

   517 % the output routine transfers them into the vertical list, 

   518 % below the line number box. 

   519 %                                                                \end{itemize}

   520 % In this case_(ii), like in case_(i), footnotes would suffer 

   521 % if ~\holdinginserts~ were non-positive. Indeed, in both 

   522 % cases_(i) and_(ii) we tackle the footnote problem by extending 

   523 % that part of Stephan's output routine that is active when 

   524 % ~\holdinginserts~ is positive. This extension writes the line 

   525 % number ~\newlabel~ to the .aux file (which was formerly done 

   526 % under $~\holdinginserts~=-3$) and handles the ~\vadjust~ 

   527 % items.---To trigger ~\output~ and its ~\linelabel~ or, resp., 

   528 % ~\vadjust~ part, the list of signal penalties started 

   529 % immediately before is increased here (first for ~\linelabel~, 

   530 % second for postponed ~\vadjust~ items): 

   531 

   532 \mathchardef\@Mllbcodepen=11111 

   533 \mathchardef\@Mppvacodepen=11112 

   534 

   535 % (/New v4.00) (New v4.2) David Kastrup urges to use a private 

   536 % name instead of ~\the\output~ (LaTeX-L-list). Otherwise an 

   537 % ~\output~ routine loaded later and using ~\newtoks\output~ 

   538 % again may get lost entirely. So we change use of ~\@LN@output~, 

   539 % using it for the former purpose. Reference to what appeared 

   540 % with the name of ~\output~ here lasts for a few lines and then 

   541 % is given away. 

   542 

   543 \let\@tempa\output

   544 \newtoks\output

   545 \let\@LN@output\output

   546 \output=\expandafter{\the\@tempa}

   547 

   548 % Now we add two cases to Stephan's output routine. (New v4.00)

   549 

   550 \@tempa={%

   551 % (/New 4.2)

   552             \LineNoTest

   553             \if@tempswa

   554 %% 

   555 %% (UL) Learnt that even in def.s blank line means ~\par~. 

   556 %% to leave visual space in present file with having a

   557 %% blank line neither in present nor in .tex file, 

   558 %% use double comment mark (`%%'). (/UL) 

   559 %% 

   560 % (New v4.00)

   561 % We insert recognition of waiting ~\linelabel~ items--- 

   562 %% 

   563               \ifnum\outputpenalty=-\@Mllbcodepen 

   564                 \WriteLineNo 

   565 %%

   566 % ---and of waiting ~\vadjust~ items: 

   567 %% 

   568               \else 

   569                 \ifnum\outputpenalty=-\@Mppvacodepen 

   570                   \PassVadjustList 

   571                 \else 

   572 %% 

   573 %% Now we give control back to Stephan. 

   574 % (/New v4.00) (New v4.2) Outsource ``Standard'' output 

   575 % ---which occurs so rarely---to subsection_\ref{ss:LLO}: 

   576 %% 

   577                   \LineNoLaTeXOutput 

   578 % (/New v4.2) (New v4.00) 

   579 % Two new ~\fi~s for the ~\linelabel~ and ~\vadjust~ tests--- 

   580 %% 

   581                 \fi 

   582               \fi 

   583 %%

   584 % ---and the remaining is 

   585 %%%next three lines are 

   586 % Stephan's code again: 

   587 % (/New v4.00) 

   588 %%

   589             \else  

   590               \MakeLineNo

   591             \fi

   592             }

   593  

   594 % (New v4.00)                                  Our new macros 

   595 % ~\WriteLineNo~ and ~\PassVadjustList~ will be dealt with in 

   596 % sections_\ref{s:LNref} and_\ref{ss:PVadj}. (/New v4.00) 

   597 % 

   598 %                                                                \subsection{%

   599 %               \scs{LineNoTest}

   600 %                                                                     \unskip} 

   601 % 

   602 % The float mechanism inserts ~\interlinepenalty~s during

   603 % ~\output~.  So carefully reset it before going on.  Else

   604 % we get doubled line numbers on every float placed in

   605 % horizontal mode, e.g, from ~\linelabel~.  

   606 %

   607 % Sorry, neither a ~\linelabel~ nor a ~\marginpar~ should

   608 % insert a penalty, else the following linenumber

   609 % could go to the next page. Nor should any other

   610 % float.  So let us suppress the ~\interlinepenalty~ 

   611 % altogether with the ~\@nobreak~ switch.

   612 %

   613 % Since (ltspace.dtx, v1.2p)[1996/07/26], the ~\@nobreaktrue~ does

   614 % it's job globally.  We need to do it locally here.

   615 

   616 \def\LineNoTest{%

   617   \let\@@par\@@@par

   618   \ifnum\interlinepenalty<-\linenopenaltypar

   619      \advance\interlinepenalty-\linenopenalty

   620      \@LN@nobreaktrue

   621      \fi

   622   \@tempswatrue

   623   \ifnum\outputpenalty>-\linenopenaltypar\else

   624      \ifnum\outputpenalty>-188000\relax

   625        \@tempswafalse

   626        \fi

   627      \fi

   628   }

   629 

   630 \def\@LN@nobreaktrue{\let\if@nobreak\iftrue} % renamed v4.33

   631 

   632 % (UL)                                      I thought here were 

   633 % another case of the save stack problem explained in \TeX book, 

   634 % p._301, namely through both local and global changing 

   635 % ~\if@nobreak~. However, ~\@LN@nobreak~ is called during 

   636 % ~\@LN@output~ only, while ~\@nobreaktrue~ is called by \LaTeX's 

   637 % ~\@startsection~ only. The latter never happens during 

   638 % ~\@LN@output~. So there is no local value of ~\if@nobreak~ on 

   639 % save stack when ~\@nobreaktrue~ acts, since ~\the\@LN@output~ 

   640 % (where ~\@LN@output~ is a new name for the original ~\output~) 

   641 % is executed within a group (\TeX book p._21).

   642 %%

   643 %%           2004/09/19 Removed nonsense here according to Stephan 2004/09/04.

   644 %% 

   645 % (/UL) 

   646 %

   647 %                                                                \subsection{%

   648 %               Other output routines (v4.2)

   649 %                                                       \unskip}\label{ss:LLO} 

   650 % 

   651 % I had thought of dealing with bad interference of footnotes 

   652 % (and ~\enlargethispage~) with (real) ~\marginpar~s and floats 

   653 % \emph{here}. Yet this is done in 

   654 %                                                                           \[

   655 %     ~http://~\mbox{[CTAN]}

   656 %           ~/macros/latex/contrib/tamefloats/tameflts.sty~

   657 %                                                                           \]

   658 % now, and I prefer striving for compatibility with the latter. 

   659 % (See there for expanding on the problem.)

   660 % This requires returning the special absolute value of 

   661 % ~\holdinginserts~ that ~lineno.sty~ finds at the end of a newly 

   662 % typeset paragraph---now done in subsection_\ref{ss:calls}

   663 % (~\linenumberpar~). 

   664 % The former ~\LineNoHoldInsertsTest~ has been filled into here. 

   665 %% ---`3' is replaced by ~\thr@@~ for a while. ~\thr@@~ is 

   666 %% useful practice since plain \TeX, but Stephan may have been 

   667 %% wise in suspecting that \LaTeX\ once could forsake ~\thr@@~. 

   668 %% The same holds for ~\@M=10000~. 

   669 % Note: when the following code is invoked, we have 

   670 % ~\if@tempswa~_ =_~\iftrue~. 

   671 % WARNING: I am still not sure whether the present code is good 

   672 % for cooperating with other packages that use ~\holdinginserts~. 

   673 

   674 \def\LineNoLaTeXOutput{% 

   675   \ifnum \holdinginserts=\thr@@   % v4.33 without \@tempswafalse

   676     \global\holdinginserts-\thr@@ 

   677     \unvbox\@cclv 

   678     \ifnum \outputpenalty=\@M \else \penalty\outputpenalty \fi 

   679   \else

   680     \if@twocolumn \let\@makecol\@LN@makecol \fi

   681     \the\@LN@output % finally following David Kastrup's advice. 

   682     \ifnum \holdinginserts=-\thr@@ 

   683       \global\holdinginserts\thr@@ \fi 

   684   \fi

   685 }

   686 

   687 % \textit{More on dealing with output routines from other 

   688 %         packages:} 

   689 % Since ~lineno.sty~'s output routine is called at least once 

   690 % for each output line, I think it should be in \TeX's 

   691 % original ~\output~, while output routines dealing with 

   692 % building pages and with floats etc.\ should be filled into 

   693 % registers addressed by ~\output~ after ~\newtoks\output~. 

   694 % Therefore                                                  \begin{enumerate}

   695 %                                                                        \item 

   696 %   ~tameflts.sty~ should be loaded \emph{after} ~lineno.sty~; 

   697 %                                                                        \item 

   698 %   if a class changes ~\output~ (APS journal class revtex4, 

   699 %   e.g.), ~lineno.sty~ should be loaded by ~\RequirePackage~ 

   700 %   [here presumably following some options in 

   701 %   brackets]~{lineno}~ \emph{preceding} ~\documentclass~. 

   702 %                                                                        \item 

   703 %   If you actually maintain such a class, please consider 

   704 %   loading ~lineno.sty~ on some draft option. The bunch of 

   705 %   lineno's package options may be a problem, but perhaps the 

   706 %   purpose of your class is offering only very few of lineno's 

   707 %   options anyway, maybe just one. 

   708 %                                                              \end{enumerate} 

   709 % The latter may also be needed with classes that don't follow 

   710 % David Kastrup's rule on changing ~\output~. 

   711 % 

   712 %                                                                \subsection{%

   713 %               \scs{MakeLineNo}: Actually attach line number 

   714 %                                                       \unskip}\label{ss:MLN} 

   715 % 

   716 % We have to return all the page to the current page, and

   717 % add a box with the line number, without adding

   718 % breakpoints, glue or space.  The depth of our line number

   719 % should be equal to the previous depth of the page, in

   720 % case the page breaks here,  and the box has to be moved up

   721 % by that depth.  

   722 %

   723 % The ~\interlinepenalty~ comes after the ~\vadjust~ from a

   724 % ~\linelabel~,  so we increment the line number \emph{after}

   725 % printing it. The macro ~\makeLineNumber~ produces the

   726 % text of the line number, see section \ref{appearance}.

   727 % 

   728 % (UL)                        I needed a while to understand 

   729 % the sentence on incrementing. Correctly: writing the 

   730 % ~\newlabel~ to the .aux file is triggered by the signal 

   731 % penalty that ~\end@float~ inserts via ~\vadjust~. 

   732 % However, this could be changed by our new ~\PostponeVadjust~. 

   733 % After ~\c@linenumber~ has been introduced as a \LaTeX\ 

   734 % counter, it might be preferable that it behaved like standard 

   735 % \LaTeX\ counters which are incremented shortly before printing. 

   736 % But this may be of little practical relevance in this case, 

   737 % as ~\c@linenumber~ is driven in a very non-standard 

   738 % way.---However still, this behaviour of ~\c@linenumber~ 

   739 % generates a problem with our ~edtable.sty~. 

   740 %% \unskip---Before, 

   741 %% I thought that Stephan had reported his reasoning incorrectly 

   742 %% and rather did this because of his ~\resetlinenumber~ which 

   743 %% initializes ~\c@linenumber~ to 1 instead of 0---the latter is 

   744 %% usual with \LaTeX\ counters. Cf._additional comment at 

   745 %% ~\resetlinenumber~. 

   746 % (/UL). 

   747 %

   748 % Finally we put in the natural ~\interlinepenalty~, except

   749 % after the last line. 

   750 %

   751 % (New v3.10) Frank Mittelbach points out that box255 may be 

   752 % less deep than the last box inside, so he proposes to 

   753 % measure the page depth with ~\boxmaxdepth=\maxdimen~.

   754 % (/New v3.10)

   755 % 

   756 % (UL, New v4.00)               We also resume the matter of 

   757 % ~\vadjust~ items that was started in section_\ref{ss:output}. 

   758 % 

   759 % \TeX\ puts only nonzero interline 

   760 % penalties into the vertical list (\TeX book p._105), while 

   761 % ~lineno.sty~ formerly replaced the signal interline penalty by 

   762 % something closing with an explicit penalty of the value that 

   763 % the interline penalty would have without ~lineno.sty~. 

   764 % This is usually 0. Now, explicit vertical penalties can be 

   765 % very nasty with respect to ~\nopagebreak~, e.g., a low (even 

   766 % positive) ~\widowpenalty~ may force a widow where you 

   767 % explicitly tried to forbid it by ~\nopagebreak~ 

   768 % (see explanation soon below). 

   769 % The ~\nopagebreak~ we create here would never work if all 

   770 % those zero penalties were present.---On 

   771 % the other hand, we cannot just omit Stephan's zero penalties, 

   772 % because \TeX\ puts a penalty of 10000 after what ~lineno.sty~ 

   773 % inserts (\TeX book p._125). This penalty must be overridden 

   774 % to allow page breaks between ordinary lines. To revive 

   775 % ~\nopagebreak~, we therefore replace those zero (or low) 

   776 % penalties by penalties that the user demanded by 

   777 % ~\nopagebreak~.---This mechanism is not perfect and does not 

   778 % exactly restore the original \LaTeX\ working of ~\pagebreak~ 

   779 % and ~\nopagebreak~. Viz., if there are several vertical 

   780 % penalties after a line which were produced by closely sitting 

   781 % ~\[no]pagebreak~s, without ~lineno.sty~ the lowest penalty would 

   782 % be effective (cf._\TeX book exercise_14.10). Our mechanism, by 

   783 % contrast, chooses the \emph{last} user-set penalty of the line 

   784 % as the effective one. It would not be very difficult to come 

   785 % more close to the original mechanism, but until someone urges 

   786 % us we will cling to the present simple way. You may consider an 

   787 % advantage of the difference between our mechanism and the 

   788 % original one that the user here can actually override low 

   789 % penalties by ~\nopagebreak~, which may be what a lay \LaTeX\ 

   790 % user would expect. 

   791 %% ---Zero glue would do instead of zero 

   792 %% penalty! This could make things easier. Maybe next time. 

   793 %% <- v4.4: No, problem with column depth. 

   794 % (/UL, /New v4.00) 

   795 

   796 \def\MakeLineNo{%

   797    \@LN@maybe@normalLineNumber                        % v4.31 

   798    \boxmaxdepth\maxdimen\setbox\z@\vbox{\unvbox\@cclv}%

   799    \@tempdima\dp\z@ \unvbox\z@

   800    \sbox\@tempboxa{\hb@xt@\z@{\makeLineNumber}}%

   801 %% 

   802 % (New v4.00) Previously, 

   803 %                                                  \begin{old}\begin{verbatim}

   804 % %    \stepcounter{linenumber}%

   805 % \end{verbatim}

   806 %                                                                    \end{old}

   807 %%                                         %% TODO: Still first `\begin{old}'?

   808 % followed. (Of course, there was no 

   809 % comment mark; I put it there to make 

   810 % reading the actual code easy.) 

   811 % 

   812 % (New v4.22: improved) Why not just 

   813 %   \[~\global\advance\c@linenumber\@ne~?\]

   814 % ~\stepcounter~ additionally resets ``subordinate'' 

   815 % counters, but which could these (usefully) be? 

   816 % Again, may be column counters with ~edtable.sty~!? 

   817 % 

   818 % But then, our ~edtable.sty~ and its ~longtable~ option 

   819 % should use it as well. So use a shorthand supporting 

   820 % uniformity. You can even use it as a hook for choosing 

   821 % ~\global\advance\c@linenumber\@ne~ instead of our choice. 

   822 % (/New v4.22) 

   823 %% 

   824    \stepLineNumber

   825 %% 

   826 %  (New v4.4)   Now 

   827 %% 

   828    \ht\@tempboxa\z@ \@LN@depthbox 

   829 %% 

   830 % appends the box containing the line number without changing 

   831 % ~\prevdepth~---see end of section. 

   832 % Now is the time for inserting the $\dots$ (/New v4.4) 

   833 %% The line number has now been placed (it may be invisible 

   834 %% depending on the modulo feature), so 

   835 %% we can insert the 

   836 % ~\vadjust~ items. We cannot do this much later, because 

   837 % their right place is above the artificial interline 

   838 % penalty which Stephan's code will soon insert 

   839 % (cf._\TeX book p._105). The next command is just ~\relax~ 

   840 % if no ~\vadjust~ items have been accumulated for the 

   841 % current line. Otherwise it is a list macro inserting 

   842 % the ~\vadjust~ items and finally resetting itself. 

   843 % (This is made in section_\ref{ss:PVadj} below.)

   844 % If the final item is a penalty, it is stored so it can 

   845 % compete with other things about page breaking. 

   846 %% 

   847    \@LN@do@vadjusts 

   848    \count@\lastpenalty 

   849 %% 

   850 % At this place, 

   851 %                                                  \begin{old}\begin{verbatim}

   852 % %    \ifnum\outputpenalty=-\linenopenaltypar\else

   853 % \end{verbatim}

   854 %                                                                    \end{old}

   855 % originally followed. We need something \emph{before} the 

   856 % ~\else~: 

   857 %% 

   858    \ifnum\outputpenalty=-\linenopenaltypar 

   859      \ifnum\count@=\z@ \else 

   860 %% 

   861 % So final ~\pagebreak[0]~ or ~\nopagebreak[0]~ has no 

   862 % effect---but this will make a difference after headings only, 

   863 % where nobody should place such a thing anyway. 

   864 %% 

   865        \xdef\@LN@parpgbrk{% 

   866          \penalty\the\count@

   867          \global\let\noexpand\@LN@parpgbrk

   868                       \noexpand\@LN@screenoff@pen}% v4.4 

   869 %% 

   870 % That penalty will replace former ~\kern\z@~ in 

   871 % ~\linenumberpar~, see subsection_\ref{ss:calls}.---A

   872 % few days earlier, I tried to send just a penalty value. 

   873 % However, the ~\kern\z@~ in ~\linenumberpar~ is crucial, 

   874 % as I then found out. See below.---The final penalty is 

   875 % repeated, but this does no harm. (It would not be very 

   876 % difficult to avoid the repeating, but it may even be 

   877 % less efficient.) It may be repeated due to the previous 

   878 % ~\xdef~, but it may be repeated as well below in the 

   879 % present macro where artificial interline penalty is to 

   880 % be overridden.

   881 %% 

   882      \fi

   883    \else

   884 %% 

   885 % (/New v4.00) 

   886 %%                                        Corrected code alignment with v4.11. 

   887      \@tempcnta\outputpenalty

   888      \advance\@tempcnta -\linenopenalty

   889 %% 

   890 % (New v4.00) 

   891 %                                                  \begin{old}\begin{verbatim}

   892 % %        \penalty\@tempcnta

   893 % \end{verbatim}

   894 %                                                                    \end{old}

   895 % followed previously. To give ~\nopagebreak~ a chance, 

   896 % we do 

   897 %%                                        Corrected code alignment with v4.11. 

   898      \penalty \ifnum\count@<\@tempcnta \@tempcnta \else \count@ \fi 

   899 %% 

   900 % instead.---In ~linenox0.sty~, the ~\else~ thing once was omitted. 

   901 % Sergei Mariev's complaint (thanks!) showed that it is vital 

   902 % (see comment before ~\MakeLineNo~). 

   903 % The remaining ~\fi~ from previous package version closes the 

   904 % ~\ifnum\outputpenalty~\dots 

   905 % (/New v4.00) 

   906 %% 

   907    \fi

   908    }

   909 

   910 % (New v4.00) 

   911 

   912 \newcommand\stepLineNumber{\stepcounter{linenumber}} 

   913 

   914 % For reason, see use above. (/New v4.00) 

   915 %%                                   %% TODO v4.4+: ~\newcommand~ more often!? 

   916 % 

   917 % (New v4.4)   The depth preserving trick is drawn here from 

   918 % ~\MakeLineNo~ because it will be used again in 

   919 % section_\ref{ss:calls}.

   920 

   921 \def\@LN@depthbox{% 

   922   \dp\@tempboxa=\@tempdima

   923   \nointerlineskip \kern-\@tempdima \box\@tempboxa} 

   924 

   925 % (/New v4.4) 

   926 % 

   927 %                                                                   \section{%

   928 %               Control line numbering 

   929 %                                                                     \unskip}

   930 %                                                                \subsection{%

   931 %                  Inserting \scs{output} calls           %% own subsec. v4.4. 

   932 %                                                     \unskip}\label{ss:calls}

   933 % The line numbering is controlled via ~\par~.  \LaTeX\

   934 % saved the \TeX-primitive ~\par~ in ~\@@par~.  We push it

   935 % one level further out, and redefine ~\@@par~ to insert

   936 % the ~\interlinepenalty~ needed to trigger the

   937 % line numbering. And we need to allow pagebreaks after a

   938 % paragraph. 

   939 % 

   940 % New (2.05beta): the prevgraf test.  A paragraph that ends with a

   941 % displayed equation, a ~\noindent\par~ or ~wrapfig.sty~ produce empty

   942 % paragraphs. These should not get a spurious line number via

   943 % ~\linenopenaltypar~. 

   944 

   945 \let\@@@par\@@par

   946 \newcount\linenoprevgraf

   947 

   948 % (UL)                          And needs ~\linenoprevgraf~ 

   949 % to be a counter? Perhaps there may be a paragraph having 

   950 % thousands of lines, so ~\mathchardef~ doesn't suffice (really??). 

   951 %%

   952 %%                      %% TODO: limitations of lines per paragraph elsewhere? 

   953 %%                      %% Signal penalties, e.g.!? ~\deadcycles~!? 

   954 %%

   955 % A macro ending on ~\relax~ might suffice, but would be 

   956 % somewhat slow. I think I will use ~\mathchardef~ next time. 

   957 % Or has any user used ~\linenoprevgraf~? (/UL) 

   958 

   959 %% v4.33: changed code alignment for better understanding. 

   960 \def\linenumberpar{% 

   961   \ifvmode \@@@par \else 

   962     \ifinner \@@@par \else

   963       \xdef\@LN@outer@holdins{\the\holdinginserts}% v4.2 

   964       \advance \interlinepenalty \linenopenalty

   965       \linenoprevgraf \prevgraf

   966       \global \holdinginserts \thr@@ 

   967       \@@@par

   968       \ifnum\prevgraf>\linenoprevgraf

   969         \penalty-\linenopenaltypar

   970       \fi

   971 %% 

   972 % (New v4.00) 

   973 %                                                  \begin{old}\begin{verbatim}

   974 % %          \kern\z@ 

   975 % \end{verbatim}

   976 %                                                                    \end{old}

   977 % was here previously. What for? 

   978 % According to \TeX book p._125, Stephan's 

   979 % interline penalty is changed into 10000. At the end of a 

   980 % paragraph, the ~\parskip~ would follow that penalty of 10000, 

   981 % so there could be a page break neither at the 

   982 % ~\parskip~ nor at the ~\baselineskip~ (\TeX book p._110)---so 

   983 % there could never be a page break between two paragraphs. 

   984 % So something must screen off the 10000 penalty. 

   985 % Indeed, the ~\kern~ is a place to break. 

   986 % (Stephan once knew this: see `allow pagebreaks' above.)

   987 % 

   988 % Formerly, I tried to replace ~\kern\z@~ by 

   989 %                                                  \begin{old}\begin{verbatim}

   990 % %         \penalty\@LN@parpgpen\relax 

   991 % \end{verbatim}

   992 %                                                                    \end{old}

   993 % ---but this allows a page break after heading. So: 

   994 %% 

   995       \@LN@parpgbrk 

   996 %% 

   997 %% After heading, ~\kern\z@~ resulting from previous line 

   998 %% (see below) is followed by ~\write~ or ~\penalty10000~, 

   999 %% so causes no page break. 

  1000 % 

  1001 % These and similar changes were formerly done by ~linenox1.sty~. 

  1002 % (/New v4.00) 

  1003 % 

  1004 % (New v4.4) 

  1005 % A ~\belowdisplayskip~ may precede the previous when the paragraph 

  1006 % ends on a display-math; or there may be a ~\topsep~ from a list, etc. 

  1007 % ~\addvspace~ couldn't take account for it with ~\kern\z@~ 

  1008 % here. v4.32 therefore moved the space down -- with at least two 

  1009 % bad consequences. 

  1010 % Moreover, David Josef Dev observes that ~\kern\z@~ may 

  1011 % inappropriately yield column depth 0pt. 

  1012 % For these reasons, we introduce ~\@LN@screenoff@pen~ below. 

  1013 % (/New v4.4) 

  1014 %% 

  1015       \global\holdinginserts\@LN@outer@holdins % v4.2

  1016       \advance\interlinepenalty -\linenopenalty

  1017     \fi     % from \ifinner ... \else 

  1018   \fi}      % from \ifvmode ... \else 

  1019 

  1020 % (New v4.00, v4.4) Initialize ~\@LN@parpgbrk~, accounting 

  1021 % for earlier space and for appropriate columndepth. 

  1022 % We use former ~\MakeLineNo~'s depth-preverving trick 

  1023 % ~\@LN@depthbox~ again: 

  1024 

  1025 \def\@LN@screenoff@pen{% 

  1026   \ifdim\lastskip=\z@ 

  1027     \@tempdima\prevdepth \setbox\@tempboxa\null 

  1028     \@LN@depthbox                           \fi}

  1029 

  1030 \global\let\@LN@parpgbrk\@LN@screenoff@pen 

  1031 

  1032 % (/New v4.4, v4.00) 

  1033 %                                                                \subsection{%

  1034 %                  Turning on/off                         %% own subsec. v4.4.

  1035 %                                                     \unskip}\label{ss:OnOff}

  1036 % The basic commands to enable and disable line numbers.

  1037 % ~\@par~ and ~\par~ are only touched, when they are ~\let~ 

  1038 % to ~\@@@par~/~\linenumberpar~.  The line number may be

  1039 % reset to 1 with the star-form, or set by an optional

  1040 % argument ~[~<number>~]~. 

  1041 % 

  1042 % (New v4.00)        We add ~\ifLineNumbers~ etc.\ since 

  1043 % a number of our new adjustments need to know whether 

  1044 % linenumbering is active. This just provides a kind of 

  1045 % shorthand for ~\ifx\@@par\linenumberpar~; moreover it is 

  1046 % more stable: who knows what may happen to ~\@@par~?---A 

  1047 % caveat: ~\ifLineNumbers~ may be wrong. E.g., it may be 

  1048 % ~\iffalse~ where it acts, while a ~\linenumbers~ a few 

  1049 % lines below---in the same paragraph---brings about that 

  1050 % the line where the ~\ifLineNumbers~ appears gets a 

  1051 % marginal number. 

  1052 %%                                      Better implementation suggested below. 

  1053 %% 

  1054 % (New v4.3)        Just noticed: Such tricks have been 

  1055 % disallowed with v4.11, see subsections_\ref{ss:LL} 

  1056 % and_\ref{ss:OnOff}.---Moreover, the switching between

  1057 % meanings of ~\linelabel~ for a possible error message 

  1058 % as of v4.11 is removed. Speed is difficult to esteem 

  1059 % and also depends on applications. Just use the most 

  1060 % simple code you find.                      (/New v4.3) 

  1061 

  1062 \newif\ifLineNumbers \LineNumbersfalse 

  1063 

  1064 % (/New v4.00) 

  1065 

  1066 \def\linenumbers{% 

  1067      \LineNumberstrue                            % v4.00 

  1068      \xdef\@LN@outer@holdins{\the\holdinginserts}% v4.3 

  1069 %%

  1070 % (New v4.3) The previous line is for ~{linenomath}~ 

  1071 % in a first numbered paragraph.         (/New v4.3) 

  1072 %% 

  1073      \let\@@par\linenumberpar

  1074  %      \let\linelabel\@LN@linelabel % v4.11, removed v4.3 

  1075      \ifx\@par\@@@par\let\@par\linenumberpar\fi

  1076      \ifx\par\@@@par\let\par\linenumberpar\fi

  1077      \@LN@maybe@moduloresume         % v4.31 

  1078      \@ifnextchar[{\resetlinenumber}%]

  1079                  {\@ifstar{\resetlinenumber}{}}%

  1080      }

  1081 

  1082 \def\nolinenumbers{% 

  1083   \LineNumbersfalse                              % v4.00

  1084   \let\@@par\@@@par

  1085  %   \let\linelabel\@LN@LLerror      % v4.11, removed v4.3 

  1086   \ifx\@par\linenumberpar\let\@par\@@@par\fi

  1087   \ifx\par\linenumberpar\let\par\@@@par\fi

  1088   }

  1089 

  1090 % (New v4.00)               Moreover, it is useful to switch to 

  1091 % ~\nolinenumbers~ in ~\@arrayparboxrestore~. We postpone this 

  1092 % to section_\ref{ss:ReDef} where we'll have an appending macro 

  1093 % for doing this.                                  (/New v4.00) 

  1094 % 

  1095 % What happens with a display math?  Since ~\par~ is not executed,

  1096 % when breaking the lines before a display, they will not get

  1097 % line numbers.  Sorry, but I do not dare to change

  1098 % ~\interlinepenalty~ globally, nor do I want to redefine

  1099 % the display math environments here.

  1100 %   \begin{displaymath}

  1101 %                       display \ math

  1102 %   \end{displaymath}

  1103 % See the subsection below, for a wrapper environment to make

  1104 % it work.  But that requires to wrap each and every display

  1105 % in your \LaTeX\ source %%.

  1106 %% v4.3: 

  1107 % (see option ~displaymath~ in subsections_\ref{ss:v3opts} 

  1108 % and_\ref{ss:display} for some relief [UL]). 

  1109 %

  1110 % The next two commands are provided to turn on line

  1111 % numbering in a specific mode. Please note the difference:

  1112 % for pagewise numbering, ~\linenumbers~ comes first to

  1113 % inhibit it from seeing optional arguments, since

  1114 % re-/presetting the counter is useless. 

  1115 

  1116 \def\pagewiselinenumbers{\linenumbers\setpagewiselinenumbers}

  1117 \def\runninglinenumbers{\setrunninglinenumbers\linenumbers}

  1118 

  1119 % Finally, it is a \LaTeX\ style, so we provide for the use

  1120 % of environments, including the suppression of the

  1121 % following paragraph's indentation.

  1122 % 

  1123 %% TODO: v4.4+: 

  1124 % (UL)                                I am drawing the following 

  1125 % private thoughts of Stephan's to publicity so that others may 

  1126 % think about them---or to remind myself of them in an efficient 

  1127 % way.                                                     (/UL) 

  1128 %% UL changed `%%%' to `% %' below. 

  1129 %% TODO: add \par to \linenumbers, if called from an environment. %% v4.3 

  1130 %% ToDO: add an \@endpe hack if \linenumbers are turned on

  1131 %                                                  \begin{old}\begin{verbatim} 

  1132 % % TO DO: add \par to \linenumbers, if called from an environment.

  1133 % % To DO: add an \@endpe hack if \linenumbers are turned on

  1134 % %        in horizontal mode. {\par\parskip\z@\noindent} or

  1135 % %        something.