Update doc

zenoh-ext/src/advanced_cache.rs

@@ -36,6 +36,7 @@ kedefine!(
     pub(crate) ke_liveliness: "@adv/${zid:*}/${eid:*}/${meta:**}/@/${remaining:**}",
 );
 
+/// Configure replies QoS.
 #[derive(Clone, Debug)]
 pub struct QoS {
     priority: Priority,
@@ -104,7 +105,7 @@ impl CacheConfig {
     }
 }
 
-/// The builder of AdvancedCache, allowing to configure it.
+/// The builder of an [`AdvancedCache`], allowing to configure it.
 pub struct AdvancedCacheBuilder<'a, 'b, 'c> {
     session: &'a Session,
     pub_key_expr: ZResult<KeyExpr<'b>>,
@@ -187,6 +188,7 @@ fn sample_in_range(sample: &Sample, start: Option<u32>, end: Option<u32>) -> boo
     }
 }
 
+/// [`AdvancedCache`].
 pub struct AdvancedCache {
     cache: Arc<RwLock<VecDeque<Sample>>>,
     max_samples: usize,

zenoh-ext/src/advanced_publisher.rs

@@ -34,7 +34,7 @@ use zenoh::{
 use crate::advanced_cache::{AdvancedCache, AdvancedCacheBuilder, CacheConfig, KE_UHLC};
 
 #[derive(PartialEq)]
-pub enum Sequencing {
+pub(crate) enum Sequencing {
     None,
     Timestamp,
     SequenceNumber,
@@ -126,6 +126,7 @@ impl IntoFuture for AdvancedPublisherBuilder<'_, '_, '_> {
     }
 }
 
+/// [`AdvancedPublisher`].
 pub struct AdvancedPublisher<'a> {
     publisher: Publisher<'a>,
     seqnum: Option<AtomicU32>,

zenoh-ext/src/advanced_subscriber.rs

@@ -108,7 +108,7 @@ impl RecoveryConfig {
     }
 }
 
-/// The builder of AdvancedSubscriber, allowing to configure it.
+/// The builder of an [`AdvancedSubscriber`], allowing to configure it.
 #[zenoh_macros::unstable]
 pub struct AdvancedSubscriberBuilder<'a, 'b, 'c, Handler, const BACKGROUND: bool = false> {
     pub(crate) session: &'a Session,
@@ -373,6 +373,7 @@ struct SourceState<T> {
     pending_samples: BTreeMap<T, Sample>,
 }
 
+/// [`AdvancedSubscriber`].
 #[zenoh_macros::unstable]
 pub struct AdvancedSubscriber<Receiver> {
     statesref: Arc<Mutex<State>>,

zenoh-ext/src/lib.rs

@@ -41,7 +41,7 @@ pub use crate::serialization::{
 #[allow(deprecated)]
 pub use crate::{
     advanced_cache::{CacheConfig, QoS},
-    advanced_publisher::{AdvancedPublisher, AdvancedPublisherBuilder, Sequencing},
+    advanced_publisher::{AdvancedPublisher, AdvancedPublisherBuilder},
     advanced_subscriber::{
         AdvancedSubscriber, AdvancedSubscriberBuilder, HistoryConfig, RecoveryConfig,
     },

zenoh-ext/src/publication_cache.rs

@@ -159,6 +159,7 @@ impl IntoFuture for PublicationCacheBuilder<'_, '_, '_, true> {
     }
 }
 
+/// [`PublicationCache`].
 #[zenoh_macros::unstable]
 #[deprecated = "Use `AdvancedPublisher` and `AdvancedSubscriber` instead."]
 pub struct PublicationCache {

zenoh-ext/src/querying_subscriber.rs

@@ -1072,6 +1072,7 @@ where
     }))
 }
 
+/// [`ExtractSample`].
 #[zenoh_macros::unstable]
 #[deprecated = "Use `AdvancedPublisher` and `AdvancedSubscriber` instead."]
 #[allow(deprecated)]