summaryrefslogtreecommitdiffstats
path: root/Doc/glossary.rst
diff options
context:
space:
mode:
authorSerhiy Storchaka <storchaka@gmail.com>2017-03-12 06:53:22 (GMT)
committerGitHub <noreply@github.com>2017-03-12 06:53:22 (GMT)
commitc611a5b1d4fab0123bf622f06c3bfa510221dc32 (patch)
treefcdc7f1ece4dff3acdebd3cb16458c64c2ff847f /Doc/glossary.rst
parent93710c152e6bcfffdf2f1f15bb5f75b013aef422 (diff)
downloadcpython-c611a5b1d4fab0123bf622f06c3bfa510221dc32.zip
cpython-c611a5b1d4fab0123bf622f06c3bfa510221dc32.tar.gz
cpython-c611a5b1d4fab0123bf622f06c3bfa510221dc32.tar.bz2
bpo-29746: Update marshal docs to Python 3. (#547)
Diffstat (limited to 'Doc/glossary.rst')
-rw-r--r--Doc/glossary.rst7
1 files changed, 7 insertions, 0 deletions
diff --git a/Doc/glossary.rst b/Doc/glossary.rst
index e07ab0d..495934a 100644
--- a/Doc/glossary.rst
+++ b/Doc/glossary.rst
@@ -131,6 +131,10 @@ Glossary
binary file
A :term:`file object` able to read and write
:term:`bytes-like objects <bytes-like object>`.
+ Examples of binary files are files opened in binary mode (``'rb'``,
+ ``'wb'`` or ``'rb+'``), :data:`sys.stdin.buffer`,
+ :data:`sys.stdout.buffer`, and instances of :class:`io.BytesIO` and
+ :class:`gzip.GzipFile`.
.. seealso::
A :term:`text file` reads and writes :class:`str` objects.
@@ -966,6 +970,9 @@ Glossary
A :term:`file object` able to read and write :class:`str` objects.
Often, a text file actually accesses a byte-oriented datastream
and handles the :term:`text encoding` automatically.
+ Examples of text files are files opened in text mode (``'r'`` or ``'w'``),
+ :data:`sys.stdin`, :data:`sys.stdout`, and instances of
+ :class:`io.StringIO`.
.. seealso::
A :term:`binary file` reads and write :class:`bytes` objects.