More comment tidying.

Author: sunfishcode

cap-async-std/src/fs/dir.rs

@@ -566,9 +566,10 @@ impl Dir {
 
     /// Checks if `path` is a directory.
     ///
-    /// This is similar to [`async_std::path::Path::is_dir`] in that it checks if `path` relative to
-    /// `Dir` is a directory. This function will traverse symbolic links to query information about
-    /// the destination file. In case of broken symbolic links, this will return `false`.
+    /// This is similar to [`async_std::path::Path::is_dir`] in that it checks
+    /// if `path` relative to `Dir` is a directory. This function will traverse
+    /// symbolic links to query information about the destination file. In case
+    /// of broken symbolic links, this will return `false`.
     #[inline]
     pub fn is_dir<P: AsRef<Path>>(&self, path: P) -> bool {
         self.metadata(path).map(|m| m.is_dir()).unwrap_or(false)

cap-async-std/src/fs/dir_entry.rs

@@ -77,7 +77,8 @@ impl DirEntry {
         self.inner.file_type()
     }
 
-    /// Returns the bare file name of this directory entry without any other leading path component.
+    /// Returns the bare file name of this directory entry without any other
+    /// leading path component.
     ///
     /// This corresponds to [`async_std::fs::DirEntry::file_name`].
     #[inline]

cap-async-std/src/fs_utf8/dir.rs

@@ -477,9 +477,10 @@ impl Dir {
 
     /// Checks if `path` is a directory.
     ///
-    /// This is similar to [`async_std::path::Path::is_dir`] in that it checks if `path` relative to
-    /// `Dir` is a directory. This function will traverse symbolic links to query information about
-    /// the destination file. In case of broken symbolic links, this will return `false`.
+    /// This is similar to [`async_std::path::Path::is_dir`] in that it checks
+    /// if `path` relative to `Dir` is a directory. This function will traverse
+    /// symbolic links to query information about the destination file. In case
+    /// of broken symbolic links, this will return `false`.
     #[inline]
     pub fn is_dir<P: AsRef<str>>(&self, path: P) -> bool {
         match from_utf8(path) {

cap-async-std/src/fs_utf8/dir_entry.rs

@@ -80,7 +80,8 @@ impl DirEntry {
         self.cap_std.file_type().await
     }
 
-    /// Returns the bare file name of this directory entry without any other leading path component.
+    /// Returns the bare file name of this directory entry without any other
+    /// leading path component.
     ///
     /// This corresponds to [`async_std::fs::DirEntry::file_name`].
     #[inline]

cap-fs-ext/src/open_options_follow_ext.rs

@@ -17,8 +17,8 @@ impl OpenOptionsFollowExt for cap_primitives::fs::OpenOptions {
     #[inline]
     fn follow(&mut self, follow: FollowSymlinks) -> &mut Self {
         // `follow` functionality is implemented within `cap_primitives`; we're
-        // just exposing it here since `OpenOptions` is re-exported by `cap_std`
-        // etc. and `follow` isn't in `std`.
+        // just exposing it here since `OpenOptions` is re-exported by
+        // `cap_std` etc. and `follow` isn't in `std`.
         unsafe { self._cap_fs_ext_follow(follow) }
     }
 }

cap-fs-ext/src/open_options_maybe_dir_ext.rs

@@ -12,9 +12,9 @@ pub trait OpenOptionsMaybeDirExt {
 impl OpenOptionsMaybeDirExt for cap_primitives::fs::OpenOptions {
     #[inline]
     fn maybe_dir(&mut self, maybe_dir: bool) -> &mut Self {
-        // `maybe_dir` functionality is implemented within `cap_primitives`; we're
-        // just exposing it here since `OpenOptions` is re-exported by `cap_std`
-        // etc. and `maybe_dir` isn't in `std`.
+        // `maybe_dir` functionality is implemented within `cap_primitives`;
+        // we're just exposing it here since `OpenOptions` is re-exported by
+        // `cap_std` etc. and `maybe_dir` isn't in `std`.
         unsafe { self._cap_fs_ext_maybe_dir(maybe_dir) }
     }
 }

cap-primitives/src/fs/dir_builder.rs

@@ -9,20 +9,20 @@ use std::fmt;
 /// creating directories requires a capability. Use [`Dir::create_dir_with`]
 /// instead.
 ///
-/// [`Dir::create_dir_with`]: https://doc.rust-lang.org/std/fs/struct.Dir.html#method.create_dir_with
+/// [`Dir::create_dir_with`]: https://docs.rs/cap-std/latest/cap_std/fs/struct.Dir.html#method.create_dir_with
 ///
 /// <details>
-/// We need to define our own version because the libstd `DirBuilder` doesn't have
-/// public accessors that we can use.
+/// We need to define our own version because the libstd `DirBuilder` doesn't
+/// have public accessors that we can use.
 /// </details>
 pub struct DirBuilder {
     pub(crate) recursive: bool,
     pub(crate) options: DirOptions,
 }
 
 impl DirBuilder {
-    /// Creates a new set of options with default mode/security settings for all platforms and also
-    /// non-recursive.
+    /// Creates a new set of options with default mode/security settings for
+    /// all platforms and also non-recursive.
     ///
     /// This corresponds to [`std::fs::DirBuilder::new`].
     #[allow(clippy::new_without_default)]

cap-primitives/src/fs/dir_entry.rs

@@ -87,7 +87,8 @@ impl DirEntry {
         self.inner.file_type()
     }
 
-    /// Returns the bare file name of this directory entry without any other leading path component.
+    /// Returns the bare file name of this directory entry without any other
+    /// leading path component.
     ///
     /// This corresponds to [`std::fs::DirEntry::file_name`].
     #[inline]

cap-primitives/src/fs/manually/canonical_path.rs

@@ -47,7 +47,8 @@ impl<'path_buf> CanonicalPath<'path_buf> {
     /// The complete canonical path has been scanned. Set `path` to `None`
     /// so that it isn't cleared when `self` is dropped.
     pub(super) fn complete(&mut self) {
-        // Replace "" with ".", since "" as a relative path is interpreted as an error.
+        // Replace "" with ".", since "" as a relative path is interpreted as
+        // an error.
         if let Some(path) = &mut self.path {
             if path.as_os_str().is_empty() {
                 path.push(Component::CurDir);
@@ -60,9 +61,9 @@ impl<'path_buf> CanonicalPath<'path_buf> {
 impl<'path_buf> Drop for CanonicalPath<'path_buf> {
     fn drop(&mut self) {
         // If `self.path` is still `Some` here, it means that we haven't called
-        // `complete()` yet, meaning the `CanonicalPath` is being dropped before
-        // the complete path has been processed. In that case, clear `path` to
-        // indicate that we weren't able to obtain a complete path.
+        // `complete()` yet, meaning the `CanonicalPath` is being dropped
+        // before the complete path has been processed. In that case, clear
+        // `path` to indicate that we weren't able to obtain a complete path.
         if let Some(path) = &mut self.path {
             path.clear();
             self.path = None;

cap-primitives/src/fs/manually/canonicalize.rs

@@ -8,14 +8,15 @@ use std::{
     path::{Path, PathBuf},
 };
 
-/// Implement `canonicalize` by breaking up the path into components and resolving
-/// each component individually, and resolving symbolic links manually.
+/// Implement `canonicalize` by breaking up the path into components and
+/// resolving each component individually, and resolving symbolic links
+/// manually.
 pub(crate) fn canonicalize(start: &fs::File, path: &Path) -> io::Result<PathBuf> {
     canonicalize_with(start, path, FollowSymlinks::Yes)
 }
 
-/// The main body of `canonicalize`, which takes an extra `follow` flag allowing
-/// the caller to disable following symlinks in the last component.
+/// The main body of `canonicalize`, which takes an extra `follow` flag
+/// allowing the caller to disable following symlinks in the last component.
 pub(crate) fn canonicalize_with(
     start: &fs::File,
     path: &Path,