[docutils:bugs] #346 reST parser warns twice for short underline

Günter Milde via Docutils-develop <[email protected]> Sat, 05 Apr 2025 09:56:01 -0000
Newsgroups gmane.text.docutils.devel
Message-ID </p/docutils/bugs/346/71aca574e17922a13dc6ebc8fba42f1062ca06b6.bugs@docutils.p.sourceforge.net>
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).


---

**[bugs:#346] reST parser warns twice for short underline**

**Status:** open
**Created:** Sun Jul 29, 2018 11:37 AM UTC by Takeshi KOMIYA
**Last Updated:** Tue Mar 03, 2020 09:41 PM UTC
**Owner:** nobody


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


---

Sent from sourceforge.net because [email protected] is subscribed to https://sourceforge.net/p/docutils/bugs/

To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/docutils/admin/bugs/options.  Or, if this is a mailing list, you can unsubscribe from the mailing list.