[Twisted-Python] Re: [Twisted-commits] r18320 - Name functions in deprecation warnings

[Jonathan Lange]

On 9/30/06, James Y Knight <foom at fuhm.net> wrote:
>
> As a general note, when deprecating something that is replaced by
> something else, the original thing should mention what the new thing
> is you should use instead. In this case, that'd be
> "self.observer.flushErrors(...)", if you're using it in a test case,
> I think?
>

I normally do this. I didn't in this case because
TestCase.flushLoggedErrors isn't a full replacement. Still, from what
I understand, these APIs were added for tests so it's probably worth
documenting.

cheers,
jml