bpo-22062: Updated docstring and documentation for pathlib

[eivl]

Original patch by Mike Short

https://bugs.python.org/issue22062

[the-knights-who-say-ni]

Hello, and thanks for your contribution!

I'm a bot set up to make sure that the project can legally accept your contribution by verifying you have signed the PSF contributor agreement (CLA).

Unfortunately our records indicate you have not signed the CLA. For legal reasons we need you to sign this before we can look at your contribution. Please follow the steps outlined in the CPython devguide to rectify this issue.

When your account is ready, please add a comment in this pull request
and a Python core developer will remove the CLA not signed label
to make the bot check again.

You can check yourself
to see if the CLA has been received.

Thanks again for your contribution, we look forward to reviewing it!

[csabella]

@eivl Would you be able to apply the changes requested by @encukou? Thanks!

[eivl]

ofc, this has been totaly forgotten.... I will do it within tomorrow.. Den søn. 13. jan. 2019 kl. 02:33 skrev Cheryl Sabella < notifications@github.com>:

…

@eivl <https://github.com/eivl> Would you be able to apply the changes requested by @encukou <https://github.com/encukou>? Thanks! — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#8519 (comment)>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AAIFDKRrSrdYTvczUMNqgoFT0G-J5Qbxks5vCozqgaJpZM4VlAaV> .

[miss-islington]

Thanks @eivl for the PR 🌮🎉.. I'm working now to backport this PR to: 3.7.
🐍🍒⛏🤖

[bedevere-bot]

GH-11817 is a backport of this pull request to the 3.7 branch.