@@ -1121,7 +1121,9 @@ impl Permissions {
11211121 /// writing.
11221122 ///
11231123 /// This operation does **not** modify the filesystem. To modify the
1124- /// filesystem use the `fs::set_permissions` function.
1124+ /// filesystem use the [`fs::set_permissions`] function.
1125+ ///
1126+ /// [`fs::set_permissions`]: fn.set_permissions.html
11251127 ///
11261128 /// # Examples
11271129 ///
@@ -1639,10 +1641,15 @@ pub fn hard_link<P: AsRef<Path>, Q: AsRef<Path>>(src: P, dst: Q) -> io::Result<(
16391641///
16401642/// The `dst` path will be a symbolic link pointing to the `src` path.
16411643/// On Windows, this will be a file symlink, not a directory symlink;
1642- /// for this reason, the platform-specific `std::os::unix::fs::symlink`
1643- /// and `std::os::windows::fs::{ symlink_file, symlink_dir}` should be
1644+ /// for this reason, the platform-specific [ `std::os::unix::fs::symlink`]
1645+ /// and [ `std::os::windows::fs::symlink_file`] or [` symlink_dir`] should be
16441646/// used instead to make the intent explicit.
16451647///
1648+ /// [`std::os::unix::fs::symlink`]: ../os/unix/fs/fn.symlink.html
1649+ /// [`std::os::windows::fs::symlink_file`]: ../os/windows/fs/fn.symlink_file.html
1650+ /// [`symlink_dir`]: ../os/windows/fs/fn.symlink_dir.html
1651+ ///
1652+ ///
16461653/// # Examples
16471654///
16481655/// ```no_run
@@ -1795,14 +1802,16 @@ pub fn create_dir<P: AsRef<Path>>(path: P) -> io::Result<()> {
17951802/// * If any directory in the path specified by `path`
17961803/// does not already exist and it could not be created otherwise. The specific
17971804/// error conditions for when a directory is being created (after it is
1798- /// determined to not exist) are outlined by `fs::create_dir`.
1805+ /// determined to not exist) are outlined by [ `fs::create_dir`] .
17991806///
18001807/// Notable exception is made for situations where any of the directories
18011808/// specified in the `path` could not be created as it was being created concurrently.
18021809/// Such cases are considered to be successful. That is, calling `create_dir_all`
18031810/// concurrently from multiple threads or processes is guaranteed not to fail
18041811/// due to a race condition with itself.
18051812///
1813+ /// [`fs::create_dir`]: fn.create_dir.html
1814+ ///
18061815/// # Examples
18071816///
18081817/// ```no_run
@@ -1868,7 +1877,10 @@ pub fn remove_dir<P: AsRef<Path>>(path: P) -> io::Result<()> {
18681877///
18691878/// # Errors
18701879///
1871- /// See `file::remove_file` and `fs::remove_dir`.
1880+ /// See [`fs::remove_file`] and [`fs::remove_dir`].
1881+ ///
1882+ /// [`fs::remove_file`]: fn.remove_file.html
1883+ /// [`fs::remove_dir`]: fn.remove_dir.html
18721884///
18731885/// # Examples
18741886///
0 commit comments