summaryrefslogtreecommitdiff
path: root/Doc/library/gzip.rst
diff options
context:
space:
mode:
authorNadeem Vawda <nadeem.vawda@gmail.com>2013-12-08 19:50:05 +0100
committerNadeem Vawda <nadeem.vawda@gmail.com>2013-12-08 19:50:05 +0100
commitbd6932a576e643c8aad8c0b4a044655882ebb27d (patch)
tree54fcabea19827b6b54785e45d5ee15e85dc12894 /Doc/library/gzip.rst
parentb12cb6a5509dbaafa05706dd64861bfef9fa42d7 (diff)
parent6976104a36aa426bcf23b2e4b7e7a706f25beeeb (diff)
downloadcpython-git-bd6932a576e643c8aad8c0b4a044655882ebb27d.tar.gz
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/gzip.rst')
-rw-r--r--Doc/library/gzip.rst5
1 files changed, 5 insertions, 0 deletions
diff --git a/Doc/library/gzip.rst b/Doc/library/gzip.rst
index de5063a7c7..78536fab51 100644
--- a/Doc/library/gzip.rst
+++ b/Doc/library/gzip.rst
@@ -117,6 +117,11 @@ The module defines the following items:
the call. The number of bytes returned may be more or less than
requested.
+ .. note:: While calling :meth:`peek` does not change the file position of
+ the :class:`GzipFile`, it may change the position of the underlying
+ file object (e.g. if the :class:`GzipFile` was constructed with the
+ *fileobj* parameter).
+
.. versionadded:: 3.2
.. versionchanged:: 3.1