mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-08-04 17:08:35 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 13

Merged revisions 72009 via svnmerge from

Browse source 
svn+ssh://pythondev@svn.python.org/python/trunk

........
  r72009 | georg.brandl | 2009-04-27 17:29:09 +0200 (Mo, 27 Apr 2009) | 3 lines

  Demote warnings to notices where appropriate, following the goal that as few "red box" warnings
  should clutter the docs as possible.  Part 1: stuff that gets merged to Py3k.
........
This commit is contained in:
Georg Brandl 2009-04-27 16:20:50 +00:00
parent c67d362a89
commit e720c0aa74
21 changed files with 65 additions and 40 deletions
Download patch file Download diff file Expand all files Collapse all files

30
Doc/library/os.path.rst
View file

@ -23,12 +23,11 @@ applications should use string objects to access all files.
their parameters. The result is an object of the same type, if a path or
file name is returned.
.. warning::
.. note::
On Windows, many of these functions do not properly support UNC pathnames.
:func:`splitunc` and :func:`ismount` do handle them correctly.
.. note::
Since different operating systems have different path name conventions, there
@ -288,6 +287,33 @@ applications should use string objects to access all files.
*unc* will always be the empty string. Availability: Windows.
<<<<<<< .working
=======
.. function:: walk(path, visit, arg)
Calls the function *visit* with arguments ``(arg, dirname, names)`` for each
directory in the directory tree rooted at *path* (including *path* itself, if it
is a directory). The argument *dirname* specifies the visited directory, the
argument *names* lists the files in the directory (gotten from
``os.listdir(dirname)``). The *visit* function may modify *names* to influence
the set of directories visited below *dirname*, e.g. to avoid visiting certain
parts of the tree. (The object referred to by *names* must be modified in
place, using :keyword:`del` or slice assignment.)
.. note::
Symbolic links to directories are not treated as subdirectories, and that
:func:`walk` therefore will not visit them. To visit linked directories you must
identify them with ``os.path.islink(file)`` and ``os.path.isdir(file)``, and
invoke :func:`walk` as necessary.
.. note::
This function is deprecated and has been removed in 3.0 in favor of
:func:`os.walk`.
>>>>>>> .merge-right.r72009
.. data:: supports_unicode_filenames
True if arbitrary Unicode strings can be used as file names (within limitations