{{*set actionverb="Document"}}
cargo-doc - Build a package's documentation
cargo doc
[options]
Build the documentation for the local package and all dependencies. The output
is placed in target/doc
in rustdoc's usual format.
{{#options}}
{{#option "--open
" }}
Open the docs in a browser after building them. This will use your default
browser unless you define another one in the BROWSER
environment variable
or use the doc.browser
configuration
option.
{{/option}}
{{#option "--no-deps
" }}
Do not build documentation for dependencies.
{{/option}}
{{#option "--document-private-items
" }}
Include non-public items in the documentation. This will be enabled by default if documenting a binary target.
{{/option}}
{{/options}}
{{> section-package-selection }}
When no target selection options are given, cargo doc
will document all
binary and library targets of the selected package. The binary will be skipped
if its name is the same as the lib target. Binaries are skipped if they have
required-features
that are missing.
The default behavior can be changed by setting doc = false
for the target in
the manifest settings. Using target selection options will ignore the doc
flag and will always document the given target.
{{#options}} {{> options-targets-lib-bin }}
{{#option "--example
name..." }}
{{actionverb}} the specified example. This flag may be specified multiple times
and supports common Unix glob patterns.
{{/option}}
{{#option "--examples
" }}
{{actionverb}} all example targets.
{{/option}}
{{/options}}
{{> section-features }}
{{#options}}
{{> options-target-triple }}
{{> options-release }}
{{> options-profile }}
{{> options-ignore-rust-version }}
{{/options}}
{{#options}} {{> options-target-dir }} {{/options}}
{{#options}} {{> options-display }}
{{> options-message-format }} {{/options}}
{{#options}} {{> options-manifest-path }}
{{> options-locked }} {{/options}}
{{> section-options-common }}
{{#options}} {{> options-jobs }} {{/options}}
{{> section-environment }}
{{> section-exit-status }}
-
Build the local package documentation and its dependencies and output to
target/doc
.cargo doc
{{man "cargo" 1}}, {{man "cargo-rustdoc" 1}}, {{man "rustdoc" 1}}