Warn that platform-specific behavior may change

This commit is contained in:
Martin Pool 2022-03-29 19:43:40 -07:00
parent 93e9f5e966
commit cfee2ed8cb
2 changed files with 5 additions and 1 deletions

View File

@ -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
///

View File

@ -45,6 +45,10 @@ use crate::mem::MaybeUninit;
/// 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