chore: Try to fix docs.rs docs generation

- fix some links
- replace doc_auto_cfg with doc_cfg as instructed by the failed docs.rs run

[INFO] [stderr] 253 | #![cfg_attr(iroh_docsrs, feature(doc_auto_cfg))]
[INFO] [stderr]     |                                  ^^^^^^^^^^^^ feature has been removed
[INFO] [stderr]     |
[INFO] [stderr]     = note: removed in CURRENT_RUSTC_VERSION; see <rust-lang/rust#138907> for more information
[INFO] [stderr]     = note: merged into `doc_cfg`

Author: rklaehn

Cargo.toml

@@ -34,7 +34,7 @@ missing_debug_implementations = "warn"
 # feature in any dependencies, because some indirect dependencies
 # require a feature enabled when using `--cfg docsrs` which we can not
 # do.  To enable for a crate set `#![cfg_attr(iroh_docsrs,
-# feature(doc_auto_cfg))]` in the crate.
+# feature(doc_cfg))]` in the crate.
 # We also have our own `iroh_loom` cfg to enable tokio-rs/loom testing.
 unexpected_cfgs = { level = "warn", check-cfg = ["cfg(iroh_docsrs)", "cfg(iroh_loom)"] }
 

iroh-base/src/lib.rs

@@ -1,5 +1,5 @@
 //! Base types and utilities for Iroh
-#![cfg_attr(iroh_docsrs, feature(doc_auto_cfg))]
+#![cfg_attr(iroh_docsrs, feature(doc_cfg))]
 #![deny(missing_docs, rustdoc::broken_intra_doc_links)]
 #![cfg_attr(not(test), deny(clippy::unwrap_used))]
 

iroh-base/src/ticket/node.rs

@@ -27,6 +27,7 @@ use crate::{
 /// [`NodeId`]: crate::key::NodeId
 /// [`Display`]: std::fmt::Display
 /// [`FromStr`]: std::str::FromStr
+/// ['RelayUrl`]: crate::relay_url::RelayUrl
 #[derive(Debug, Clone, PartialEq, Eq, derive_more::Display)]
 #[display("{}", Ticket::serialize(self))]
 pub struct NodeTicket {

iroh-relay/src/lib.rs

@@ -26,7 +26,7 @@
 //!   QAD support and expose metrics.
 // Based on tailscale/derp/derp.go
 
-#![cfg_attr(iroh_docsrs, feature(doc_auto_cfg))]
+#![cfg_attr(iroh_docsrs, feature(doc_cfg))]
 #![deny(missing_docs, rustdoc::broken_intra_doc_links)]
 #![cfg_attr(not(test), deny(clippy::unwrap_used))]
 

iroh-relay/src/node_info.rs

@@ -89,12 +89,12 @@ pub enum DecodingError {
 pub trait NodeIdExt {
     /// Encodes a [`NodeId`] in [`z-base-32`] encoding.
     ///
-    /// [z-base-32]: https://philzimmermann.com/docs/human-oriented-base-32-encoding.txt
+    /// [`z-base-32`]: https://philzimmermann.com/docs/human-oriented-base-32-encoding.txt
     fn to_z32(&self) -> String;
 
     /// Parses a [`NodeId`] from [`z-base-32`] encoding.
     ///
-    /// [z-base-32]: https://philzimmermann.com/docs/human-oriented-base-32-encoding.txt
+    /// [`z-base-32`]: https://philzimmermann.com/docs/human-oriented-base-32-encoding.txt
     fn from_z32(s: &str) -> Result<NodeId, DecodingError>;
 }
 

iroh/src/discovery/dns.rs

@@ -32,7 +32,7 @@ pub(crate) const DNS_STAGGERING_MS: &[u64] = &[200, 300];
 /// The DNS resolver defaults to using the nameservers configured on the host system, but can be changed
 /// with [`crate::endpoint::Builder::dns_resolver`].
 ///
-/// [z-base-32]: https://philzimmermann.com/docs/human-oriented-base-32-encoding.txt
+/// [`z-base-32`]: https://philzimmermann.com/docs/human-oriented-base-32-encoding.txt
 /// [`Endpoint`]: crate::Endpoint
 #[derive(Debug)]
 pub struct DnsDiscovery {

iroh/src/lib.rs

@@ -250,7 +250,7 @@
 #![deny(missing_docs, rustdoc::broken_intra_doc_links)]
 #![cfg_attr(wasm_browser, allow(unused))]
 #![cfg_attr(not(test), deny(clippy::unwrap_used))]
-#![cfg_attr(iroh_docsrs, feature(doc_auto_cfg))]
+#![cfg_attr(iroh_docsrs, feature(doc_cfg))]
 
 mod disco;
 mod key;

iroh/src/net_report.rs

@@ -5,7 +5,7 @@
 //! etc and reachability to the configured relays.
 // Based on <https://github.com/tailscale/tailscale/blob/main/net/netcheck/netcheck.go>
 
-#![cfg_attr(iroh_docsrs, feature(doc_auto_cfg))]
+#![cfg_attr(iroh_docsrs, feature(doc_cfg))]
 #![deny(missing_docs, rustdoc::broken_intra_doc_links)]
 #![cfg_attr(not(test), deny(clippy::unwrap_used))]
 #![cfg_attr(wasm_browser, allow(unused))]