Skip to content

Commit

Permalink
docs: Instruct LaTeX to cope with deeper nesting
Browse files Browse the repository at this point in the history
commit 0df8669 upstream.

The addition of the XFS online fsck documentation starting with
commit a8f6c2e ("xfs: document the motivation for online fsck design")
added a deeper level of nesting than LaTeX is prepared to deal with.  That
caused a pdfdocs build failure with the helpful "Too deeply nested" error
message buried deeply in Documentation/output/filesystems.log.

Increase the "maxlistdepth" parameter to instruct LaTeX that it needs to
deal with the deeper nesting whether it wants to or not.

Suggested-by: Akira Yokosawa <akiyks@gmail.com>
Tested-by: Akira Yokosawa <akiyks@gmail.com>
Cc: stable@vger.kernel.org # v6.4+
Link: https://lore.kernel.org/linux-doc/67f6ac60-7957-4b92-9d72-a08fbad0e028@gmail.com/
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
  • Loading branch information
Jonathan Corbet authored and gregkh committed Mar 1, 2024
1 parent 48985d6 commit 5029790
Showing 1 changed file with 6 additions and 0 deletions.
6 changes: 6 additions & 0 deletions Documentation/conf.py
Original file line number Diff line number Diff line change
Expand Up @@ -383,6 +383,12 @@ def get_cline_version():
verbatimhintsturnover=false,
''',

#
# Some of our authors are fond of deep nesting; tell latex to
# cope.
#
'maxlistdepth': '10',

# For CJK One-half spacing, need to be in front of hyperref
'extrapackages': r'\usepackage{setspace}',

Expand Down

0 comments on commit 5029790

Please sign in to comment.