#cli #cargo #crates #dependencies #cargo-subcommand

app cargo-docco

cargo docco generates literate programming style documentation pages from source code. Port of Jash Kenas' Docco in Rust.

1 unstable release

0.1.0 Nov 6, 2020

#434 in Cargo plugins

Apache-2.0/MIT and GPL-3.0 licenses



cargo docco

cargo docco generates literate programming style documentation pages.

Actions Status crates.io license license

In action

docco in action


$ cargo install cargo-docco

(Please check cargo's documentation to learn how cargo install works and how to set up your system so it finds binaries installed by cargo.)


Generating documentation pages is as simple as providing cargo docco an input file via -i flag.

cargo docco -i source.rs [-o <optional output file name>]

When no output file is provided, cargo docco will generate an html file name same as the source file name.

CLI overview

> cargo docco -h
cargo-docco 0.1.0
Literate-style documentation generator from source code

    cargo docco [OPTIONS] -i <input>

    -h, --help       Prints help information
    -V, --version    Prints version information

    -i <input>         input source file
    -o <output>        optional path to the generated output html file

Supported languages

cargo-docco relies on rocco. See "Supported languages" section for supported languages.


All kinds of contributions are welcome.

Questions can be asked in issues.

To help us help you get pull requests merged quickly and smoothly, open an issue before submitted large changes. Please keep the contents of pull requests and commits short. Commit messages should include the intent of the commit.


Buy Me A Coffee



Dual licensed under either of Apache License, Version 2.0 or MIT license at your option.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.


~216K SLoC