[Python-checkins] Document Path.is_mount(), update Misc/ACKS and Misc/NEWS (#2980)

[Łukasz Langa]

https://github.com/python/cpython/commit/47320a652e872003f3dd3a9db4243067b09dd316
commit: 47320a652e872003f3dd3a9db4243067b09dd316
branch: master
author: Łukasz Langa <lukasz at langa.pl>
committer: GitHub <noreply at github.com>
date: 2017-08-01T16:47:50-07:00
summary:

Document Path.is_mount(), update Misc/ACKS and Misc/NEWS (#2980)

files:
A Misc/NEWS.d/next/Library/2017-08-01-15-56-50.bpo-30897.OuT1-Y.rst
M Doc/library/pathlib.rst
M Misc/ACKS

diff --git a/Doc/library/pathlib.rst b/Doc/library/pathlib.rst
index 0c9bd0d940a..3d28a1bea30 100644
--- a/Doc/library/pathlib.rst
+++ b/Doc/library/pathlib.rst
@@ -761,6 +761,18 @@ call fails (for example because the path doesn't exist):
    other errors (such as permission errors) are propagated.
 
 
+.. method:: Path.is_mount()
+
+   Return ``True`` if the path is a :dfn:`mount point`: a point in a
+   file system where a different file system has been mounted.  On POSIX, the
+   function checks whether *path*'s parent, :file:`path/..`, is on a different
+   device than *path*, or whether :file:`path/..` and *path* point to the same
+   i-node on the same device --- this should detect mount points for all Unix
+   and POSIX variants.  Not implemented on Windows.
+
+   .. versionadded:: 3.7
+
+
 .. method:: Path.is_symlink()
 
    Return ``True`` if the path points to a symbolic link, ``False`` otherwise.
diff --git a/Misc/ACKS b/Misc/ACKS
index e0640c114ff..f1f6c147f49 100644
--- a/Misc/ACKS
+++ b/Misc/ACKS
@@ -886,6 +886,7 @@ Inyeol Lee
 James Lee
 John J. Lee
 Thomas Lee
+Cooper Ry Lees
 Tennessee Leeuwenburg
 Luc Lefebvre
 Pierre Paul Lefebvre
diff --git a/Misc/NEWS.d/next/Library/2017-08-01-15-56-50.bpo-30897.OuT1-Y.rst b/Misc/NEWS.d/next/Library/2017-08-01-15-56-50.bpo-30897.OuT1-Y.rst
new file mode 100644
index 00000000000..41a75b805ae
--- /dev/null
+++ b/Misc/NEWS.d/next/Library/2017-08-01-15-56-50.bpo-30897.OuT1-Y.rst
@@ -0,0 +1,3 @@
+``pathlib.Path`` objects now include an ``is_mount()`` method (only
+implemented on POSIX).  This is similar to ``os.path.ismount(p)``. Patch by
+Cooper Ry Lees.