More deprecation notices (relates #2036) (#2098)

Author: udoprog

tokio-buf/README.md

@@ -2,6 +2,8 @@
 
 Asynchronous stream of byte buffers
 
+> **Note:** This crate has been **deprecated in tokio 0.2.x**.
+
 [Documenation](https://docs.rs/tokio-buf)
 
 ## Usage

tokio-buf/src/lib.rs

@@ -3,6 +3,8 @@
 
 //! Asynchronous stream of bytes.
 //!
+//! > **Note:** This crate has been **deprecated in tokio 0.2.x**.
+//!
 //! This crate contains the `BufStream` trait and a number of combinators for
 //! this trait. The trait is similar to `Stream` in the `futures` library, but
 //! instead of yielding arbitrary values, it only yields types that implement

tokio-codec/README.md

@@ -2,11 +2,12 @@
 
 Utilities for encoding and decoding frames.
 
-This crate is **deprecated in tokio 0.2.x** and has been moved into
-[`tokio_util::codec`] of the [`tokio-utils` crate] behind the `codec` feature flag.
+> **Note:** This crate is **deprecated in tokio 0.2.x** and has been moved into
+> [`tokio_util::codec`] of the [`tokio-util` crate] behind the `codec` feature
+> flag.
 
-[`tokio::codec`]: https://docs.rs/tokio-util/latest/tokio_util/codec/index.html
-[`tokio-utils` crate]: https://docs.rs/tokio-util/latest/tokio_util
+[`tokio_util::codec`]: https://docs.rs/tokio-util/latest/tokio_util/codec/index.html
+[`tokio-util` crate]: https://docs.rs/tokio-util/latest/tokio_util
 
 [Documentation](https://docs.rs/tokio-codec)
 

tokio-codec/src/lib.rs

@@ -3,6 +3,13 @@
 
 //! Utilities for encoding and decoding frames.
 //!
+//! > **Note:** This crate is **deprecated in tokio 0.2.x** and has been moved
+//! into [`tokio_util::codec`] of the [`tokio-util` crate] behind the `codec`
+//! feature flag.
+//!
+//! [`tokio_util::codec`]: https://docs.rs/tokio-util/latest/tokio_util/codec/index.html
+//! [`tokio-util` crate]: https://docs.rs/tokio-util/latest/tokio_util
+//!
 //! Contains adapters to go from streams of bytes, [`AsyncRead`] and
 //! [`AsyncWrite`], to framed streams implementing [`Sink`] and [`Stream`].
 //! Framed streams are also known as [transports].

tokio-current-thread/README.md

@@ -2,6 +2,15 @@
 
 Single threaded executor for Tokio.
 
+> **Note:** This crate is **deprecated in tokio 0.2.x** and has been moved and
+> refactored into various places in the [`tokio`] crate. The closest replacement
+> is to make use of [`tokio::task::LocalSet::block_on`] which requires the
+> [`rt-util` feature].
+
+[`tokio`]: https://docs.rs/tokio/latest/tokio/index.html
+[`tokio::task::LocalSet::block_on`]: https://docs.rs/tokio/latest/tokio/task/struct.LocalSet.html#method.block_on
+[`rt-util` feature]: https://docs.rs/tokio/latest/tokio/index.html#feature-flags
+
 [Documentation](https://docs.rs/tokio-current-thread/0.1.6/tokio_current_thread/)
 
 ## Overview

tokio-current-thread/src/lib.rs

@@ -4,6 +4,14 @@
 //! A single-threaded executor which executes tasks on the same thread from which
 //! they are spawned.
 //!
+//! > **Note:** This crate is **deprecated in tokio 0.2.x** and has been moved
+//! > and refactored into various places in the [`tokio`] crate. The closest
+//! replacement is to make use of [`tokio::task::LocalSet::block_on`] which
+//! requires the [`rt-util` feature].
+//!
+//! [`tokio`]: https://docs.rs/tokio/latest/tokio/index.html
+//! [`tokio::task::LocalSet::block_on`]: https://docs.rs/tokio/latest/tokio/task/struct.LocalSet.html#method.block_on
+//! [`rt-util` feature]: https://docs.rs/tokio/latest/tokio/index.html#feature-flags
 //!
 //! The crate provides:
 //!

tokio-io/README.md

@@ -4,6 +4,11 @@ Core I/O abstractions for the Tokio stack.
 
 [![Build Status](https://travis-ci.org/tokio-rs/tokio-io.svg?branch=master)](https://travis-ci.org/tokio-rs/tokio-io)
 
+> **Note:** This crate has been **deprecated in tokio 0.2.x** and has been moved
+> into [`tokio::io`].
+
+[`tokio::io`]: https://docs.rs/tokio/latest/tokio/io/index.html
+
 [Documentation](https://docs.rs/tokio-io/0.1.12/tokio_io)
 
 ## Usage

tokio-io/src/lib.rs

@@ -3,6 +3,11 @@
 
 //! Core I/O traits and combinators when working with Tokio.
 //!
+//! > **Note:** This crate has been **deprecated in tokio 0.2.x** and has been
+//! > moved into [`tokio::io`].
+//!
+//! [`tokio::io`]: https://docs.rs/tokio/latest/tokio/io/index.html
+//!
 //! A description of the high-level I/O combinators can be [found online] in
 //! addition to a description of the [low level details].
 //!

tokio-reactor/README.md

@@ -2,9 +2,10 @@
 
 Event loop that drives Tokio I/O resources.
 
-This crate is **deprecated in tokio 0.2.x** and has been moved and refactored
-into various places in the [`tokio::runtime`] and [`tokio::io`] modules of the
-[`tokio`] crate. The Reactor has also been renamed the "I/O Driver".
+> **Note:** This crate is **deprecated in tokio 0.2.x** and has been moved and
+> refactored into various places in the [`tokio::runtime`] and [`tokio::io`]
+> modules of the [`tokio`] crate. The Reactor has also been renamed the
+> "I/O Driver".
 
 [`tokio::runtime`]: https://docs.rs/tokio/latest/tokio/runtime/index.html
 [`tokio::io`]: https://docs.rs/tokio/latest/tokio/io/index.html

tokio-reactor/src/lib.rs

@@ -3,6 +3,16 @@
 
 //! Event loop that drives Tokio I/O resources.
 //!
+//! > **Note:** This crate is **deprecated in tokio 0.2.x** and has been moved
+//! > and refactored into various places in the [`tokio::runtime`] and
+//! > [`tokio::io`] modules of the [`tokio`] crate. The Reactor has also been
+//! > renamed the "I/O Driver".
+//!
+//! [`tokio::runtime`]: https://docs.rs/tokio/latest/tokio/runtime/index.html
+//! [`tokio::io`]: https://docs.rs/tokio/latest/tokio/io/index.html
+//! [`tokio`]: https://docs.rs/tokio/latest/tokio/index.html
+//! [`io-driver` feature]: https://docs.rs/tokio/0.2.9/tokio/index.html#feature-flags
+//!
 //! The reactor is the engine that drives asynchronous I/O resources (like TCP and
 //! UDP sockets). It is backed by [`mio`] and acts as a bridge between [`mio`] and
 //! [`futures`].