Message99489
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. |
|
Date |
User |
Action |
Args |
2010-02-18 01:22:47 | amcnabb | set | recipients:
+ amcnabb, benjamin.peterson |
2010-02-18 01:22:47 | amcnabb | set | messageid: <1266456167.71.0.672349998034.issue7954@psf.upfronthosting.co.za> |
2010-02-18 01:22:46 | amcnabb | link | issue7954 messages |
2010-02-18 01:22:44 | amcnabb | create | |
|