[docs] [issue10344] codecs.open() buffering doc needs fix

[Martin Panter]

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>
_______________________________________