Warn that platform-specific behavior may change

diff --git a/library/std/src/fs.rs b/library/std/src/fs.rs
index 9daf694d68b78848b407bbf736044e79992a77e4..46acd0ee4c5958b1f42f189bb1a16f59b96f3402 100644 (file)
--- a/library/std/src/fs.rs
+++ b/library/std/src/fs.rs
@@ -1739,7 +1739,7 @@ pub fn rename<P: AsRef<Path>, Q: AsRef<Path>>(from: P, to: Q) -> io::Result<()>
 ///
 /// On MacOS, this function corresponds to `fclonefileat` and `fcopyfile`.
 ///
-/// Note that, this [may change in the future][changes].
+/// Note that platform-specific behavior [may change in the future][changes].
 ///
 /// [changes]: io#platform-specific-behavior
 ///

diff --git a/library/std/src/io/copy.rs b/library/std/src/io/copy.rs
index d446af0dad346326c04a6185f30c06ea6918e0b4..1a10245e4a5e397dea8ee28d23ac5b390cb53aca 100644 (file)
--- a/library/std/src/io/copy.rs
+++ b/library/std/src/io/copy.rs
@@ -45,6 +45,10 @@
 /// On Linux (including Android), this function uses `copy_file_range(2)`,
 /// `sendfile(2)` or `splice(2)` syscalls to move data directly between file
 /// descriptors if possible.
+///
+/// Note that platform-specific behavior [may change in the future][changes].
+///
+/// [changes]: crate::io#platform-specific-behavior
 #[stable(feature = "rust1", since = "1.0.0")]
 pub fn copy<R: ?Sized, W: ?Sized>(reader: &mut R, writer: &mut W) -> Result<u64>
 where