summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorNadeem Vawda <nadeem.vawda@gmail.com>2012-02-05 12:27:01 (GMT)
committerNadeem Vawda <nadeem.vawda@gmail.com>2012-02-05 12:27:01 (GMT)
commitd15c5a869dd64362941d127a7216495ead0802f7 (patch)
treeaf3521e2f9e90fbb2e9936a0f4e49f1bdfe28b5a /Doc
parent922ae2c931617c942dacaa2a78d72ba35d097db7 (diff)
downloadcpython-d15c5a869dd64362941d127a7216495ead0802f7.zip
cpython-d15c5a869dd64362941d127a7216495ead0802f7.tar.gz
cpython-d15c5a869dd64362941d127a7216495ead0802f7.tar.bz2
Clarify note in BZ2File docs about lack of multi-stream support (issue #1625).
Diffstat (limited to 'Doc')
-rw-r--r--Doc/library/bz2.rst7
1 files changed, 5 insertions, 2 deletions
diff --git a/Doc/library/bz2.rst b/Doc/library/bz2.rst
index 3ff227b..20dc765 100644
--- a/Doc/library/bz2.rst
+++ b/Doc/library/bz2.rst
@@ -72,8 +72,11 @@ Handling of compressed files is offered by the :class:`BZ2File` class.
This class does not support input files containing multiple streams (such
as those produced by the :program:`pbzip2` tool). When reading such an
input file, only the first stream will be accessible. If you require
- support for multi-stream files, consider using the third-party `bz2file
- module <http://pypi.python.org/pypi/bz2file>`_ instead of this class.
+ support for multi-stream files, consider using the third-party
+ :mod:`bz2file` module (available from
+ `PyPI <http://pypi.python.org/pypi/bz2file>`_). This module provides a
+ backport of Python 3.3's :class:`BZ2File` class, which does support
+ multi-stream files.
.. method:: close()