Kaydet (Commit) 7a4e2d17 authored tarafından Andrew Kuchling's avatar Andrew Kuchling

Wording changes to pathlib docs.

Only possibly-controversial change: joinpath() was described as:

  "Calling this method is equivalent to indexing the path with each of
  the *other* arguments in turn."

'Indexing' is an odd word to use, because you can't subscript Path or
PurePath objects, so I changed it to "combining".
üst e0d641ab
...@@ -20,7 +20,7 @@ The main point of entry is the :class:`Path` class, which will instantiate ...@@ -20,7 +20,7 @@ The main point of entry is the :class:`Path` class, which will instantiate
a :ref:`concrete path <concrete-paths>` for the current platform. a :ref:`concrete path <concrete-paths>` for the current platform.
.. note:: .. note::
This module module has been included in the standard library on a This module has been included in the standard library on a
:term:`provisional basis <provisional package>`. Backwards incompatible :term:`provisional basis <provisional package>`. Backwards incompatible
changes (up to and including removal of the package) may occur if deemed changes (up to and including removal of the package) may occur if deemed
necessary by the core developers. necessary by the core developers.
...@@ -250,7 +250,7 @@ property: ...@@ -250,7 +250,7 @@ property:
Methods and properties Methods and properties
^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^
Pure paths provide the following methods an properties: Pure paths provide the following methods and properties:
.. data:: PurePath.drive .. data:: PurePath.drive
...@@ -454,7 +454,7 @@ Pure paths provide the following methods an properties: ...@@ -454,7 +454,7 @@ Pure paths provide the following methods an properties:
.. method:: PurePath.joinpath(*other) .. method:: PurePath.joinpath(*other)
Calling this method is equivalent to indexing the path with each of Calling this method is equivalent to combining the path with each of
the *other* arguments in turn:: the *other* arguments in turn::
>>> PurePosixPath('/etc').joinpath('passwd') >>> PurePosixPath('/etc').joinpath('passwd')
...@@ -871,4 +871,3 @@ call fails (for example because the path doesn't exist): ...@@ -871,4 +871,3 @@ call fails (for example because the path doesn't exist):
Remove this file or symbolic link. If the path points to a directory, Remove this file or symbolic link. If the path points to a directory,
use :func:`Path.rmdir` instead. use :func:`Path.rmdir` instead.
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment