On 2016-08-16 08:56, Steve Dower wrote:
I just want to clearly address two points, since I feel like multiple
posts have been unclear on them.

1. The bytes API was deprecated in 3.3 and it is listed in
https://docs.python.org/3/whatsnew/3.3.html. Lack of mention in the docs
is an unfortunate oversight, but it was certainly announced and the
warning has been there for three released versions. We can freely change
or remove the support now, IMHO.

I strongly disagree with that. If using the code does not raise a visible warning (because DeprecationWarning is silent by default), and the documentation does not say it's deprecated, it hasn't actually been deprecated. Deprecation is the communicative act of saying "don't do this anymore". If that information is not communicated in the appropriate places (e.g., the docs), the deprecation has not occurred.

--
Brendan Barnwell
"Do not follow where the path may lead. Go, instead, where there is no path, and leave a trail."
   --author unknown
_______________________________________________
Python-ideas mailing list
Python-ideas@python.org
https://mail.python.org/mailman/listinfo/python-ideas
Code of Conduct: http://python.org/psf/codeofconduct/

Reply via email to