fix: Resolve Nightly Rustdoc errors and warnings (#792)

commons/zenoh-buffers/src/bbuf.rs

@@ -18,9 +18,12 @@ use crate::{
     writer::{BacktrackableWriter, DidntWrite, HasWriter, Writer},
     ZSlice,
 };
-use alloc::{boxed::Box, sync::Arc};
+use alloc::sync::Arc;
 use core::{fmt, num::NonZeroUsize, option};
 
+#[cfg(not(feature = "std"))]
+use alloc::boxed::Box;
+
 #[derive(Clone, PartialEq, Eq)]
 pub struct BBuf {
     buffer: Box<[u8]>,

commons/zenoh-buffers/src/vec.rs

@@ -16,9 +16,11 @@ use crate::{
     reader::HasReader,
     writer::{BacktrackableWriter, DidntWrite, HasWriter, Writer},
 };
-use alloc::vec::Vec;
 use core::{mem, num::NonZeroUsize, option};
 
+#[cfg(not(feature = "std"))]
+use alloc::vec::Vec;
+
 /// Allocate a vector with a given capacity and sets the length to that capacity.
 #[must_use]
 pub fn uninit(capacity: usize) -> Vec<u8> {

commons/zenoh-collections/src/properties.rs

@@ -13,7 +13,6 @@
 //
 use std::{
     collections::HashMap,
-    convert::{From, TryFrom},
     fmt,
     ops::{Deref, DerefMut},
 };

commons/zenoh-collections/src/single_or_vec.rs

@@ -12,14 +12,17 @@
 //   ZettaScale Zenoh Team, <[email protected]>
 //
 
-use alloc::{vec, vec::Vec};
+use alloc::vec;
 use core::{
     cmp::PartialEq,
     fmt, iter,
     ops::{Index, IndexMut, RangeBounds},
     ptr, slice,
 };
 
+#[cfg(not(feature = "std"))]
+use alloc::vec::Vec;
+
 #[derive(Clone, Eq)]
 enum SingleOrVecInner<T> {
     Single(T),

commons/zenoh-result/src/lib.rs

@@ -20,7 +20,6 @@
 #![cfg_attr(not(feature = "std"), no_std)]
 extern crate alloc;
 
-use alloc::boxed::Box;
 use anyhow::Error as AnyError;
 use core::fmt;
 
@@ -39,6 +38,8 @@ pub const fn unlikely(b: bool) -> bool {
     b
 }
 
+#[cfg(not(feature = "std"))]
+use alloc::boxed::Box;
 #[cfg(not(feature = "std"))]
 use core::any::Any;
 

zenoh/src/info.rs

@@ -149,7 +149,7 @@ impl<'a> AsyncResolve for PeersZidBuilder<'a> {
     }
 }
 
-/// Struct returned by [`Session::info()`](crate::Session::info) which allows
+/// Struct returned by [`Session::info()`](crate::SessionDeclarations::info) which allows
 /// to access informations about the current zenoh [`Session`](crate::Session).
 ///
 /// # Examples

zenoh/src/key_expr.rs

@@ -22,8 +22,8 @@
 //! # Storing Key Expressions
 //! This module provides 3 flavours to store strings that have been validated to respect the KE syntax:
 //! - [`keyexpr`] is the equivalent of a [`str`],
-//! - [`OwnedKeyExpr`] works like an [`Arc<str>`],
-//! - [`KeyExpr`] works like a [`Cow<str>`], but also stores some additional context internal to Zenoh to optimize
+//! - [`OwnedKeyExpr`] works like an [`std::sync::Arc<str>`],
+//! - [`KeyExpr`] works like a [`std::borrow::Cow<str>`], but also stores some additional context internal to Zenoh to optimize
 //! routing and network usage.
 //!
 //! All of these types [`Deref`](core::ops::Deref) to [`keyexpr`], which notably has methods to check whether a given [`keyexpr::intersects`] with another,

zenoh/src/plugins/sealed.rs

@@ -94,7 +94,7 @@ pub trait RunningPluginTrait: Send + Sync + PluginControl {
     /// Parameters:
     /// * `selector`: the full selector of the query (usually only key_expr part is used). This selector is
     /// exactly the same as it was requested by user, for example "@/router/ROUTER_ID/plugins/PLUGIN_NAME/some/plugin/info" or "@/router/*/plugins/*/foo/bar".
-    /// But the plugin's [adminspace_getter] is called only if the selector matches the [plugin_status_key]
+    /// But the plugin's [RunningPluginTrait::adminspace_getter] is called only if the selector matches the `plugin_status_key`
     /// * `plugin_status_key`: the actual path to plugin's status in the admin space. For example "@/router/ROUTER_ID/plugins/PLUGIN_NAME"
     /// Returns value:
     /// * `Ok(Vec<Response>)`: the list of responses to the query. For example if plugins can return information on subleys "foo", "bar", "foo/buzz" and "bar/buzz"

zenoh/src/subscriber.rs

@@ -51,7 +51,7 @@ impl fmt::Debug for SubscriberState {
 /// A subscriber that provides data through a callback.
 ///
 /// CallbackSubscribers can be created from a zenoh [`Session`](crate::Session)
-/// with the [`declare_subscriber`](crate::Session::declare_subscriber) function
+/// with the [`declare_subscriber`](crate::SessionDeclarations::declare_subscriber) function
 /// and the [`callback`](SubscriberBuilder::callback) function
 /// of the resulting builder.
 ///
@@ -83,7 +83,7 @@ pub(crate) struct SubscriberInner<'a> {
 /// CallbackPullSubscribers only provide data when explicitely pulled by the
 /// application with the [`pull`](CallbackPullSubscriber::pull) function.
 /// CallbackPullSubscribers can be created from a zenoh [`Session`](crate::Session)
-/// with the [`declare_subscriber`](crate::Session::declare_subscriber) function,
+/// with the [`declare_subscriber`](crate::SessionDeclarations::declare_subscriber) function,
 /// the [`callback`](SubscriberBuilder::callback) function
 /// and the [`pull_mode`](SubscriberBuilder::pull_mode) function
 /// of the resulting builder.
@@ -628,7 +628,7 @@ where
 /// A subscriber that provides data through a [`Handler`](crate::prelude::IntoCallbackReceiverPair).
 ///
 /// Subscribers can be created from a zenoh [`Session`](crate::Session)
-/// with the [`declare_subscriber`](crate::Session::declare_subscriber) function
+/// with the [`declare_subscriber`](crate::SessionDeclarations::declare_subscriber) function
 /// and the [`with`](SubscriberBuilder::with) function
 /// of the resulting builder.
 ///
@@ -663,7 +663,7 @@ pub struct Subscriber<'a, Receiver> {
 /// PullSubscribers only provide data when explicitely pulled by the
 /// application with the [`pull`](PullSubscriber::pull) function.
 /// PullSubscribers can be created from a zenoh [`Session`](crate::Session)
-/// with the [`declare_subscriber`](crate::Session::declare_subscriber) function,
+/// with the [`declare_subscriber`](crate::SessionDeclarations::declare_subscriber) function,
 /// the [`with`](SubscriberBuilder::with) function
 /// and the [`pull_mode`](SubscriberBuilder::pull_mode) function
 /// of the resulting builder.