Re: [Docutils-develop] Docutils 0.6 causes crash of Epydoc 3.0.1 when generating documentation for dbus-python 0.83.0

[Arfrever F. T. A. <arf...@gm...>]

2009-11-13 14:24:14 Martin von Gagern napisał(a):
> Arfrever Frehtes Taifersar Arahesis wrote:
> > gr...@us... wrote:
> >> AttributeError: _Sentinel instance has no attribute '__getitem__'
> >>
> >>
> >> is this a document error or ?
> > 
> > I don't know. I see the same exception after applying your patch.
> 
> I can reproduce this error when running the command by itself, as
> Arfrever stated it in his script. The dbus-python build process,
> however, works fine. After some trial and error, it seems that an
> environment variable makes the difference: the make file passes
> DBUS_PYTHON_NO_DEPRECATED=1 to its invocation of epydoc.
> 
> Seems like there migt be some issue with part of the documentation, but
> I wouldn't care about that, as this part isn't usually included.

But it's still a bug (in Epydoc or Docutils). If documentation has some issues,
then Epydoc or Docutils should print a warning (or sometimes an error) explaining
issues in documentation instead of causing a traceback.

> Cross reference: someone (maybe one of you who wrote in this thread?)
> opened a bug report for epydoc about this issue:
> http://sourceforge.net/tracker/?func=detail&aid=2895197&group_id=32455&atid=405618

It has been reported by me.

-- 
Arfrever Frehtes Taifersar Arahesis