superbol-studio-oss icon indicating copy to clipboard operation
superbol-studio-oss copied to clipboard

Minor issue in RST generation with `command_texi2rst.ml`

Open engboris opened this issue 1 year ago • 0 comments

If I understand correctly, the program in src/lsp/superbol_free_lib/command_texi2rst.ml generates the sphinx/commands.rst file. It is a minor issue but the generated file generate warnings because it does not perfectly follow the Sphinx syntax:

superbol-studio-oss/sphinx/commands.rst:115: WARNING: Bullet list ends without a blank line; unexpected unindent.
superbol-studio-oss/sphinx/commands.rst:177: WARNING: Bullet list ends without a blank line; unexpected unindent.
superbol-studio-oss/sphinx/commands.rst:180: WARNING: Bullet list ends without a blank line; unexpected unindent.
superbol-studio-oss/sphinx/commands.rst:183: WARNING: Bullet list ends without a blank line; unexpected unindent.
superbol-studio-oss/sphinx/commands.rst:186: WARNING: Bullet list ends without a blank line; unexpected unindent.
superbol-studio-oss/sphinx/commands.rst:258: WARNING: Bullet list ends without a blank line; unexpected unindent.
superbol-studio-oss/sphinx/commands.rst:300: WARNING: Bullet list ends without a blank line; unexpected unindent.
superbol-studio-oss/sphinx/commands.rst:327: WARNING: Inline emphasis start-string without end-string.
superbol-studio-oss/sphinx/commands.rst:329: WARNING: Inline emphasis start-string without end-string.
superbol-studio-oss/sphinx/commands.rst:333: WARNING: Inline emphasis start-string without end-string.
[...]

It seems to me caused by misplaced * symbols, wrong indentation and such.

engboris avatar Feb 13 '24 09:02 engboris