Docutils: Documentation Utilities / Bugs / #145 error report with paragraph start line instead of error-line

error report with paragraph start line instead of error-line

#145 error report with paragraph start line instead of error-line

Status: open

Owner: nobody

Labels: None

Priority: 2

Updated: 2022-05-30

Created: 2010-08-22

Creator: anatoly techtonik

Private: No

Sphinx - the tool to generate official Python documentation reports incorrect line with an error in reST source. Georg Brandl (Sphinx maintainer) detected that it is Docutils bug, Guenter Milde confirmed that in private mail.

http://bitbucket.org/birkenfeld/sphinx/issue/457/wrong-line-number-reported-on-error

Günter Milde - 2010-08-23

priority: 5 --> 2

summary: Issue 457 in sphinx: wrong line number reported on error --> error report with paragraph start line instead of error-line
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:

anatoly techtonik - 2010-08-23

I'd say it is a bug, because a common notation for error reporting like "docs\freefeatures.rst:26: bla-bla-bla" is a source code line number.

If you would like to refer to this comment somewhere else in this project, copy and paste the following link:

Reproducer:

Line Number Bug
===============

Lorem ipsum dolor sit amet, consectetur adipiscing
elit. Vivamus congue convallis pulvinar. Donec eget
orci lorem. Nunc eu dignissim ligula. Nullam nisl
nibh, vulputate a justo eget, congue auctor libero.
Quisque aliquam nulla ac porttitor_ dignissim.
Vivamus sit amet metus ac nunc fermentum vestibulum.

(docutils) S:\Development\docutils>docutils line-numbers-errors.rst line-numbers-errors.html    
line-numbers-errors.rst:4: (ERROR/3) Unknown target name: "porttitor".

Note the non existent target porttitor_ is on line 8 of the document, but the error is reported against line 4.

error report with paragraph start line instead of error-line

Searches

Help

#145 error report with paragraph start line instead of error-line

Related

Discussion