[Python-Dev] Documentation strategy for PEP 3151

[Barry Warsaw]

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:`inet_ntop`.
>>
>> 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