#documentation #build #cargo-docs #cargo-toml #cargo-lock #cli

app cargo-makedocs

A cargo doc wrapper that only builds the documentation you care about

12 releases (3 stable)

1.2.0 Mar 16, 2020
1.1.0 Jun 6, 2019
0.3.2 Apr 18, 2019
0.3.1 Mar 17, 2019
0.1.3 Nov 2, 2018

#718 in Cargo plugins

MIT license

20KB
408 lines

cargo makedocs Build Status Crates.io Status

Installation

cargo install cargo-makedocs

Usage

cargo makedocs will parse your current working directory's Cargo.toml and Cargo.lock for dependencies, and only build documentation for the direct dependencies. This saves you from having to type cargo doc --no-deps -p <crate> ....

Options

If you want to exclude one or more crates for being documented, simply pass -e <cratename> as many times as needed. Same goes in reverse for -i, which will document a crate even if it isn't part of your Cargo.toml.

The --open flag will open the documentation in your web browser(passes --open to cargo doc).

Same (renamed) crate twice

Cargo will not document the same crate twice even if you have renamed it. This means that you can't, for example, get the documentation for both futures 0.1 and 0.3. To resolve such a situation, simply use the -e flag:

cargo makedocs -e futures01 # assuming futures 0.1 is named futures01

License

cargo-makedocs is available under the MIT license, see LICENSE for more details.

Dependencies

~2–3MB
~52K SLoC