summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMark Summerfield <list@qtrac.plus.com>2007-11-05 14:38:50 (GMT)
committerMark Summerfield <list@qtrac.plus.com>2007-11-05 14:38:50 (GMT)
commit91f9429bc34aa8879fd65fcbcbe81b5e923fc8cb (patch)
treedfde01d928e99f31a726103a10a0a2cc000a9530
parentaea6e5913b66e9dfc8b9099a83b7becac7e74177 (diff)
downloadcpython-91f9429bc34aa8879fd65fcbcbe81b5e923fc8cb.zip
cpython-91f9429bc34aa8879fd65fcbcbe81b5e923fc8cb.tar.gz
cpython-91f9429bc34aa8879fd65fcbcbe81b5e923fc8cb.tar.bz2
Clarified the fact that you can have comments for individual archive
members even though comments to the archive itself aren't currently supported.
-rw-r--r--Doc/library/zipfile.rst12
1 files changed, 7 insertions, 5 deletions
diff --git a/Doc/library/zipfile.rst b/Doc/library/zipfile.rst
index 0fa741f..f2551d7 100644
--- a/Doc/library/zipfile.rst
+++ b/Doc/library/zipfile.rst
@@ -18,11 +18,13 @@ advanced use of this module will require an understanding of the format, as
defined in `PKZIP Application Note
<http://www.pkware.com/business_and_developers/developer/appnote/>`_.
-This module does not currently handle ZIP files which have appended comments, or
-multi-disk ZIP files. It can handle ZIP files that use the ZIP64 extensions
-(that is ZIP files that are more than 4 GByte in size). It supports decryption
-of encrypted files in ZIP archives, but it currently cannot create an encrypted
-file.
+This module does not currently handle multi-disk ZIP files, or ZIP files
+which have appended comments (although it correctly handles comments
+added to individual archive members---for which see the :ref:`zipinfo-objects`
+documentation). It can handle ZIP files that use the ZIP64 extensions
+(that is ZIP files that are more than 4 GByte in size). It supports
+decryption of encrypted files in ZIP archives, but it currently cannot
+create an encrypted file.
For other archive formats, see the :mod:`bz2`, :mod:`gzip`, and
:mod:`tarfile` modules.