Get rid of doc links to private structs

Signed-off-by: Michael X. Grey <[email protected]>

Author: mxgrey

rclrs/src/client.rs

@@ -15,9 +15,9 @@ use crate::{rcl_bindings::*, NodeHandle, RclrsError, ENTITY_LIFECYCLE_MUTEX};
 // they are running in. Therefore, this type can be safely sent to another thread.
 unsafe impl Send for rcl_client_t {}
 
-/// Manage the lifecycle of an [`rcl_client_t`], including managing its dependencies
-/// on [`rcl_node_t`] and [`rcl_context_t`] by ensuring that these dependencies are
-/// [dropped after][1] the [`rcl_client_t`].
+/// Manage the lifecycle of an `rcl_client_t`, including managing its dependencies
+/// on `rcl_node_t` and `rcl_context_t` by ensuring that these dependencies are
+/// [dropped after][1] the `rcl_client_t`.
 ///
 /// [1] https://doc.rust-lang.org/reference/destructors.html
 pub struct ClientHandle {

rclrs/src/context.rs

@@ -10,8 +10,8 @@ use crate::{RclrsError, ToResult};
 /// This is locked whenever initializing or dropping any middleware entity
 /// because we have found issues in RCL and some RMW implementations that
 /// make it unsafe to simultaneously initialize and/or drop middleware
-/// entities such as [`rcl_context_t`] and [`rcl_node_t`] as well middleware
-/// primitives such as [`rcl_publisher_t`], [`rcl_subscription_t`], etc.
+/// entities such as `rcl_context_t` and `rcl_node_t` as well middleware
+/// primitives such as `rcl_publisher_t`, `rcl_subscription_t`, etc.
 /// It seems these C and C++ based libraries will regularly use
 /// unprotected global variables in their object initialization and cleanup.
 ///
@@ -59,10 +59,10 @@ pub struct Context {
     pub(crate) handle: Arc<ContextHandle>,
 }
 
-/// This struct manages the lifetime and access to the [`rcl_context_t`]. It will also
+/// This struct manages the lifetime and access to the `rcl_context_t`. It will also
 /// account for the lifetimes of any dependencies, if we need to add
 /// dependencies in the future (currently there are none). It is not strictly
-/// necessary to decompose [`Context`] and [`ContextHandle`] like this, but we are
+/// necessary to decompose `Context` and `ContextHandle` like this, but we are
 /// doing it to be consistent with the lifecycle management of other rcl
 /// bindings in this library.
 pub(crate) struct ContextHandle {

rclrs/src/node.rs

@@ -68,9 +68,9 @@ pub struct Node {
     pub(crate) handle: Arc<NodeHandle>,
 }
 
-/// This struct manages the lifetime of an [`rcl_node_t`], and accounts for its
-/// dependency on the lifetime of its [`rcl_context_t`] by ensuring that this
-/// dependency is [dropped after][1] the [`rcl_node_t`].
+/// This struct manages the lifetime of an `rcl_node_t`, and accounts for its
+/// dependency on the lifetime of its `rcl_context_t` by ensuring that this
+/// dependency is [dropped after][1] the `rcl_node_t`.
 ///
 /// [1] https://doc.rust-lang.org/reference/destructors.html
 pub(crate) struct NodeHandle {

rclrs/src/publisher.rs

@@ -18,9 +18,9 @@ pub use loaned_message::*;
 // they are running in. Therefore, this type can be safely sent to another thread.
 unsafe impl Send for rcl_publisher_t {}
 
-/// Manage the lifecycle of an [`rcl_publisher_t`], including managing its dependencies
-/// on [`rcl_node_t`] and [`rcl_context_t`] by ensuring that these dependencies are
-/// [dropped after][1] the [`rcl_publisher_t`].
+/// Manage the lifecycle of an `rcl_publisher_t`, including managing its dependencies
+/// on `rcl_node_t` and `rcl_context_t` by ensuring that these dependencies are
+/// [dropped after][1] the `rcl_publisher_t`.
 ///
 /// [1] https://doc.rust-lang.org/reference/destructors.html
 struct PublisherHandle {

rclrs/src/service.rs

@@ -13,9 +13,9 @@ use crate::{NodeHandle, ENTITY_LIFECYCLE_MUTEX};
 // they are running in. Therefore, this type can be safely sent to another thread.
 unsafe impl Send for rcl_service_t {}
 
-/// Manage the lifecycle of an [`rcl_service_t`], including managing its dependencies
-/// on [`rcl_node_t`] and [`rcl_context_t`] by ensuring that these dependencies are
-/// [dropped after][1] the [`rcl_service_t`].
+/// Manage the lifecycle of an `rcl_service_t`, including managing its dependencies
+/// on `rcl_node_t` and `rcl_context_t` by ensuring that these dependencies are
+/// [dropped after][1] the `rcl_service_t`.
 ///
 /// [1] https://doc.rust-lang.org/reference/destructors.html
 pub struct ServiceHandle {

rclrs/src/subscription.rs

@@ -21,9 +21,9 @@ pub use readonly_loaned_message::*;
 // they are running in. Therefore, this type can be safely sent to another thread.
 unsafe impl Send for rcl_subscription_t {}
 
-/// Manage the lifecycle of an [`rcl_subscription_t`], including managing its dependencies
-/// on [`rcl_node_t`] and [`rcl_context_t`] by ensuring that these dependencies are
-/// [dropped after][1] the [`rcl_subscription_t`].
+/// Manage the lifecycle of an `rcl_subscription_t`, including managing its dependencies
+/// on `rcl_node_t` and `rcl_context_t` by ensuring that these dependencies are
+/// [dropped after][1] the `rcl_subscription_t`.
 ///
 /// [1] https://doc.rust-lang.org/reference/destructors.html
 pub struct SubscriptionHandle {

rclrs/src/wait.rs

@@ -28,9 +28,9 @@ mod guard_condition;
 use exclusivity_guard::*;
 pub use guard_condition::*;
 
-/// Manage the lifecycle of an [`rcl_wait_set_t`], including managing its dependency
-/// on [`rcl_context_t`] by ensuring that this dependency is [dropped after][1] the
-/// [`rcl_wait_set_t`].
+/// Manage the lifecycle of an `rcl_wait_set_t`, including managing its dependency
+/// on `rcl_context_t` by ensuring that this dependency is [dropped after][1] the
+/// `rcl_wait_set_t`.
 ///
 /// [1] https://doc.rust-lang.org/reference/destructors.html
 struct WaitSetHandle {

rclrs/src/wait/guard_condition.rs

@@ -52,9 +52,9 @@ pub struct GuardCondition {
     pub(crate) in_use_by_wait_set: Arc<AtomicBool>,
 }
 
-/// Manage the lifecycle of an [`rcl_guard_condition_t`], including managing its dependency
-/// on [`rcl_context_t`] by ensuring that this dependency is [dropped after][1] the
-/// [`rcl_guard_condition_t`].
+/// Manage the lifecycle of an `rcl_guard_condition_t`, including managing its dependency
+/// on `rcl_context_t` by ensuring that this dependency is [dropped after][1] the
+/// `rcl_guard_condition_t`.
 ///
 /// [1] https://doc.rust-lang.org/reference/destructors.html
 pub(crate) struct GuardConditionHandle {