Struct rustdoc::config::Options

pub(crate) struct Options {

    pub(crate) input: PathBuf,
    pub(crate) crate_name: Option<String>,
    pub(crate) proc_macro_crate: bool,
    pub(crate) error_format: ErrorOutputType,
    pub(crate) libs: Vec<SearchPath>,
    pub(crate) lib_strs: Vec<String>,
    pub(crate) externs: Externs,
    pub(crate) extern_strs: Vec<String>,
    pub(crate) cfgs: Vec<String>,
    pub(crate) codegen_options: CodegenOptions,
    pub(crate) codegen_options_strs: Vec<String>,
    pub(crate) debugging_opts: DebuggingOptions,
    pub(crate) debugging_opts_strs: Vec<String>,
    pub(crate) target: TargetTriple,
    pub(crate) edition: Edition,
    pub(crate) maybe_sysroot: Option<PathBuf>,
    pub(crate) lint_opts: Vec<(String, Level)>,
    pub(crate) describe_lints: bool,
    pub(crate) lint_cap: Option<Level>,
    pub(crate) should_test: bool,
    pub(crate) test_args: Vec<String>,
    pub(crate) test_run_directory: Option<PathBuf>,
    pub(crate) persist_doctests: Option<PathBuf>,
    pub(crate) runtool: Option<String>,
    pub(crate) runtool_args: Vec<String>,
    pub(crate) enable_per_target_ignores: bool,
    pub(crate) test_builder: Option<PathBuf>,
    pub(crate) default_passes: DefaultPassOption,
    pub(crate) manual_passes: Vec<String>,
    pub(crate) display_warnings: bool,
    pub(crate) show_coverage: bool,
    pub(crate) crate_version: Option<String>,
    pub(crate) render_options: RenderOptions,
    pub(crate) output_format: OutputFormat,
    pub(crate) run_check: bool,
    pub(crate) json_unused_externs: bool,
}

Configuration options for rustdoc.

Fields

input: PathBuf

The crate root or Markdown file to load.

crate_name: Option<String>

The name of the crate being documented.

proc_macro_crate: bool

Whether or not this is a proc-macro crate

error_format: ErrorOutputType

How to format errors and warnings.

libs: Vec<SearchPath>

Library search paths to hand to the compiler.

lib_strs: Vec<String>

Library search paths strings to hand to the compiler.

externs: Externs

The list of external crates to link against.

extern_strs: Vec<String>

The list of external crates strings to link against.

cfgs: Vec<String>

List of cfg flags to hand to the compiler. Always includes rustdoc.

codegen_options: CodegenOptions

Codegen options to hand to the compiler.

codegen_options_strs: Vec<String>

Codegen options strings to hand to the compiler.

debugging_opts: DebuggingOptions

Debugging (-Z) options to pass to the compiler.

debugging_opts_strs: Vec<String>

Debugging (-Z) options strings to pass to the compiler.

target: TargetTriple

The target used to compile the crate against.

edition: Edition

Edition used when reading the crate. Defaults to “2015”. Also used by default when compiling doctests from the crate.

maybe_sysroot: Option<PathBuf>

The path to the sysroot. Used during the compilation process.

lint_opts: Vec<(String, Level)>

Lint information passed over the command-line.

describe_lints: bool

Whether to ask rustc to describe the lints it knows.

lint_cap: Option<Level>

What level to cap lints at.

should_test: bool

Whether we should run doctests instead of generating docs.

test_args: Vec<String>

List of arguments to pass to the test harness, if running tests.

test_run_directory: Option<PathBuf>

The working directory in which to run tests.

persist_doctests: Option<PathBuf>

Optional path to persist the doctest executables to, defaults to a temporary directory if not set.

runtool: Option<String>

Runtool to run doctests with

runtool_args: Vec<String>

Arguments to pass to the runtool

enable_per_target_ignores: bool

Whether to allow ignoring doctests on a per-target basis For example, using ignore-foo to ignore running the doctest on any target that contains “foo” as a substring

test_builder: Option<PathBuf>

The path to a rustc-like binary to build tests with. If not set, we default to loading from $sysroot/bin/rustc.

default_passes: DefaultPassOption

The selected default set of passes to use.

Be aware: This option can come both from the CLI and from crate attributes!

manual_passes: Vec<String>

Any passes manually selected by the user.

Be aware: This option can come both from the CLI and from crate attributes!

display_warnings: bool

Whether to display warnings during doc generation or while gathering doctests. By default, all non-rustdoc-specific lints are allowed when generating docs.

show_coverage: bool

Whether to run the calculate-doc-coverage pass, which counts the number of public items with and without documentation.

crate_version: Option<String>

Crate version to note on the sidebar of generated docs.

render_options: RenderOptions

Collected options specific to outputting final pages.

output_format: OutputFormat

The format that we output when rendering.

Currently used only for the --show-coverage option.

run_check: bool

If this option is set to true, rustdoc will only run checks and not generate documentation.

json_unused_externs: bool

Whether doctests should emit unused externs

Implementations

impl Options

pub(crate) fn from_matches(matches: &Matches) -> Result<Options, i32>

Parses the given command-line for options. If an error message or other early-return has been printed, returns Err with the exit code.

pub(crate) fn markdown_input(&self) -> bool

Returns true if the file given as self.input is a Markdown file.

Trait Implementations

impl Clone for Options

fn clone(&self) -> Options

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Options

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

Formats the value using the given formatter.