[docs] [issue10344] codecs.open() buffering doc needs fix
Martin Panter
report at bugs.python.org
Fri May 29 01:48:59 CEST 2015
Martin Panter added the comment:
A couple of specific problems have been raised by Terry here. Checking each against the current Python 3 status, some have already been fixed:
* The codecs.open() signature has been fixed in Issue 19548.
* The StreamReader.readline(size=...) parameter documentation has been fixed to match the docstring in Issue 18336.
So that leaves these three problems, as I see it:
1. The notice about opening in binary mode still needs fixing for encoding=None.
2. The buffering parameter is applied to the underlying builtins.open() call, so should be clarified in the documentation.
3. codecs.open(filename, encoding=...) will by default call builtins.open(filename, "rb", buffering=1), which makes no sense according the the documentation.
----------
nosy: +vadmium
stage: -> needs patch
title: codecs.StreamReader.readline doc needs fix -> codecs.open() buffering doc needs fix
_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue10344>
_______________________________________
More information about the docs
mailing list