Update 'file object' doc

[terryjreedy]

BPO	7508
Nosy	@birkenfeld, @terryjreedy, @pitrou

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = 'https://github.com/pitrou'
closed_at = <Date 2009-12-19.18:23:35.672>
created_at = <Date 2009-12-15.04:43:42.301>
labels = ['docs']
title = "Update 'file object' doc"
updated_at = <Date 2009-12-19.18:23:35.671>
user = 'https://github.com/terryjreedy'

bugs.python.org fields:

activity = <Date 2009-12-19.18:23:35.671>
actor = 'pitrou'
assignee = 'pitrou'
closed = True
closed_date = <Date 2009-12-19.18:23:35.672>
closer = 'pitrou'
components = ['Documentation']
creation = <Date 2009-12-15.04:43:42.301>
creator = 'terry.reedy'
dependencies = []
files = []
hgrepos = []
issue_num = 7508
keywords = []
message_count = 6.0
messages = ['96419', '96617', '96624', '96626', '96629', '96636']
nosy_count = 3.0
nosy_names = ['georg.brandl', 'terry.reedy', 'pitrou']
pr_nums = []
priority = 'normal'
resolution = 'fixed'
stage = None
status = 'closed'
superseder = None
type = None
url = 'https://bugs.python.org/issue7508'
versions = ['Python 3.1', 'Python 3.2']

[terryjreedy]

"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.

[birkenfeld]

Maybe Antoine wants (!) to look at it.

[pitrou]

In which part/filename of the doc can I find this extract?

[pitrou]

Okay, I've found it. IMO this section should simply be removed, since
the file type doesn't exist anymore.

[pitrou]

Note: one issue is that io.rst is currently some kind of technical
reference about base classes and stuff, it is unreadable for anyone
looking for simple information.

[pitrou]

I've removed it in r76893. Thanks!