docs: pdfdocs: Adjust \headheight for fancyhdr
authorAkira Yokosawa <akiyks@gmail.com>
Mon, 11 Oct 2021 02:05:04 +0000 (11:05 +0900)
committerJonathan Corbet <corbet@lwn.net>
Tue, 12 Oct 2021 20:09:03 +0000 (14:09 -0600)
commitaa872e0647dc0bfd69d83c3342bfac3fb4bbbb4f
treeebb45dc1ab92dd0010a639a1c7448f9a6cbdf20a
parente825b29ab81208e70167e234aa94bc6f6f21980e
docs: pdfdocs: Adjust \headheight for fancyhdr

Fancyhdr prior to v4.0 outputs a message per document as follows:

    Package Fancyhdr Warning: \headheight is too small (12.0pt):
    Make it at least 13.59999pt.
    We now make it that large for the rest of the document.
    This may cause the page layout to be inconsistent, however.

Fancyhdr v4.0 complains (once a page!) as follows:

    Package fancyhdr Warning: \headheight is too small (12.0pt):
    (fancyhdr)    Make it at least 13.59999pt, for example:
    (fancyhdr)    \setlength{\headheight}{13.59999pt}.
    (fancyhdr)    You might also make \topmargin smaller to compensate:

    (fancyhdr)    \addtolength{\topmargin}{-1.59999pt}.

Related item in fancyhdr v4.0 announcement on 2021-01-04 [1]:

    Backward incompatible changes:
      - Eliminate adjustments of \headheight or \footskip, when the
        header or footer is too high.

[1]: https://www.ctan.org/ctan-ann/id/mailman.2685.1609863692.2532.ctan-ann@ctan.org

Silence the warnings by adding a couple of \addtolength commands in
the preamble.

Signed-off-by: Akira Yokosawa <akiyks@gmail.com>
Link: https://lore.kernel.org/r/c5a5577e-5de8-9cd4-9253-956ccc748417@gmail.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Documentation/conf.py