#cargo #crates #literate-programming #cargo-subcommand #dependencies #cli

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

#514 in Cargo plugins

Apache-2.0/MIT

4MB

rocco

cargo docco

cargo docco generates literate programming style documentation pages.

Actions Status crates.io license license

In action

docco in action

Installation

$ 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.)

Usage

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

USAGE:
    cargo docco [OPTIONS] -i <input>

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

OPTIONS:
    -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.

Contribution

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.

Support

Buy Me A Coffee

ko-fi

License

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.

Dependencies

~14MB
~239K SLoC