On Jun 20, 2012, at 01:58 PM, R. David Murray wrote:

>Barry: I think we should documentationally deprecate the encoders module.  I
>can't see any utility in a new program calling those functions explicitly,
>especially if the program ever wants to port to Python3.  Or maybe the
>Python2 docs would say deprecated in Python3.

I agree that we should document them as deprecated, as long as we include text
explaining why, or providing alternatives (e.g. "you think you need this but
you don't because...")

I think it does make sense to include text in the Py2 docs about this.