Re: [PATCH] docs: Instruct LaTeX to cope with deeper nesting

[Jonathan Corbet <corbet@lwn.net>]

Akira Yokosawa <akiyks@gmail.com> writes:

> On Mon, 19 Feb 2024 09:05:38 -0700, Jonathan Corbet wrote:
>> The addition of the XFS online fsck documentation starting with
>> commit a8f6c2e54ddc ("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>
>> Link: https://lore.kernel.org/linux-doc/67f6ac60-7957-4b92-9d72-a08fbad0e028@gmail.com/
>> Signed-off-by: Jonathan Corbet <corbet@lwn.net>
>
> Tested-by: Akira Yokosawa <akiyks@gmail.com>

Thanks

> And it seems this one might deserve
>
> Cc: stable@vger.kernel.org # v6.4
>
> too, in case someone tries "make pdfdocs" against 6.6.x LTS 
> and 6.7.x stable branches.

Agreed, that was in my plans.

> Commit a8f6c2e54ddc did nothing wrong on its own, so a Fixes: tag
> is inappropriate here.

And a Fixes tag was definitely *not* in the plan.

Thanks,

jon