[MERGE] Minor docstring cleanups

[John Arbash Meinel]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Ian Clatworthy wrote:
| This patch corrects a minor error in a deprecation string I came across
| while doing a review yesterday. It also adds a base method/docstring for
| MutableTree.put_file_bytes_non_atomic based on information Robert and
| Martin provided on IRC.
|
| Ian C.
|

If you want a small addition, you can say that it is meant for callers that
already know the target path does not already exist. (Either because it is a
temporary path, or they already probed for a file and failed.) You certainly
wouldn't have to, but that might also be helpful to know.

The only times I'm aware of right now are when uploading a pack file (to a
unique temp path), pushing a knit file after finding out the target doesn't
exist, and lock files because they also go into a unique temp directory.

BB:approve

John
=:->
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (Cygwin)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iEYEARECAAYFAkgZ+50ACgkQJdeBCYSNAAMzngCgu1UT+MFUEzAEmxx3ZrK9/+Gz
ikAAniru2nG+J3XopHPWST/OwpVJQ2nZ
=9Jps
-----END PGP SIGNATURE-----