Hello, On Sun, 12 Oct 2025 02:24:15 +0900, Masaharu Noguchi wrote: > Sphinx LaTeX builder fails with the following error: > > Markup is unsupported in LaTeX: > filesystems/f2fs:: longtable does not support nesting a table. > > Wrap the ASCII tables in literal code blocks so that they are rendered > as code instead of interpreted as tables. This fixes pdfdocs build > failure. > > Signed-off-by: Masaharu Noguchi <[email protected]>
With this patch applied, "make SPHINXDIRS=filesystems htmldocs" emits following new warnings (Sphinx 8.2.3): -------- -------- -------- -------- -------- -------- -------- -------- <srctree>/Documentation/filesystems/f2fs.rst:307: WARNING: Explicit markup ends without a blank line; unexpected unindent. [docutils] <srctree>/Documentation/filesystems/f2fs.rst:308: ERROR: Malformed table. No bottom table border found. ========= =========== [docutils] <srctree>/Documentation/filesystems/f2fs.rst:309: WARNING: Definition list ends without a blank line; unexpected unindent. [docutils] <srctree>/Documentation/filesystems/f2fs.rst:310: ERROR: Unexpected indentation. [docutils] <srctree>/Documentation/filesystems/f2fs.rst:311: ERROR: Malformed table. No bottom table border found. ========= =========== [docutils] -------- -------- -------- -------- -------- -------- -------- -------- That said, for your info, in-development Sphinx 8.3.0 (not yet released) has a lot of improvements in its latex builder including support of these nested tables [1]. So, I think one option for you might be to wait Sphinx 8.3.0 without these changes. One caveat is that docutils 0.22.x is not fully compatible with the latex builder at the moment. If you'd like to test Sphinx 8.3.0, you need to say "docutils<0.22" in pip install. [1]: https://www.sphinx-doc.org/en/master/changes/index.html#release-8-3-0-in-development Hope this helps, Akira _______________________________________________ Linux-f2fs-devel mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/linux-f2fs-devel
