diff --git a/src/libstd/fs.rs b/src/libstd/fs.rs
index 62490bb9d08a..a903452d5407 100644
--- a/src/libstd/fs.rs
+++ b/src/libstd/fs.rs
@@ -855,6 +855,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