#6677: note that rmdir only removes empty directories.
diff --git a/Doc/library/os.rst b/Doc/library/os.rst
index cab2522..4cc6d4f 100644
--- a/Doc/library/os.rst
+++ b/Doc/library/os.rst
@@ -1121,7 +1121,10 @@
.. function:: rmdir(path)
- Remove the directory *path*. Availability: Unix, Windows.
+ Remove (delete) the directory *path*. Only works when the directory is
+ empty, otherwise, :exc:`OSError` is raised. In order to remove whole
+ directory trees, :func:`shutil.rmtree` can be used. Availability: Unix,
+ Windows.
.. function:: stat(path)