[docs] [issue33239] tempfile module: functions with the 'buffering' option are incorrectly documented

Martin Falatic report at bugs.python.org
Sun Apr 8 19:41:40 EDT 2018


Martin Falatic <martin at falatic.com> added the comment:

The correction of `buffering=None` --> `buffering=-1` for the defaults definitely needs to happen.

A reference to `open()` is already present in the 3.x documentation: "buffering, encoding and newline are interpreted as for open()."

Given that the `open()` reference already suffices for `encoding` and `newline`, it ought to suffice for `buffering` as well. No extra text beyond that should be necessary (I originally thought that might be good to add, but looking at this now it's clear if you add more to describe `buffering` you'll need to add it for the other two options, and it's all duplicative. Fixing the defaults should suffice.)

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33239>
_______________________________________


More information about the docs mailing list