summaryrefslogtreecommitdiffstats
path: root/tokio-util/src/codec/mod.rs
diff options
context:
space:
mode:
Diffstat (limited to 'tokio-util/src/codec/mod.rs')
-rw-r--r--tokio-util/src/codec/mod.rs13
1 files changed, 9 insertions, 4 deletions
diff --git a/tokio-util/src/codec/mod.rs b/tokio-util/src/codec/mod.rs
index 96e9f9f9..e89aa7c9 100644
--- a/tokio-util/src/codec/mod.rs
+++ b/tokio-util/src/codec/mod.rs
@@ -1,8 +1,13 @@
-//! Utilities for encoding and decoding frames.
+//! Adaptors from AsyncRead/AsyncWrite to Stream/Sink
//!
-//! 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.
+//! Raw I/O objects work with byte sequences, but higher-level code
+//! usually wants to batch these into meaningful chunks, called
+//! "frames".
+//!
+//! This module 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.
//!
//! [`AsyncRead`]: tokio::io::AsyncRead
//! [`AsyncWrite`]: tokio::io::AsyncWrite