Document `#[diagnostic(transparent)]`

This commit is contained in:
Gavrilikhin Daniil 2023-05-14 19:09:06 +08:00
parent c25676cb1f
commit 8f322567b8
1 changed files with 13 additions and 1 deletions

View File

@ -186,7 +186,7 @@
//! //!
//! ```rust //! ```rust
//! // lib/error.rs //! // lib/error.rs
//! use miette::Diagnostic; //! use miette::{Diagnostic, SourceSpan};
//! use thiserror::Error; //! use thiserror::Error;
//! //!
//! #[derive(Error, Diagnostic, Debug)] //! #[derive(Error, Diagnostic, Debug)]
@ -198,6 +198,18 @@
//! #[error("Oops it blew up")] //! #[error("Oops it blew up")]
//! #[diagnostic(code(my_lib::bad_code))] //! #[diagnostic(code(my_lib::bad_code))]
//! BadThingHappened, //! BadThingHappened,
//!
//! #[error(transparent)]
//! // Use `#[diagnostic(transparent)]` to wrap another [`Diagnostic`]. You won't see labels otherwise
//! #[diagnostic(transparent)]
//! AnotherError(#[from] AnotherError),
//! }
//!
//! #[derive(Error, Diagnostic, Debug)]
//! #[error("another error")]
//! pub struct AnotherError {
//! #[label("here")]
//! pub at: SourceSpan
//! } //! }
//! ``` //! ```
//! //!