Re: [f2fs-dev] [PATCH] Documentation: f2fs: wrap tables in literal code blocks to fix LaTeX build

[Akira Yokosawa <akiyks@gmail.com>]

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 <nogunix@gmail.com>

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
Linux-f2fs-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/linux-f2fs-devel