From: Georg Brandl <georg@python.org>
Date: Thu, 6 Apr 2006 10:03:36 +0000 (+0000)
Subject: Bug #1465600: note encoding issue in ZipFile.write().
X-Git-Tag: v2.4.4c1~282
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=bb898906b63350f387dec7fa894d9f7216c95e12;p=thirdparty%2FPython%2Fcpython.git

Bug #1465600: note encoding issue in ZipFile.write().
 (backport from rev. 43699)
---

diff --git a/Doc/lib/libzipfile.tex b/Doc/lib/libzipfile.tex
index a0b5e63be20b..4ba62fe52818 100644
--- a/Doc/lib/libzipfile.tex
+++ b/Doc/lib/libzipfile.tex
@@ -144,6 +144,15 @@ cat myzip.zip >> python.exe
   given for the \var{compression} parameter to the constructor for
   the new entry.  The archive must be open with mode \code{'w'} or
   \code{'a'}. 
+  
+  \note{There is no official file name encoding for ZIP files.
+  If you have unicode file names, please convert them to byte strings
+  in your desired encoding before passing them to \method{write()}.
+  WinZip interprets all file names as encoded in CP437, also known
+  as DOS Latin.}
+
+  \note{Archive names should be relative to the archive root, that is,
+        they should not start with a path separator.}
 \end{methoddesc}
 
 \begin{methoddesc}{writestr}{zinfo_or_arcname, bytes}