/// This function will not traverse symlinks if this entry points at a
/// symlink.
///
- /// # Platform behavior
+ /// # Platform-specific behavior
///
/// On Windows this function is cheap to call (no extra system calls
/// needed), but on Unix platforms this function is the equivalent of
/// This function will not traverse symlinks if this entry points at a
/// symlink.
///
- /// # Platform behavior
+ /// # Platform-specific behavior
///
/// On Windows and most Unix platforms this function is free (no extra
/// system calls needed), but some Unix platforms may require the equivalent
/// guarantee that the file is immediately deleted (e.g. depending on
/// platform, other open file descriptors may prevent immediate removal).
///
-/// # Platform behavior
+/// # Platform-specific behavior
///
/// This function currently corresponds to the `unlink` function on Unix
/// and the `DeleteFile` function on Windows.
/// Note that, this [may change in the future][changes].
-/// [changes]: https://github.com/rust-lang/rust/pull/28613
+/// [changes]: ../io/index.html#platform-specific-behavior
///
/// # Errors
///
/// This function will traverse symbolic links to query information about the
/// destination file.
///
-/// # Platform behavior
+/// # Platform-specific behavior
///
/// This function currently corresponds to the `stat` function on Unix
/// and the `GetFileAttributesEx` function on Windows.
/// Note that, this [may change in the future][changes].
-/// [changes]: https://github.com/rust-lang/rust/pull/28613
+/// [changes]: ../io/index.html#platform-specific-behavior
///
/// # Errors
///
/// Query the metadata about a file without following symlinks.
///
-/// # Platform behavior
+/// # Platform-specific behavior
///
/// This function currently corresponds to the `lstat` function on Unix
/// and the `GetFileAttributesEx` function on Windows.
/// Note that, this [may change in the future][changes].
-/// [changes]: https://github.com/rust-lang/rust/pull/28613
+/// [changes]: ../io/index.html#platform-specific-behavior
///
/// # Errors
///
///
/// This will not work if the new name is on a different mount point.
///
-/// # Platform behavior
+/// # Platform-specific behavior
///
/// This function currently corresponds to the `rename` function on Unix
/// and the `MoveFileEx` function with the `MOVEFILE_REPLACE_EXISTING` flag on Windows.
/// Note that, this [may change in the future][changes].
-/// [changes]: https://github.com/rust-lang/rust/pull/28613
+/// [changes]: ../io/index.html#platform-specific-behavior
///
/// # Errors
///
///
/// On success, the total number of bytes copied is returned.
///
-/// # Platform behavior
+/// # Platform-specific behavior
///
/// This function currently corresponds to the `open` function in Unix
/// with `O_RDONLY` for `from` and `O_WRONLY`, `O_CREAT`, and `O_TRUNC` for `to`.
/// `O_CLOEXEC` is set for returned file descriptors.
/// On Windows, this function currently corresponds to `CopyFileEx`.
/// Note that, this [may change in the future][changes].
-/// [changes]: https://github.com/rust-lang/rust/pull/28613
+/// [changes]: ../io/index.html#platform-specific-behavior
///
/// # Errors
///
/// The `dst` path will be a link pointing to the `src` path. Note that systems
/// often require these two paths to both be located on the same filesystem.
///
-/// # Platform behavior
+/// # Platform-specific behavior
///
/// This function currently corresponds to the `link` function on Unix
/// and the `CreateHardLink` function on Windows.
/// Note that, this [may change in the future][changes].
-/// [changes]: https://github.com/rust-lang/rust/pull/28613
+/// [changes]: ../io/index.html#platform-specific-behavior
///
/// # Errors
///
/// Reads a symbolic link, returning the file that the link points to.
///
-/// # Platform behavior
+/// # Platform-specific behavior
///
/// This function currently corresponds to the `readlink` function on Unix
/// and the `CreateFile` function with `FILE_FLAG_OPEN_REPARSE_POINT` and
/// `FILE_FLAG_BACKUP_SEMANTICS` flags on Windows.
/// Note that, this [may change in the future][changes].
-/// [changes]: https://github.com/rust-lang/rust/pull/28613
+/// [changes]: ../io/index.html#platform-specific-behavior
///
/// # Errors
///
/// Returns the canonical form of a path with all intermediate components
/// normalized and symbolic links resolved.
///
-/// # Platform behavior
+/// # Platform-specific behavior
///
/// This function currently corresponds to the `realpath` function on Unix
/// and the `CreateFile` and `GetFinalPathNameByHandle` functions on Windows.
/// Note that, this [may change in the future][changes].
-/// [changes]: https://github.com/rust-lang/rust/pull/28613
+/// [changes]: ../io/index.html#platform-specific-behavior
///
/// # Errors
///
/// Creates a new, empty directory at the provided path
///
-/// # Platform behavior
+/// # Platform-specific behavior
///
/// This function currently corresponds to the `mkdir` function on Unix
/// and the `CreateDirectory` function on Windows.
/// Note that, this [may change in the future][changes].
-/// [changes]: https://github.com/rust-lang/rust/pull/28613
+/// [changes]: ../io/index.html#platform-specific-behavior
///
/// # Errors
///
/// Recursively create a directory and all of its parent components if they
/// are missing.
///
-/// # Platform behavior
+/// # Platform-specific behavior
///
/// This function currently corresponds to the `mkdir` function on Unix
/// and the `CreateDirectory` function on Windows.
/// Note that, this [may change in the future][changes].
-/// [changes]: https://github.com/rust-lang/rust/pull/28613
+/// [changes]: ../io/index.html#platform-specific-behavior
///
/// # Errors
///
/// Removes an existing, empty directory.
///
-/// # Platform behavior
+/// # Platform-specific behavior
///
/// This function currently corresponds to the `rmdir` function on Unix
/// and the `RemoveDirectory` function on Windows.
/// Note that, this [may change in the future][changes].
-/// [changes]: https://github.com/rust-lang/rust/pull/28613
+/// [changes]: ../io/index.html#platform-specific-behavior
///
/// # Errors
///
/// This function does **not** follow symbolic links and it will simply remove the
/// symbolic link itself.
///
-/// # Platform behavior
+/// # Platform-specific behavior
///
/// This function currently corresponds to `opendir`, `lstat`, `rm` and `rmdir` functions on Unix
/// and the `FindFirstFile`, `GetFileAttributesEx`, `DeleteFile`, and `RemoveDirectory` functions
/// on Windows.
/// Note that, this [may change in the future][changes].
-/// [changes]: https://github.com/rust-lang/rust/pull/28613
+/// [changes]: ../io/index.html#platform-specific-behavior
///
/// # Errors
///
/// The iterator will yield instances of `io::Result<DirEntry>`. New errors may
/// be encountered after an iterator is initially constructed.
///
-/// # Platform behavior
+/// # Platform-specific behavior
///
/// This function currently corresponds to the `opendir` function on Unix
/// and the `FindFirstFile` function on Windows.
/// Note that, this [may change in the future][changes].
-/// [changes]: https://github.com/rust-lang/rust/pull/28613
+/// [changes]: ../io/index.html#platform-specific-behavior
///
/// # Errors
///
/// Changes the permissions found on a file or a directory.
///
-/// # Platform behavior
+/// # Platform-specific behavior
///
/// This function currently corresponds to the `chmod` function on Unix
/// and the `SetFileAttributes` function on Windows.
/// Note that, this [may change in the future][changes].
-/// [changes]: https://github.com/rust-lang/rust/pull/28613
+/// [changes]: ../io/index.html#platform-specific-behavior
///
/// # Errors
///