Author josh.r
Recipients Sebastian.Kreft.Deezer, docs@python, josh.r
Date 2014-06-03.21:53:55
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1401832436.64.0.50026215468.issue21637@psf.upfronthosting.co.za>
In-reply-to
Content
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.
History
Date User Action Args
2014-06-03 21:53:56josh.rsetrecipients: + josh.r, docs@python, Sebastian.Kreft.Deezer
2014-06-03 21:53:56josh.rsetmessageid: <1401832436.64.0.50026215468.issue21637@psf.upfronthosting.co.za>
2014-06-03 21:53:56josh.rlinkissue21637 messages
2014-06-03 21:53:55josh.rcreate