1 files changed, 92 insertions, 0 deletions
diff --git a/docs/pages/7-argument-parse-clap.md b/docs/pages/7-argument-parse-clap.md
new file mode 100644
index 0000000..b11e00e
--- /dev/null
+++ b/docs/pages/7-argument-parse-clap.md
@@ -0,0 +1,92 @@
+<h1 align="center">Parsing Arguments with Clap</h1>
+<p align="center">
+    Use clap for more complex argument parsing
+</p>
+
+Picker is suitable for lightweight arg extraction, but when there are many args, complex validation rules, or you need auto-generated `--help`, you can use [clap](https://crates.io/crates/clap).
+
+## Enable clap feature
+
+```toml
+[dependencies.mingling]
+features = ["clap"]
+ 
+[dependencies.clap]
+version = "4"
+features = ["derive", "color"]
+```
+ 
+## dispatcher_clap
+
+Add `#[dispatcher_clap]` on a `clap::Parser` struct to auto-generate a Dispatcher:
+
+```rust
+// Features: ["clap"]
+// Dependencies:
+// clap = "4"
+@@@ use mingling::macros::dispatcher_clap;
+#[derive(Default, clap::Parser, Groupped)]
+#[dispatcher_clap("greet", CMDGreet, help = true, error = ErrorGreetParsed)]
+pub struct EntryGreet {
+    #[clap(default_value = "World")]
+    name: String,
+    #[arg(short, long, default_value_t = 1)]
+    repeat: i32,
+}
+ 
+#[renderer]
+fn render_greet(greet: EntryGreet) -> RenderResult {
+    let mut r = RenderResult::new();
+    let count = greet.repeat.max(0) as usize;
+    write!(r, "Hello, ").ok();
+    for _ in 0..count {
+        write!(r, "{} ", greet.name).ok();
+    }
+    writeln!(r, "!").ok();
+    r
+}
+ 
+#[renderer]
+fn render_greet_parse_failed(err: ErrorGreetParsed) -> RenderResult {
+    let mut r = RenderResult::new();
+    writeln!(r, "{}", *err).ok();
+    r
+}
+```
+ 
+## Working with BasicProgramSetup
+
+If you need `--help` support, register `BasicProgramSetup` in main and set the clap help output mode:
+
+```rust
+// Features: ["clap"]
+// Dependencies:
+// clap = "4"
+@@@use mingling::setup::BasicProgramSetup;
+@@@use mingling::macros::dispatcher_clap;
+@@@#[derive(Default, clap::Parser, Groupped)]
+@@@#[dispatcher_clap("greet", CMDGreet)]
+@@@pub struct EntryGreet {
+@@@    name: String,
+@@@}
+@@@#[renderer]
+@@@fn render_greet(greet: EntryGreet) -> RenderResult {
+@@@    let mut r = RenderResult::new();
+@@@    write!(r, "Hello, {}!", greet.name).ok();
+@@@    r
+@@@}
+fn main() {
+    let mut program = ThisProgram::new();
+    program.with_setup(BasicProgramSetup);
+    program.stdout_setting.clap_help_print_behaviour =
+        mingling::ClapHelpPrintBehaviour::WriteToRenderResult;
+    program.with_dispatcher(CMDGreet);
+    program.exec_and_exit();
+}
+```
+ 
+See [example-clap-binding](https://mingling-rs.github.io/mingling/docs/example-viewer.html?name=example-clap-binding) for more details.
+
+<p align="center" style="font-size: 0.85em; color: gray;">
+    Written by @Weicao-CatilGrass
+</p>