Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Thursday, June 13, 2019

cargo-rustdoc (1)


cargo-rustdoc - Build a package's documentation, using specified custom flags.


cargo rustdoc [OPTIONS] [--] [<OPTS>...]


CARGO-RUSTDOC(1)                 Cargo Manual                 CARGO-RUSTDOC(1)

       cargo-rustdoc - Build a package's documentation, using specified custom

       cargo rustdoc [OPTIONS] [--] [<OPTS>...]

       The specified target for the current package (or package  specified  by
       SPEC  if provided) will be documented with the specified <OPTS>...  be-
       ing passed to the final rustdoc invocation.  Dependencies will  not  be
       documented  as  part of this command.  Note that rustdoc will still un-
       conditionally receive arguments such as -L, --extern, and --crate-type,
       and  the specified <OPTS>...  will simply be added to the rustdoc invo-

       If the --package argument is given, then SPEC is a package id  specifi-
       cation  which  indicates  which package should be documented.  If it is
       not given, then the current package is documented.  For  more  informa-
       tion on SPEC and its format, see the cargo help pkgid command.

       -h, --help
              Print this message.

       --open Open the docs in a browser after the operation.

       -p SPEC, --package SPEC
              Package to document.

       -j N, --jobs N
              Number of parallel jobs, defaults to # of CPUs.

       --lib  Build only this package's library.

       --bin NAME
              Build only the specified binary.

       --example NAME
              Build only the specified example.

       --test NAME
              Build only the specified test target.

       --bench NAME
              Build only the specified benchmark target.

              Build artifacts in release mode, with optimizations.

       --features FEATURES
              Space-separated list of features to also build.

              Build all available features.

              Do not build the default feature.

       --target TRIPLE
              Build for the target triple.

       --manifest-path PATH
              Path to the manifest to document.

       -v, --verbose
              Use verbose output.

       -q, --quiet
              No output printed to stdout.

       --color WHEN
              Coloring: auto, always, never.

       See attributes(7) for descriptions of the following attributes:

       |Availability   | developer/rust/cargo |
       |Stability      | Volatile             |
       cargo(1), cargo-doc(1)

       This  work  is dual-licensed under Apache 2.0 and MIT terms.  See COPY-
       RIGHT file in the cargo source distribution.

       This software was built from source available at https://github.com/or-
       acle/solaris-userland.   The  original  community source was downloaded
       from  https://static.rust-lang.org/dist/rustc-1.28.0-src.tar.xz

       Further information about this software can be found on the open source
       community website at http://www.rust-lang.org/.

The Rust package manager           May 2016                   CARGO-RUSTDOC(1)