/// `Error` functions a lot like `Box<dyn std::error::Error>`, with these differences:

/// `Error` functions a lot like `Box<dyn std::error::Error>`, with these
/// differences:

    /// The error type must be threadsafe and `'static`, so that the `Error` will be as well.

    /// The error type must be threadsafe and `'static`, so that the `Error`
    /// will be as well.

    /// If the error type does not provide a backtrace, a backtrace will be created here to ensure
    /// that a backtrace exists.

    /// If the error type does not provide a backtrace, a backtrace will be
    /// created here to ensure that a backtrace exists.

        // NB: this unwrap can only fail if the underlying error's backtrace method is
        // nondeterministic, which would only happen in maliciously constructed code

        // NB: this unwrap can only fail if the underlying error's backtrace
        // method is nondeterministic, which would only happen in maliciously
        // constructed code

    /// This iterator will visit every error in the "cause chain" of this error object, beginning with
    /// the error that this error object was created from.

    /// This iterator will visit every error in the "cause chain" of this error
    /// object, beginning with the error that this error object was created
    /// from.

/// This evaluates to an `Error`. It can take either just a string, or a format string with
/// arguments. It also can take any custom type which implements `Debug` and `Display`.

/// This evaluates to an `Error`. It can take either just a string, or a format
/// string with arguments. It also can take any custom type which implements
/// `Debug` and `Display`.