diff --git a/src/libstd/fs.rs b/src/libstd/fs.rs
index e5f2fcbae83..a3f9f933bd9 100644
--- a/src/libstd/fs.rs
+++ b/src/libstd/fs.rs
@@ -854,6 +854,8 @@ pub fn rename<P: AsRef<Path>, Q: AsRef<Path>>(from: P, to: Q) -> io::Result<()>
 /// Note that if `from` and `to` both point to the same file, then the file
 /// will likely get truncated by this operation.
 ///
+/// On success, the total number of bytes copied is returned.
+///
 /// # Errors
 ///
 /// This function will return an error in the following situations, but is not