From 0717b4d9b3899c5c2ca13031e4ff619a15a4d368 Mon Sep 17 00:00:00 2001
From: Kyle Stanley <aeros167@gmail.com>
Date: Sat, 6 Jul 2019 21:20:15 -0400
Subject: [PATCH] bpo-37478: Specify possible exceptions for os.chdir()
 (GH-14611)

---
 Doc/library/os.rst                                             | 3 +++
 .../Documentation/2019-07-06-00-57-27.bpo-37478.B0ioLw.rst     | 1 +
 2 files changed, 4 insertions(+)
 create mode 100644 Misc/NEWS.d/next/Documentation/2019-07-06-00-57-27.bpo-37478.B0ioLw.rst

diff --git a/Doc/library/os.rst b/Doc/library/os.rst
index 6e8df88cf05..760c05c6e52 100644
--- a/Doc/library/os.rst
+++ b/Doc/library/os.rst
@@ -1599,6 +1599,9 @@ features:
    This function can support :ref:`specifying a file descriptor <path_fd>`.  The
    descriptor must refer to an opened directory, not an open file.
 
+   This function can raise :exc:`OSError` subclasses such as
+   :exc:`FileNotFoundError`, :exc:`PermissionError`, and :exc:`NotADirectoryError`.
+
    .. versionadded:: 3.3
       Added support for specifying *path* as a file descriptor
       on some platforms.
diff --git a/Misc/NEWS.d/next/Documentation/2019-07-06-00-57-27.bpo-37478.B0ioLw.rst b/Misc/NEWS.d/next/Documentation/2019-07-06-00-57-27.bpo-37478.B0ioLw.rst
new file mode 100644
index 00000000000..55b13662176
--- /dev/null
+++ b/Misc/NEWS.d/next/Documentation/2019-07-06-00-57-27.bpo-37478.B0ioLw.rst
@@ -0,0 +1 @@
+Added possible exceptions to the description of os.chdir().
\ No newline at end of file