[3.12] GH-120794: Use example paths with multiple parts in pathlib docs (GH-122887) (#122896)

GH-120794: Use example paths with multiple parts in pathlib docs (GH-122887)

In the documentation of `PosixPath` and `WindowsPath`, and their `Pure*`
equivalents, use example paths with multiple non-anchor parts.

(cherry picked from commit 363374cf69)

Co-authored-by: Barney Gale <barney.gale@gmail.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
This commit is contained in:
Miss Islington (bot) 2024-08-10 23:31:59 +02:00 committed by GitHub
parent d70c39905d
commit f5009b69e0
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -167,8 +167,8 @@ we also call *flavours*:
A subclass of :class:`PurePath`, this path flavour represents non-Windows
filesystem paths::
>>> PurePosixPath('/etc')
PurePosixPath('/etc')
>>> PurePosixPath('/etc/hosts')
PurePosixPath('/etc/hosts')
*pathsegments* is specified similarly to :class:`PurePath`.
@ -177,8 +177,8 @@ we also call *flavours*:
A subclass of :class:`PurePath`, this path flavour represents Windows
filesystem paths, including `UNC paths`_::
>>> PureWindowsPath('c:/Program Files/')
PureWindowsPath('c:/Program Files')
>>> PureWindowsPath('c:/', 'Users', 'Ximénez')
PureWindowsPath('c:/Users/Ximénez')
>>> PureWindowsPath('//server/share/file')
PureWindowsPath('//server/share/file')
@ -762,8 +762,8 @@ calls on path objects. There are three ways to instantiate concrete paths:
A subclass of :class:`Path` and :class:`PurePosixPath`, this class
represents concrete non-Windows filesystem paths::
>>> PosixPath('/etc')
PosixPath('/etc')
>>> PosixPath('/etc/hosts')
PosixPath('/etc/hosts')
*pathsegments* is specified similarly to :class:`PurePath`.
@ -772,8 +772,8 @@ calls on path objects. There are three ways to instantiate concrete paths:
A subclass of :class:`Path` and :class:`PureWindowsPath`, this class
represents concrete Windows filesystem paths::
>>> WindowsPath('c:/Program Files/')
WindowsPath('c:/Program Files')
>>> WindowsPath('c:/', 'Users', 'Ximénez')
WindowsPath('c:/Users/Ximénez')
*pathsegments* is specified similarly to :class:`PurePath`.