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
20KB
408 lines
cargo makedocs
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