#2369: clarify that copyfile() doesn't take a target directory.
diff --git a/Doc/library/shutil.rst b/Doc/library/shutil.rst
index 267435e..f28fbac 100644
--- a/Doc/library/shutil.rst
+++ b/Doc/library/shutil.rst
@@ -28,15 +28,6 @@
are not copied.
-.. function:: copyfile(src, dst)
-
- Copy the contents (no metadata) of the file named *src* to a file named *dst*.
- The destination location must be writable; otherwise, an :exc:`IOError` exception
- will be raised. If *dst* already exists, it will be replaced. Special files
- such as character or block devices and pipes cannot be copied with this
- function. *src* and *dst* are path names given as strings.
-
-
.. function:: copyfileobj(fsrc, fdst[, length])
Copy the contents of the file-like object *fsrc* to the file-like object *fdst*.
@@ -48,6 +39,17 @@
be copied.
+.. function:: copyfile(src, dst)
+
+ Copy the contents (no metadata) of the file named *src* to a file named *dst*.
+ *dst* must be the complete target file name; look at :func:`copy` for a copy that
+ accepts a target directory path.
+ The destination location must be writable; otherwise, an :exc:`IOError` exception
+ will be raised. If *dst* already exists, it will be replaced. Special files
+ such as character or block devices and pipes cannot be copied with this
+ function. *src* and *dst* are path names given as strings.
+
+
.. function:: copymode(src, dst)
Copy the permission bits from *src* to *dst*. The file contents, owner, and