diff -r d49cf0800c14 Doc/library/shutil.rst
--- a/Doc/library/shutil.rst	Mon Aug 22 09:46:56 2011 +0200
+++ b/Doc/library/shutil.rst	Mon Aug 22 11:23:57 2011 -0600
@@ -173,6 +173,10 @@
    used.  Otherwise, *src* is copied (using :func:`copy2`) to *dst* and then
    removed.
 
+   If *src* is a symlink, a new symlink is created in *dst*, pointed at the
+   same target, and *src* is removed. This effectively moves the link, not
+   its contents.
+
 .. function:: disk_usage(path)
 
    Return disk usage statistics about the given path as a :term:`named tuple`