summaryrefslogtreecommitdiffstats
path: root/Doc/library/bz2.rst
diff options
context:
space:
mode:
authorNadeem Vawda <nadeem.vawda@gmail.com>2013-12-08 18:50:05 (GMT)
committerNadeem Vawda <nadeem.vawda@gmail.com>2013-12-08 18:50:05 (GMT)
commitbd6932a576e643c8aad8c0b4a044655882ebb27d (patch)
tree54fcabea19827b6b54785e45d5ee15e85dc12894 /Doc/library/bz2.rst
parentb12cb6a5509dbaafa05706dd64861bfef9fa42d7 (diff)
parent6976104a36aa426bcf23b2e4b7e7a706f25beeeb (diff)
downloadcpython-bd6932a576e643c8aad8c0b4a044655882ebb27d.zip
cpython-bd6932a576e643c8aad8c0b4a044655882ebb27d.tar.gz
cpython-bd6932a576e643c8aad8c0b4a044655882ebb27d.tar.bz2
Closes #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 9027a35..488cda5 100644
--- a/Doc/library/bz2.rst
+++ b/Doc/library/bz2.rst
@@ -95,6 +95,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