summaryrefslogtreecommitdiffstats
path: root/Doc/library/bz2.rst
diff options
context:
space:
mode:
authorNadeem Vawda <nadeem.vawda@gmail.com>2013-12-08 18:47:22 (GMT)
committerNadeem Vawda <nadeem.vawda@gmail.com>2013-12-08 18:47:22 (GMT)
commit6976104a36aa426bcf23b2e4b7e7a706f25beeeb (patch)
treeaff404b718a6a9fef4d205bf076862d5eee3c20e /Doc/library/bz2.rst
parent3e60a9d602c85b738dc74a3c8a196650822e8619 (diff)
downloadcpython-6976104a36aa426bcf23b2e4b7e7a706f25beeeb.zip
cpython-6976104a36aa426bcf23b2e4b7e7a706f25beeeb.tar.gz
cpython-6976104a36aa426bcf23b2e4b7e7a706f25beeeb.tar.bz2
#18430: Document that peek() may change the position of the underlying file for
the BZ2File, GzipFile and LZMAFile classes.
Diffstat (limited to 'Doc/library/bz2.rst')
-rw-r--r--Doc/library/bz2.rst5
1 files changed, 5 insertions, 0 deletions
diff --git a/Doc/library/bz2.rst b/Doc/library/bz2.rst
index 95a5abb..b79bccd 100644
--- a/Doc/library/bz2.rst
+++ b/Doc/library/bz2.rst
@@ -91,6 +91,11 @@ All of the classes in this module may safely be accessed from multiple threads.
byte of data will be returned (unless at EOF). The exact number of bytes
returned is unspecified.
+ .. note:: While calling :meth:`peek` does not change the file position of
+ the :class:`BZ2File`, it may change the position of the underlying file
+ object (e.g. if the :class:`BZ2File` was constructed by passing a file
+ object for *filename*).
+
.. versionadded:: 3.3
.. versionchanged:: 3.1