reST parser warns twice if the underline for second heading is short.
I think it is a bit verbose.
Input:
$ cat helper.rst
Issue #5214
===========
django_assert_num_queries
========
Output (warnings):
$ rst2html.py helpers.rst > /dev/null
helpers.rst:5: (WARNING/2) Title underline too short.
django_assert_num_queries
========
helpers.rst:5: (WARNING/2) Title underline too short.
django_assert_num_queries
========
It seems the parser does not warn if the short underline appears at first.
Note: originately this was reported to sphinx: https://github.com/sphinx-doc/sphinx/issues/5214
Thank you for reporting.
This is due to the current setup of the rST parser regarding section level handling.
The issue is solved by a recent patch by Arne Skjærholt [patches:#213] (which still needs to be tested for side-effects).
Related
Patches:
#213Fixed in [r10093]. Thank you for the report.
Related
Commit: [r10093]
The issue is fixed in Docutils 0.22 released 2025-07-29.
Thank you for reporting.