On Sun, 16 Nov 2025 19:26:44 +0900, Masaharu Noguchi wrote:
> Sphinx LaTeX builder fails on nested tables in f2fs.rst, producing:
>
> “Markup is unsupported in LaTeX: longtable does not support nesting a
> table.”
>
> Wrap the affected ASCII tables in literal code blocks so Sphinx renders them
> verbatim. This avoids nested longtables and fixes the LaTeX build on Sphinx
> 8.2.x.
>
> Changes in v4:
> - Rebased on 62242ac51061
> - Cleaned up Changelog placement (move version history above '---')
This is not what I asked by saying:
These background and change history should go out of the Changelog area.
Changelog ends at '---'. See:
https://www.kernel.org/doc/html/latest/process/submitting-patches.html#commentary
> - Verified `make htmldocs` and `make pdfdocs` build fine
>
> Changes in v3:
> - Replace TABs inside ASCII tables with spaces
>
> Changes in v2:
> - Wrap nested ASCII tables in literal blocks and fix missing blank lines
>
> Acked-by: Bagas Sanjaya <[email protected]>
> Reviewed-by: Akira Yokosawa <[email protected]>
> Signed-off-by: Masaharu Noguchi <[email protected]>
>
> Link: https://www.spinics.net/lists/kernel/msg5921848.html
> Link: https://www.spinics.net/lists/kernel/msg5918264.html
> Link: https://www.spinics.net/lists/kernel/msg5875662.html
> ---
> Documentation/filesystems/f2fs.rst | 131 +++++++++++++++--------------
> 1 file changed, 69 insertions(+), 62 deletions(-)
./scripts/checkpatch.pl emits the following:
------------------------------------------------------------------------
WARNING: Prefer a maximum 75 chars per line (possible unwrapped commit
description?)
#26:
“Markup is unsupported in LaTeX: longtable does not support nesting a table.”
ERROR: Please use git commit description style 'commit <12+ chars of sha1>
("<title line>")' - ie: 'commit 62242ac51061 ("Documentation: f2fs: Reword
title")'
#32:
- Rebased on 62242ac51061
WARNING: Use lore.kernel.org archive links when possible - see
https://lore.kernel.org/lists.html
#46:
Link: https://www.spinics.net/lists/kernel/msg5921848.html
WARNING: Use lore.kernel.org archive links when possible - see
https://lore.kernel.org/lists.html
#47:
Link: https://www.spinics.net/lists/kernel/msg5918264.html
WARNING: Use lore.kernel.org archive links when possible - see
https://lore.kernel.org/lists.html
#48:
Link: https://www.spinics.net/lists/kernel/msg5875662.html
------------------------------------------------------------------------
Also, please apply your patch on your own before submitting it and
see the Changelog looks good to you.
Thanks, Akira
_______________________________________________
Linux-f2fs-devel mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/linux-f2fs-devel
