diff options
| author | Martin v. Löwis <martin@v.loewis.de> | 2008-10-07 07:03:04 (GMT) |
|---|---|---|
| committer | Martin v. Löwis <martin@v.loewis.de> | 2008-10-07 07:03:04 (GMT) |
| commit | 651423c1eb91a7e5a0ff346d2f52a654b765344a (patch) | |
| tree | c075a3106993dbd399e009c179fdc0885328b49c /Doc/library/os.path.rst | |
| parent | a731b9929f6aeb55d484cf7b655e9c108e16f222 (diff) | |
| download | cpython-651423c1eb91a7e5a0ff346d2f52a654b765344a.zip cpython-651423c1eb91a7e5a0ff346d2f52a654b765344a.tar.gz cpython-651423c1eb91a7e5a0ff346d2f52a654b765344a.tar.bz2 | |
More bytes vs. strings documentation.
Diffstat (limited to 'Doc/library/os.path.rst')
| -rw-r--r-- | Doc/library/os.path.rst | 9 |
1 files changed, 8 insertions, 1 deletions
diff --git a/Doc/library/os.path.rst b/Doc/library/os.path.rst index 9bf5ae7..71eeb53 100644 --- a/Doc/library/os.path.rst +++ b/Doc/library/os.path.rst @@ -10,7 +10,14 @@ This module implements some useful functions on pathnames. To read or write files see :func:`open`, and for accessing the filesystem see the -:mod:`os` module. +:mod:`os` module. The path parameters can be passed as either strings, +or bytes. Applications are encouraged to represent file names as +(Unicode) character strings. Unfortunately, some file names may not be +representable as strings on Unix, so applications that need to support +arbitrary file names on Unix should use bytes objects to represent +path names. Vice versa, using bytes objects cannot represent all file +names on Windows (in the standard ``mbcs`` encoding), hence Windows +applications should use string objects to access all files. .. warning:: |