[docs] [issue21637] Add a warning section exaplaining that tempfiles are opened in binary mode

Josh Rosenberg report at bugs.python.org
Tue Jun 3 23:53:56 CEST 2014


Josh Rosenberg added the comment:

Adding warnings for something that is clearly documented (both in the constructor prototype line and again in the spelled out documentation of the "mode" argument) is wasteful, particularly when accidental misuse would immediately lead to an exception being thrown the second you attempted to write a str (so there is no risk of partial or silent failure that might lead to an inconsistent state).

As a rule, Python doesn't litter the documentation with warnings unless it's a matter of security or minor version compatibility. This doesn't affect security, behaves identically across all releases of Python 3, etc.

----------
nosy: +josh.rosenberg

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue21637>
_______________________________________


More information about the docs mailing list