Fix closes Issue12183 - Explain the Symlink copy behavior in shutil.copytree. Patch...

diff --git a/Doc/library/shutil.rst b/Doc/library/shutil.rst
index 5e5f8c94bb49a196a2df440d0d8b9cb01656e684..a785682c0f0123f737f0e3d59198ce0d77d8c6d9 100644 (file)
--- a/Doc/library/shutil.rst
+++ b/Doc/library/shutil.rst
@@ -101,8 +101,9 @@ Directory and files operations
    :func:`copy2`.
 
    If *symlinks* is true, symbolic links in the source tree are represented as
-   symbolic links in the new tree; if false or omitted, the contents of the
-   linked files are copied to the new tree.
+   symbolic links in the new tree, but the metadata of the original links is NOT
+   copied; if false or omitted, the contents and metadata of the linked files
+   are copied to the new tree.
 
    When *symlinks* is false, if the file pointed by the symlink doesn't
    exist, a exception will be added in the list of errors raised in