[Python-checkins] r58857 - python/trunk/Doc/library/zipfile.rst

[mark.summerfield]

Author: mark.summerfield
Date: Mon Nov  5 15:38:50 2007
New Revision: 58857

Modified:
   python/trunk/Doc/library/zipfile.rst
Log:
Clarified the fact that you can have comments for individual archive
members even though comments to the archive itself aren't currently
supported.



Modified: python/trunk/Doc/library/zipfile.rst
==============================================================================
--- python/trunk/Doc/library/zipfile.rst	(original)
+++ python/trunk/Doc/library/zipfile.rst	Mon Nov  5 15:38:50 2007
@@ -18,11 +18,13 @@
 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.