[Docutils-develop] Re: removing docutils.utils.Reporter.categories

[Felix W. <Fel...@gm...>]

David Goodger wrote:

> Felix's recent optimization [...]  made me realize that
> docutils.utils.Reporter.categories could probably be removed as
> unneeded functionality.

That's always a good idea.

> I have created a "reporter-categories" branch with the changes I think
> are correct, checked in as revision 3163.  The test suite runs fine,
> but to be sure, could people please take a look and let me know if
> I've missed or broken anything?

I think it looks fine.

Your change made me think of the following problem: What if readers or
writers want to throw warnings ("LaTeX writer doesn't support row-spans
in tables") or errors ("Document does not begin with an RFC-2822 header;
it is not a PEP")?

Should these messages be handled through the Docutils' standard
reporting system?  Might this even be a use case for categories?  Should
system_message nodes generated by reader or writer components be
inserted into the document?

-- 
When replying to my email address, please ensure
that the mail header contains 'Felix Wiemann'.

http://www.ososo.de/