[docs] [issue22341] Python 3 crc32 documentation clarifications
Gregory P. Smith
report at bugs.python.org
Fri Mar 20 22:07:32 CET 2015
Gregory P. Smith added the comment:
I do not object to the removal of the & 0xfffffff from the stdlib library code if these functions have actually been fixed to always return unsigned now. (double check the behavior, and if good, just do it!)
But I think the docs should still mention that the & 0xffffffff is a good practice if code needs to be compatible with Python versions prior to X.Y (list the last release before the behavior was corrected). Possibly within a .. versionchanged: section.
People often use the latest docs when writing code in any version of Python as we continually improve docs and are pretty good about noting old behaviors and when behaviors changed.
Python tracker <report at bugs.python.org>
More information about the docs