Link more docs in futures-util::compat

Author: Nemo157

futures-util/src/compat/compat.rs

@@ -1,5 +1,7 @@
-/// Converts a futures 0.3 `TryFuture`, `TryStream` or `Sink` into a futures 0.1
-/// `Future` and vice versa.
+/// Converts a futures 0.3 [`TryFuture`][futures_core::future::TryFuture],
+/// [`TryStream`][futures_core::stream::TryStream] or
+/// [`Sink`][futures_sink::Sink] into a futures 0.1 [`Future`][futures::Future],
+/// [`Stream`][futures::Stream] or [`Sink`][futures::Sink] and vice versa.
 #[derive(Debug)]
 #[must_use = "futures do nothing unless polled"]
 pub struct Compat<T, Ex> {
@@ -13,7 +15,7 @@ impl<T, Ex> Compat<T, Ex> {
         self.inner
     }
 
-    /// Creates a new `Compat`.
+    /// Creates a new [`Compat`].
     crate fn new(inner: T, executor: Option<Ex>) -> Compat<T, Ex> {
         Compat { inner, executor }
     }

futures-util/src/compat/executor.rs

@@ -6,14 +6,16 @@ use futures_core::task::Executor as Executor03;
 use futures_core::task as task03;
 use futures_core::future::FutureObj;
 
-/// A future that can run on a futures 0.1 executor.
+/// A future that can run on a futures 0.1
+/// [`Executor`][futures::future::Executor].
 pub type Executor01Future = Compat<UnitError<FutureObj<'static, ()>>, Box<dyn Executor03 + Send>>;
 
-/// Extension trait for futures 0.1 Executors.
+/// Extension trait for futures 0.1 [`Executor`][futures::future::Executor].
 pub trait Executor01CompatExt: Executor01<Executor01Future> +
                                Clone + Send + 'static
 {
-    /// Creates an `Executor` compatable with futures 0.3.
+    /// Converts a futures 0.1 [`Executor`][futures::future::Executor] into a
+    /// futures 0.3 [`Executor`][futures_core::task::Executor].
     fn compat(self) -> Executor01As03<Self>
         where Self: Sized;
 }
@@ -28,7 +30,8 @@ where Ex: Executor01<Executor01Future> + Clone + Send + 'static
     }
 }
 
-/// Converts a futures 0.1 `Executor` into a futures 0.3 `Executor`.
+/// Converts a futures 0.1 [`Executor`][futures::future::Executor] into a
+/// futures 0.3 [`Executor`][futures_core::task::Executor].
 #[derive(Clone)]
 pub struct Executor01As03<Ex> {
     executor01: Ex

futures-util/src/compat/future01ext.rs

@@ -3,10 +3,11 @@ use futures::Future as Future01;
 
 impl<Fut: Future01> Future01CompatExt for Fut {}
 
-/// Extension trait for futures 0.1 Futures.
+/// Extension trait for futures 0.1 [`Future`][futures::Future]
 pub trait Future01CompatExt: Future01 {
-    /// Converts a futures 0.1 `Future<Item = T, Error = E>` into a
-    /// futures 0.3 `Future<Output = Result<T, E>>`.
+    /// Converts a futures 0.1 [`Future<Item = T, Error = E>`][futures::Future]
+    /// into a futures 0.3 [`Future<Output = Result<T,
+    /// E>>`][futures_core::Future].
     fn compat(self) -> Compat<Self, ()> where Self: Sized {
         Compat {
             inner: self,