[issue7508] Update 'file object' doc

[Terry J. Reedy]

New submission from Terry J. Reedy <tjreedy at udel.edu>:

"5.9. File Objects¶
File objects are implemented using C’s stdio package and can be created
with the built-in open() function."

As I understand, the part about stdio is no longer true.
Also, as I understand, there is no longer a class <file> object.
Rather there are various io (or _io) classes returned by open depending
on the args, especially the mode. This should be made clear. Something like

"File objects are created by the built-in open function and others.
There are instances of various classes exposed in the io module. The
following discusses the methods common to various file objects."

Maybe even retitle the section "IO objects" and use 'io' instead of
'file' as the prefix for method names.

Maybe whoever wrote the new io system could check this section for accuracy.

----------
assignee: georg.brandl
components: Documentation
messages: 96419
nosy: georg.brandl, tjreedy
severity: normal
status: open
title: Update 'file object' doc
versions: Python 3.1, Python 3.2

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