On Mon, Jul 07, 2025 at 06:10:52AM +0000, Werner LEMBERG wrote:
>
> [texinfo.tex 2025-03-22.08]
> [luatex Version 1.22.0 (TeX Live 2025), Development id: 7673]
>
>
> While playing around with adding parts to LilyPond's Notation
> Reference, I got the attached layout in the ToC. As can be seen,
> there is a vertical gap corresponding to approx. 8 lines(!) at the
> bottom of page vi; I've never noticed such a large gap before in any
> Texinfo document.
>
> Is this expected? To me, it looks excessive, and there are other ToC
> pages in the Notation Reference where such a bottom space is easily
> filled up with a chapter entry line and more than four following
> section or subsection entries.
>
>
> Werner
I believe it is due to the use of \raggedbottom (used in the \startcontents
macro.) A page break before a chapter entry is prioritised and space at
the end of the page allows this. You could try playing around with the value
in our definition of \raggedbottom:
\def\raggedbottom{\advance\topskip by 0pt plus60pt \r@ggedbottomtrue}
60pt would be about 6 lines of 10-point text but the -300 bonus for
line breaking would allow somewhat more. (The cube root of 300/100 is
1.44 so possibly about 44% more - although I don't have a great knowledge
of TeX's exact page breaking calculations.)
We could reduce this 60pt value if you find a lower value would be
better.