[issue5539] open documentation unclear

[David W. Lambert]

New submission from David W. Lambert <lambertdw at corning.com>:

See thread
http://groups.google.com/group/comp.lang.python/browse_thread/thread/85e
c714aa6898d84#


En Sun, 22 Mar 2009 19:12:13 -0300, Benjamin Peterson   
<benja... at python.org> escribió: 
> Gabriel Genellina <gagsl-py2 <at> yahoo.com.ar> writes: 
>> The undocumented behavior is relying on the open() builtin to return 
a 
>> BufferedReader for a binary file. 
> I don't see the problem. open() will return some BufferedIOBase   
> implmentor, and 
> that's all that TextIOWrapper needs. 


How do you know? AFAIK, the return value of open() is completely   
undocumented: 
http://docs.python.org/3.0/library/functions.html#open 
And if you open the  file in text mode, the return value isn't a   
BufferedIOBase. 
-- 
Gabriel Genellina 

The return value of open() is a "stream", according to 
http://docs.python.org/dev/py3k/library/io.html#module-io

----------
messages: 83990
nosy: LambertDW
severity: normal
status: open
title: open documentation unclear

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