diff options
author | Igor Aleksanov <popzxc@yandex.ru> | 2020-09-05 21:22:47 +0300 |
---|---|---|
committer | GitHub <noreply@github.com> | 2020-09-05 20:22:47 +0200 |
commit | 38cab933301b60a7fa730bb999bc08cdb5529476 (patch) | |
tree | 7e1bd785ca4a0c9ec565717fa4d4d75180523504 /tokio/src | |
parent | 171cb57fa1baffe369e44e1bf28382dcb54b2e1c (diff) |
runtime: improve runtime vs #[tokio::main] doc (#2820)
Diffstat (limited to 'tokio/src')
-rw-r--r-- | tokio/src/lib.rs | 7 | ||||
-rw-r--r-- | tokio/src/runtime/mod.rs | 6 |
2 files changed, 7 insertions, 6 deletions
diff --git a/tokio/src/lib.rs b/tokio/src/lib.rs index 7bf9f743..b31b478d 100644 --- a/tokio/src/lib.rs +++ b/tokio/src/lib.rs @@ -196,9 +196,10 @@ //! //! Finally, Tokio provides a _runtime_ for executing asynchronous tasks. Most //! applications can use the [`#[tokio::main]`][main] macro to run their code on the -//! Tokio runtime. In use-cases where manual control over the runtime is -//! required, the [`tokio::runtime`] module provides APIs for configuring and -//! managing runtimes. +//! Tokio runtime. However, this macro provides only basic configuration options. As +//! an alternative, the [`tokio::runtime`] module provides more powerful APIs for configuring +//! and managing runtimes. You should use that module if the `#[tokio::main]` macro doesn't +//! provide the functionality you need. //! //! Using the runtime requires the "rt-core" or "rt-threaded" feature flags, to //! enable the basic [single-threaded scheduler][rt-core] and the [thread-pool diff --git a/tokio/src/runtime/mod.rs b/tokio/src/runtime/mod.rs index 9d26446b..bec0ecd5 100644 --- a/tokio/src/runtime/mod.rs +++ b/tokio/src/runtime/mod.rs @@ -10,14 +10,14 @@ //! * A **timer** for scheduling work to run after a set period of time. //! //! Tokio's [`Runtime`] bundles all of these services as a single type, allowing -//! them to be started, shut down, and configured together. However, most -//! applications won't need to use [`Runtime`] directly. Instead, they can +//! them to be started, shut down, and configured together. However, often +//! it is not required to configure a [`Runtime`] manually, and user may just //! use the [`tokio::main`] attribute macro, which creates a [`Runtime`] under //! the hood. //! //! # Usage //! -//! Most applications will use the [`tokio::main`] attribute macro. +//! When no fine tuning is required, the [`tokio::main`] attribute macro can be used. //! //! ```no_run //! use tokio::net::TcpListener; |