diff options
author | R David Murray <rdmurray@bitdance.com> | 2012-08-18 00:33:54 (GMT) |
---|---|---|
committer | R David Murray <rdmurray@bitdance.com> | 2012-08-18 00:33:54 (GMT) |
commit | 9f0c9401d364cae9ef366e50ded1faf156c32ef0 (patch) | |
tree | 45222becc4aa161c83b4048154c047c89360fff8 /Doc/library/io.rst | |
parent | f6190c146347c088d1927e95fa5cb3cfbea6f423 (diff) | |
download | cpython-9f0c9401d364cae9ef366e50ded1faf156c32ef0.zip cpython-9f0c9401d364cae9ef366e50ded1faf156c32ef0.tar.gz cpython-9f0c9401d364cae9ef366e50ded1faf156c32ef0.tar.bz2 |
#15694: Link discussion of file objects to glossary entry.
This is analogous to the link for `flie objects` in the description of
'open' that exists in the 2.7 docs, and adds a similar link to the
io docs.
Patch by Chris Jerdonek.
Diffstat (limited to 'Doc/library/io.rst')
-rw-r--r-- | Doc/library/io.rst | 14 |
1 files changed, 9 insertions, 5 deletions
diff --git a/Doc/library/io.rst b/Doc/library/io.rst index b71bfd4..62eaf6d 100644 --- a/Doc/library/io.rst +++ b/Doc/library/io.rst @@ -16,11 +16,15 @@ Overview -------- -The :mod:`io` module provides Python's main facilities for dealing for various -types of I/O. There are three main types of I/O: *text I/O*, *binary I/O*, *raw -I/O*. These are generic categories, and various backing stores can be used for -each of them. Concrete objects belonging to any of these categories will often -be called *streams*; another common term is *file-like objects*. +.. index:: + single: file object; io module + +The :mod:`io` module provides Python's main facilities for dealing with various +types of I/O. There are three main types of I/O: *text I/O*, *binary I/O* +and *raw I/O*. These are generic categories, and various backing stores can +be used for each of them. A concrete object belonging to any of these +categories is called a :term:`file object`. Other common terms are *stream* +and *file-like object*. Independently of its category, each concrete stream object will also have various capabilities: it can be read-only, write-only, or read-write. It can |