[latex3-commits] [latex2e-public] r1462 - some more documentation on the \newpage change and a typo fix

[noreply at latex-project.org]

Author: mittelba
Date: 2017-04-13 21:43:56 +0200 (Thu, 13 Apr 2017)
New Revision: 1462

Modified:
   trunk/base/ltoutput.dtx
Log:
some more documentation on the \newpage change and a typo fix

Modified: trunk/base/ltoutput.dtx
===================================================================
--- trunk/base/ltoutput.dtx	2017-04-13 12:50:26 UTC (rev 1461)
+++ trunk/base/ltoutput.dtx	2017-04-13 19:43:56 UTC (rev 1462)
@@ -962,7 +962,7 @@
 % \changes{v1.1z}{1996/10/24}{Better checks for noskipsec and
 %                 inlabel added, plus nobreak}
 % \changes{v1.2a}{1996/10/25}{Reset all flags explicitly}
-% \changes{v2.4a}{2017/04/11}{account for the depth of teh last row of the page}
+% \changes{v2.4a}{2017/04/11}{account for the depth of the last row of the page}
 %    The two checks at the beginning ensure that an item label or
 %    run-in section title immediately before a |\newpage| get printed
 %    on the correct page, the one before the page break.
@@ -988,6 +988,18 @@
   \fi
   \if at nobreak \@nobreakfalse \everypar{}\fi
   \par
+%    \end{macrocode}
+%    The |\vfil| at the end of the macro before the break penalty will 
+%    normally result in the page being run short,  even with |\flushbottom|
+%    in effect (in contrast to the behavior
+%    of |\pagebreak|). However, if there 
+%    is some explicit stretch on the page, say, a |\vfill|, it has the undesired
+%    side-effect, that the last line will not align at its baseline if it
+%    contains characters going below the baseline, as the value of |\prevdepth|
+%    is no longer taken into account by \TeX{}. So we back up by that amount 
+%    (or by |\maxdepth| if it is really huge), to mimic the normal behavior 
+%    without the |\newpage|.
+%    \begin{macrocode}
   \ifdim\prevdepth>\z@
      \vskip -%
        \ifdim\prevdepth>\maxdepth