docs: clarify Path.suffix (GH-106650)
diff --git a/Doc/library/pathlib.rst b/Doc/library/pathlib.rst
index 3385754..af81df2 100644
--- a/Doc/library/pathlib.rst
+++ b/Doc/library/pathlib.rst
@@ -432,7 +432,7 @@
.. attribute:: PurePath.suffix
- The file extension of the final component, if any::
+ The last dot-separated portion of the final component, if any::
>>> PurePosixPath('my/library/setup.py').suffix
'.py'
@@ -441,10 +441,11 @@
>>> PurePosixPath('my/library').suffix
''
+ This is commonly called the file extension.
.. attribute:: PurePath.suffixes
- A list of the path's file extensions::
+ A list of the path's suffixes, often called file extensions::
>>> PurePosixPath('my/library.tar.gar').suffixes
['.tar', '.gar']
diff --git a/Doc/library/zipfile.rst b/Doc/library/zipfile.rst
index 45f3d34..bd951e4 100644
--- a/Doc/library/zipfile.rst
+++ b/Doc/library/zipfile.rst
@@ -577,7 +577,8 @@
.. data:: Path.suffix
- The file extension of the final component.
+ The last dot-separated portion of the final component, if any.
+ This is commonly called the file extension.
.. versionadded:: 3.11
Added :data:`Path.suffix` property.
@@ -591,7 +592,7 @@
.. data:: Path.suffixes
- A list of the path’s file extensions.
+ A list of the path’s suffixes, commonly called file extensions.
.. versionadded:: 3.11
Added :data:`Path.suffixes` property.
