docs: fix all rustdoc warnings (#1474)

tokio/src/lib.rs

@@ -15,7 +15,7 @@
 //! provides a few major components:
 //!
 //! * A multi threaded, work-stealing based task [scheduler][runtime].
-//! * A [reactor] backed by the operating system's event queue (epoll, kqueue,
+//! * A [driver] backed by the operating system's event queue (epoll, kqueue,
 //!   IOCP, etc...).
 //! * Asynchronous [TCP and UDP][net] sockets.
 //! * Asynchronous [filesystem][fs] operations.
@@ -23,6 +23,7 @@
 //!
 //! Guide level documentation is found on the [website].
 //!
+//! [driver]: tokio_net::driver
 //! [website]: https://tokio.rs/docs/
 //!
 //! # Examples

tokio/src/net.rs

@@ -50,14 +50,8 @@ pub mod udp {
     //! UDP bindings for `tokio`.
     //!
     //! The main struct for UDP is the [`UdpSocket`], which represents a UDP socket.
-    //! Reading and writing to it can be done using futures, which return the
-    //! [`Recv`], [`Send`], [`RecvFrom`], [`SendTo`] structs respectively.
     //!
     //! [`UdpSocket`]: struct.UdpSocket.html
-    //! [`Recv`]: struct.Recv.html
-    //! [`Send`]: struct.Send.html
-    //! [`RecvFrom`]: struct.RecvFrom.html
-    //! [`SendTo`]: struct.SendTo.html
     pub use tokio_net::udp::{split, UdpFramed, UdpSocket};
 }
 #[cfg(feature = "udp")]

tokio/src/runtime/mod.rs

@@ -2,7 +2,7 @@
 //!
 //! Applications using Tokio require some runtime support in order to work:
 //!
-//! * A [reactor] to drive I/O resources.
+//! * A [driver] to drive I/O resources.
 //! * An [executor] to execute tasks that use these I/O resources.
 //! * A [timer] for scheduling work to run after a set period of time.
 //!
@@ -128,7 +128,7 @@
 //! }
 //! ```
 //!
-//! [reactor]: ../reactor/struct.Reactor.html
+//! [driver]: tokio_net::driver
 //! [executor]: https://tokio.rs/docs/internals/runtime-model/#executors
 //! [timer]: ../timer/index.html
 //! [`Runtime`]: struct.Runtime.html
@@ -138,6 +138,7 @@
 //! [idle]: struct.Runtime.html#method.shutdown_on_idle
 //! [`tokio::spawn`]: ../executor/fn.spawn.html
 //! [`Timer`]: https://docs.rs/tokio-timer/0.2/tokio_timer/timer/struct.Timer.html
+//! [`tokio::main`]: ../../tokio_macros/attr.main.html
 
 pub mod current_thread;
 mod threadpool;

tokio/src/stream.rs

@@ -23,7 +23,8 @@ pub use futures_util::stream::{empty, iter, once, pending, poll_fn, repeat, unfo
 /// This trait can be imported directly or via the Tokio prelude: `use
 /// tokio::prelude::*`.
 ///
-/// [`timeout`]: #method.timeout
+/// [`throttle`]: method.throttle
+/// [`timeout`]: method.timeout
 pub trait StreamExt: Stream {
     /// Throttle down the stream by enforcing a fixed delay between items.
     ///