This issue is to keep track of the 'shutil' documentation update, since it seems to miss several information (in particular in comparison with the docstrings).

I'll post patches as soon as I get them.

“it seems to”: does this come from the mailing list?

nope, from a quick glance at the docstrings text and what's on the ReST documentation - was I a bit too catastrophic? :)

No, it’s just the wording that made me think you were referring to other reports or to posts.

Can you add links, a list of problems, dependency bugs or a patch?  Otherwise this is an empty placeholder.

I'm starting to work on a patch right now.

It turns out it was just move() with a slightly outdated description; so I take the occasion to fix some minor stuff in the doc.

-   If *symlinks* is true, symbolic links in the source tree are
+   If *symlinks* is ``True``, symbolic links in the source tree are

I’m not sure about that change.  It may be on purpose that lower-case true is used, given that the code will accept anything that evaluates to True in a boolean context, but does not strictly requires a bool instance.

See also #7969 for another shutil doc bug.

Yep. The parts changing true/false to ``True``/``False`` should not be committed.

I will commit the rest of the patch.

New changeset 836548ce4cd2 by Éric Araujo in branch '3.2':
Update documentation for shutil.move (#12043) and fix a few typos.
http://hg.python.org/cpython/rev/836548ce4cd2

New changeset 6bf168b55d07 by Éric Araujo in branch '2.7':
Update documentation for shutil.move (#12043) and fix a few typos.
http://hg.python.org/cpython/rev/6bf168b55d07

Done!