Jan. 29, 2011
3:53 a.m.
I'm not sure how much of a problem maintaining it would be, especially as I agree that linking to the API docs is probably a good idea (though I think a lot of the docstrings in there could be greatly improved). For one thing, how often has the _intent_ of the IProtocol interface(which has no docstring, btw) changed?
So, first: aaaaaauuugh. Is there a doc bug for that? That is an interface which really, really needs a docstring. Can you submit a patch, like, right now? :)
I don't see one. Nor for the over-terse Factory/IFactory docstrings. I'll create one though. Kevin Horn