Add more doc(cfg(feature = "...")) hints.

Author: sunfishcode

src/io/is_read_write.rs

@@ -2,9 +2,7 @@
 //!
 //! [`is_read_write`]: https://docs.rs/rustix/*/rustix/io/fn.is_read_write.html
 
-#[cfg(all(feature = "fs", feature = "net"))]
 use crate::{backend, io};
-#[cfg(all(feature = "fs", feature = "net"))]
 use backend::fd::AsFd;
 
 /// Returns a pair of booleans indicating whether the file descriptor is
@@ -15,7 +13,6 @@ use backend::fd::AsFd;
 ///
 /// [`is_file_read_write`]: crate::fs::is_file_read_write
 #[inline]
-#[cfg(all(feature = "fs", feature = "net"))]
 #[cfg_attr(doc_cfg, doc(cfg(all(feature = "fs", feature = "net"))))]
 pub fn is_read_write<Fd: AsFd>(fd: Fd) -> io::Result<(bool, bool)> {
     backend::io::syscalls::is_read_write(fd.as_fd())

src/io/mod.rs

@@ -12,6 +12,7 @@ mod fcntl;
 pub(crate) mod fd;
 mod ioctl;
 #[cfg(not(any(windows, target_os = "redox")))]
+#[cfg(all(feature = "fs", feature = "net"))]
 mod is_read_write;
 #[cfg(bsd)]
 pub mod kqueue;
@@ -41,7 +42,7 @@ pub use fcntl::*;
 pub use ioctl::*;
 #[cfg(not(any(windows, target_os = "redox")))]
 #[cfg(all(feature = "fs", feature = "net"))]
-pub use is_read_write::is_read_write;
+pub use is_read_write::*;
 #[cfg(not(any(windows, target_os = "wasi")))]
 pub use pipe::*;
 pub use poll::{poll, PollFd, PollFlags};

src/path/dec_int.rs

@@ -25,10 +25,10 @@ use {core::fmt, std::ffi::OsStr, std::path::Path};
 /// # Example
 ///
 /// ```
-/// # #[cfg(feature = "path")]
+/// # #[cfg(any(feature = "fs", feature = "net"))]
 /// use rustix::path::DecInt;
 ///
-/// # #[cfg(feature = "path")]
+/// # #[cfg(any(feature = "fs", feature = "net"))]
 /// assert_eq!(
 ///     format!("hello {}", DecInt::new(9876).as_ref().display()),
 ///     "hello 9876"

src/path/mod.rs

@@ -6,6 +6,7 @@ mod dec_int;
 
 pub use arg::Arg;
 #[cfg(feature = "itoa")]
+#[cfg_attr(doc_cfg, doc(cfg(feature = "itoa")))]
 pub use dec_int::DecInt;
 
 pub(crate) const SMALL_PATH_BUFFER_SIZE: usize = 256;

src/process/umask.rs

@@ -13,9 +13,9 @@ use crate::fs::Mode;
 ///
 /// [POSIX]: https://pubs.opengroup.org/onlinepubs/9699919799/functions/umask.html
 /// [Linux]: https://man7.org/linux/man-pages/man2/umask.2.html
-#[inline]
-#[cfg_attr(doc_cfg, doc(cfg(feature = "fs")))]
 #[cfg(feature = "fs")]
+#[cfg_attr(doc_cfg, doc(cfg(feature = "fs")))]
+#[inline]
 pub fn umask(mask: Mode) -> Mode {
     backend::process::syscalls::umask(mask)
 }

src/time/mod.rs

@@ -2,12 +2,10 @@
 
 mod clock;
 #[cfg(any(linux_kernel, target_os = "fuchsia"))]
-#[cfg(feature = "time")]
 mod timerfd;
 
 // TODO: Convert WASI'S clock APIs to use handles rather than ambient clock
 // identifiers, update `wasi-libc`, and then add support in `rustix`.
 pub use clock::*;
 #[cfg(any(linux_kernel, target_os = "fuchsia"))]
-#[cfg(feature = "time")]
 pub use timerfd::*;