Enum OptionsError 

#[non_exhaustive]
pub enum OptionsError {
    ConflictingPageSelection,
    InvalidClipMargins {
        side: &'static str,
        value: f64,
    },
    BalancedIsMarkdownOnly,
    TatrNeedsOrtTables,
}

Option and selection errors: mistakes in the call, not faults in the document or the engine.

#[non_exhaustive], and that is the semver contract: new 1.x error cases arrive as new variants of THIS enum, never as new variants of EngineError. EngineError is an exhaustive enum published at 1.0.0, so adding a variant to it breaks every downstream exhaustive match — a major-version change. These cases travel inside EngineError::Io with std::io::ErrorKind::InvalidInput instead, readable through EngineError::options, and matching on this enum always keeps a fallback arm.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

ConflictingPageSelection

pages and the first_page/page_count window were combined.

InvalidClipMargins

A clip margin was negative or not finite.

Fields

side: &'static str

Which side: "left", "top", "right" or "bottom".

value: f64

What was asked for: negative, or not finite.

BalancedIsMarkdownOnly

quality was Quality::Balanced on a call that returns blocks: the balanced tier assembles markdown, so it is read by extract_markdown only (#641).

TatrNeedsOrtTables

TATR table structure was asked for on a build without it. The model runs only behind the ort-tables feature; without it the request is refused, never run as fast.

Trait Implementations

impl Clone for OptionsError

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for OptionsError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for OptionsError

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for OptionsError

impl Error for OptionsError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl PartialEq for OptionsError

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.