The docs indicate that "Alternately, you may use the mode kwarg to specify an exact mode, in the same vein as os.chmod or the Unix chmod command."
The docs should point out that a four-digit mode mask must be provided. Three-digit mask or letter mask (like u+x) are not allowed or yield the wrong result, whereas the chmod command does allow these
Sounds like maybe we want to just drop the "or the Unix chmod command" part, since os.chmod does seem to only accept the 4-digit numeric value. Sound good?
That's OK, though you might want to indicate that a 4-digit value is expected. Maybe with an example.
Changelog re #1325
Clarify put() docs re: mode arg, fixes #1325