Document the new 'trace' feature.

This commit is contained in:
Sergio Benitez 2024-05-15 19:05:26 -07:00
parent b12b7f27d7
commit cc2b159e85
1 changed files with 15 additions and 13 deletions

View File

@ -53,20 +53,21 @@
//! //!
//! ## Features //! ## Features
//! //!
//! To avoid compiling unused dependencies, Rocket gates certain features. With //! To avoid compiling unused dependencies, Rocket feature-gates optional
//! the exception of `http2`, all are disabled by default: //! functionality, some enabled by default:
//! //!
//! | Feature | Description | //! | Feature | Default? | Description |
//! |-----------------|---------------------------------------------------------| //! |-----------------|----------|---------------------------------------------------------|
//! | `secrets` | Support for authenticated, encrypted [private cookies]. | //! | `trace` | Yes | Enables the default Rocket tracing [subscriber]. |
//! | `tls` | Support for [TLS] encrypted connections. | //! | `http2` | Yes | Support for HTTP/2 (enabled by default). |
//! | `mtls` | Support for verified clients via [mutual TLS]. | //! | `secrets` | No | Support for authenticated, encrypted [private cookies]. |
//! | `http2` | Support for HTTP/2 (enabled by default). | //! | `tls` | No | Support for [TLS] encrypted connections. |
//! | `json` | Support for [JSON (de)serialization]. | //! | `mtls` | No | Support for verified clients via [mutual TLS]. |
//! | `msgpack` | Support for [MessagePack (de)serialization]. | //! | `json` | No | Support for [JSON (de)serialization]. |
//! | `uuid` | Support for [UUID value parsing and (de)serialization]. | //! | `msgpack` | No | Support for [MessagePack (de)serialization]. |
//! | `tokio-macros` | Enables the `macros` feature in the exported `tokio` | //! | `uuid` | No | Support for [UUID value parsing and (de)serialization]. |
//! | `http3-preview` | Experimental preview support for [HTTP/3]. | //! | `tokio-macros` | No | Enables the `macros` feature in the exported `tokio` |
//! | `http3-preview` | No | Experimental preview support for [HTTP/3]. |
//! //!
//! Disabled features can be selectively enabled in `Cargo.toml`: //! Disabled features can be selectively enabled in `Cargo.toml`:
//! //!
@ -82,6 +83,7 @@
//! rocket = { version = "0.6.0-dev", default-features = false } //! rocket = { version = "0.6.0-dev", default-features = false }
//! ``` //! ```
//! //!
//! [subscriber]: crate::trace::subscriber
//! [JSON (de)serialization]: crate::serde::json //! [JSON (de)serialization]: crate::serde::json
//! [MessagePack (de)serialization]: crate::serde::msgpack //! [MessagePack (de)serialization]: crate::serde::msgpack
//! [UUID value parsing and (de)serialization]: crate::serde::uuid //! [UUID value parsing and (de)serialization]: crate::serde::uuid