Andrew McNabb <amcn...@mcnabbs.org> added the comment:

Oops.  I had run "pydoc" instead of "pydoc3", so I was getting the 2.6 version 
of the io docstrings instead of the 3.1 version.

By the way, it took about an hour to find out how to get Python 3 to treat 
stdin as bytes instead of unicode.  Now that I know what I was looking for, the 
documentation for the io library seems fine.  However, since Python 3 uptake is 
still a little slow, it's really hard to search for good information out there.

Would it be possible to some tutorial-style information to the io library 
documentation?  Stuff like switching stdin and stdout to bytes mode seem like 
they will be common problems, and it's a bit overwhelming to sort through 14 
pages of documentation.  I think for most readers, it would be helpful to start 
with a brief tutorial before lunging into the hierarchy of abstract classes.

Overall, the documentation is great; it's detailed and complete.  If there's 
one weakness, it's the overview.

Thanks.

----------

_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue7954>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to