From bd5e38d4ccf7c83f36e576e85a2ac74cc69d7b38 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Martin=20v=2E=20L=C3=B6wis?= Date: Mon, 7 Oct 2002 18:52:29 +0000 Subject: Document PEP 277 changes. --- Doc/whatsnew/whatsnew23.tex | 34 ++++++++++++++++++++++++++++++---- 1 file changed, 30 insertions(+), 4 deletions(-) diff --git a/Doc/whatsnew/whatsnew23.tex b/Doc/whatsnew/whatsnew23.tex index aec2692..975079b 100644 --- a/Doc/whatsnew/whatsnew23.tex +++ b/Doc/whatsnew/whatsnew23.tex @@ -306,16 +306,42 @@ characters outside of the usual alphanumerics. \begin{seealso} \seepep{263}{Defining Python Source Code Encodings}{Written by -Marc-Andr\'e Lemburg and Martin von L\"owis; implemented by Martin von -L\"owis.} +Marc-Andr\'e Lemburg and Martin von L\"owis; implemented by SUZUKI +Hisao and Martin von L\"owis.} \end{seealso} %====================================================================== -\section{PEP 277: XXX} +\section{PEP 277: Unicode file name support for Windows NT} -XXX write this section +On Windows NT, 2000, and XP, the system stores file names as Unicode +strings. Traditionally, Python has represented file names are byte +strings, which is inadequate since it renders some file names +inaccessible. + +Python allows now to use arbitrary Unicode strings (within limitations +of the file system) for all functions that expect file names, in +particular \function{open}. If a Unicode string is passed to +\function{os.listdir}, Python returns now a list of Unicode strings. +A new function \function{getcwdu} returns the current directory as a +Unicode string. + +Byte strings continue to work as file names, the system will +transparently convert them to Unicode using the \code{mbcs} encoding. + +Other systems allow Unicode strings as file names as well, but convert +them to byte strings before passing them to the system, which may +cause UnicodeErrors. Applications can test whether arbitrary Unicode +strings are supported as file names with \code{os.path.unicode_file_names}. + +\begin{seealso} + +\seepep{277}{Unicode file name support for Windows NT}{Written by Neil +Hodgson; implemented by Neil Hodgson, Martin von L\"owis, and Mark +Hammond.} + +\end{seealso} %====================================================================== -- cgit v0.12