[Docutils-develop] [ docutils-Bugs-3050874 ] error report with paragraph start line instead of error-line

[SourceForge.net <no...@so...>]

Bugs item #3050874, was opened at 2010-08-22 16:17
Message generated for change (Settings changed) made by milde
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=422030&aid=3050874&group_id=38414

Please note that this message will contain a full copy of the comment thread,
including the initial issue submission, for this request,
not just the latest update.
Category: None
Group: None
Status: Open
Resolution: None
>Priority: 2
Private: No
Submitted By: anatoly techtonik (techtonik)
Assigned to: Nobody/Anonymous (nobody)
>Summary: error report with paragraph start line instead of error-line

Initial Comment:
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

----------------------------------------------------------------------

>Comment By: Günter Milde (milde)
Date: 2010-08-23 09:57

Message:
The sphinx issue: 

  Sphinx shows wrong line number when reporting errors and warning during
build. 
  In the documentation for cmd2 http://hg.assembla.com/python-cmd2 ::

     docs\freefeatures.rst:26: (ERROR/3) Unknown target name:
"pyparsing".

  the actual line number is 30.

Reply by Georg Brandl:

 The line number points to the start of the paragraph since docutils
doesn't resolve it further.

For many errors, docutils reports the line number of the containing
paragraph or the start of a directive.
This is also the expected output in the respective unit-tests.

While this behaviour is no problem for short paragraph or directives, e.g.
in a table it might be better to report the actual line-number of the
problem instead of the first line of the table + the table itself + the
offset.

Is this (line-accurate reporting of errors)  a bug or a feature request?


----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=422030&aid=3050874&group_id=38414