[Python-Dev] Documentation strategy for PEP 3151 (original) (raw)

Barry Warsaw barry at python.org
Wed Oct 12 16:58:29 CEST 2011

On Oct 12, 2011, at 10:24 AM, Benjamin Peterson wrote:

2011/10/12 Antoine Pitrou <solipsis at pitrou.net>:

I'd like some advice on what the best path is in cases such as:

A :exc:socket.error is raised for errors from the call to :func:inetntop. Should I replace "socket.error" with "OSError" (knowing that the former is now an alias of the latter), or leave "socket.error" so that people have less surprises when running their code with a previous Python version? I think you should say OSError but leave a historical note with a versionchanged on it.

+1 -Barry

More information about the Python-Dev mailing list