GH-120794: Use example paths with multiple parts in pathlib docs (#122887)
In the documentation of `PosixPath` and `WindowsPath`, and their `Pure*`
equivalents, use example paths with multiple non-anchor parts.
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
diff --git a/Doc/library/pathlib.rst b/Doc/library/pathlib.rst
index 3df446a..4a33935 100644
--- a/Doc/library/pathlib.rst
+++ b/Doc/library/pathlib.rst
@@ -178,8 +178,8 @@
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`.
@@ -188,8 +188,8 @@
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')
@@ -783,8 +783,8 @@
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`.
@@ -798,8 +798,8 @@
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`.