python · miss-islington · Jul 22, 2022 · May 8, 2022 · May 9, 2022 · May 9, 2022
@@ -971,13 +971,13 @@ call fails (for example because the path doesn't exist).
    list of subdirectories is retrieved before the tuples for the directory and
    its subdirectories are walked.
 
-   When *top_down* is True, the caller can modify the *dirnames* list in-place
+   When *top_down* is ``True``, the caller can modify the *dirnames* list in-place
    (For example, using :keyword:`del` or slice assignment), and :meth:`Path.walk`
    will only recurse into the subdirectories whose names remain in *dirnames*;
    this can be used to prune the search, or to impose a specific order of visiting,
    or even to inform :meth:`Path.walk` about directories the caller creates or
    renames before it resumes :meth:`Path.walk` again. Modifying *dirnames* when
-   *top_down* is False has no effect on the behavior of :meth:`Path.walk()`, since the
+   *top_down* is ``False`` has no effect on the behavior of :meth:`Path.walk()`, since the
    directories in *dirnames* have already been generated by the time *dirnames*
    is yielded to the caller.
 
@@ -987,9 +987,10 @@ call fails (for example because the path doesn't exist).
    error to continue the walk or re-raise it to stop the walk. Note that the
    filename is available as the ``filename`` attribute of the exception object.
 
-   By default, :meth:`Path.walk` will not follow symbolic links that
-   resolve to directories.  Set *follow_symlinks* to ``True`` to visit directories
-   pointed to by symlinks (where supported).
+   By default, :meth:`Path.walk` does not follow symbolic links, and instead adds them
+   to the *filenames* list. Set *follow_symlinks* to ``True`` to resolve symlinks
+   and place them in *dirnames* and *filenames* as appropriate for their targets, and
+   consequently visit directories pointed to by symlinks (where supported).
 
    .. note::
 

@@ -1353,9 +1353,9 @@ def _walk(self, top_down, on_error, follow_symlinks):
         if top_down:
             yield self, dirnames, filenames
 
-        for dir_name in dirnames:
-            new_path = self._make_child_relpath(dir_name)
-            yield from new_path._walk(top_down, on_error, follow_symlinks)
+        for dirname in dirnames:
+            dirpath = self._make_child_relpath(dirname)
+            yield from dirpath._walk(top_down, on_error, follow_symlinks)
 
         if not top_down:
             yield self, dirnames, filenames