summaryrefslogtreecommitdiffstats
path: root/Doc/library/io.rst
diff options
context:
space:
mode:
authorR David Murray <rdmurray@bitdance.com>2012-08-18 00:38:19 (GMT)
committerR David Murray <rdmurray@bitdance.com>2012-08-18 00:38:19 (GMT)
commit8eac575e817f6874f3dd34b0b6bed5c8b1011131 (patch)
treefe8b4d86089054ff5076cc3bcbd58416e16bde6b /Doc/library/io.rst
parent5c3ddc8066993199a6af25ce9011ae587a60117b (diff)
parent9f0c9401d364cae9ef366e50ded1faf156c32ef0 (diff)
downloadcpython-8eac575e817f6874f3dd34b0b6bed5c8b1011131.zip
cpython-8eac575e817f6874f3dd34b0b6bed5c8b1011131.tar.gz
cpython-8eac575e817f6874f3dd34b0b6bed5c8b1011131.tar.bz2
Merge #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.rst14
1 files changed, 9 insertions, 5 deletions
diff --git a/Doc/library/io.rst b/Doc/library/io.rst
index 3a8ddd0..e83e55c 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