clap/examples
Ed Page f925ca84b6 docs: Clarify how to use examples
When we restuctured the examples, we lost the notes on how they should
be structured, so this adds it back in.
2022-09-26 21:06:02 -05:00
..
derive_ref docs(ref): Remove dead example 2022-09-21 11:02:08 -05:00
tutorial_builder fix(parser): Conflict-with-self is back on by default 2022-09-26 13:29:48 -05:00
tutorial_derive fix(parser): Conflict-with-self is back on by default 2022-09-26 13:29:48 -05:00
cargo-example-derive.md fix(help): Make output more dense 2022-09-07 17:13:55 -05:00
cargo-example-derive.rs docs(derive): Update for new attributes 2022-09-02 15:39:13 -05:00
cargo-example.md fix(help): Make output more dense 2022-09-07 17:13:55 -05:00
cargo-example.rs fix: Make arg!(--flag <value>) optional by default 2022-09-12 17:10:01 -05:00
demo.md fix(help): Make output more dense 2022-09-07 17:13:55 -05:00
demo.rs docs(derive): Update for new attributes 2022-09-02 15:39:13 -05:00
escaped-positional-derive.md fix(parser): Quote the suggested help 2022-09-15 16:24:59 -05:00
escaped-positional-derive.rs docs(derive): Update for new attributes 2022-09-02 15:39:13 -05:00
escaped-positional.md fix(parser): Quote the suggested help 2022-09-15 16:24:59 -05:00
escaped-positional.rs fix: Make arg!(--flag <value>) optional by default 2022-09-12 17:10:01 -05:00
find.md fix: Make arg!(--flag <value>) optional by default 2022-09-12 17:10:01 -05:00
find.rs fix: Switch to owned types 2022-08-22 14:55:55 -05:00
git-derive.md fix(help): Make output more dense 2022-09-07 17:13:55 -05:00
git-derive.rs docs: Show how last can be used 2022-09-07 11:27:39 -05:00
git.md fix(help): Make output more dense 2022-09-07 17:13:55 -05:00
git.rs fix: Make arg!(--flag <value>) optional by default 2022-09-12 17:10:01 -05:00
multicall-busybox.md fix(help): Make output more dense 2022-09-07 17:13:55 -05:00
multicall-busybox.rs fix: Switch to owned types 2022-08-22 14:55:55 -05:00
multicall-hostname.md fix!: Remove App alias for Command 2022-07-21 15:08:37 -05:00
multicall-hostname.rs feat(multicall): Stablize multicall 2022-05-20 12:20:40 -05:00
pacman.md fix(help): Separate command flags like options 2022-09-19 09:07:43 -05:00
pacman.rs feat(parser): Provide convenience for SetTrue 2022-09-01 19:40:56 -05:00
README.md docs: Clarify how to use examples 2022-09-26 21:06:02 -05:00
repl.rs fix: Switch to owned types 2022-08-22 14:55:55 -05:00
typed-derive.md fix(parser): Quote the suggested help 2022-09-15 16:24:59 -05:00
typed-derive.rs docs(derive): Update for new attributes 2022-09-02 15:39:13 -05:00

Examples

We try to focus our documentation on the four types of documentation. Examples fit into this by providing:

This directory contains the source for the above.

Contributing

New examples should fit within the above structure and support their narrative

  • Add the example to Cargo.tom for any required-features
  • Document how the example works with a .md file which will be verified using trycmd
  • Pull the .rs and .md file into the appropriate module doc comment to be accessible on docs.rs