fix docs

Signed-off-by: Jess Frazelle <[email protected]>

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "zoo"
-version = "0.2.86"
+version = "0.2.87"
 edition = "2021"
 build = "build.rs"
 # See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html

src/cmd_generate.rs

@@ -53,11 +53,17 @@ impl crate::cmd::Command for CmdGenerateMarkdown {
 
 impl CmdGenerateMarkdown {
     fn generate(&self, ctx: &mut crate::context::Context, app: &Command, parent: &str) -> Result<()> {
+        let name = app.get_name();
+        if name == "help" {
+            // Skip the help command.
+            return Ok(());
+        }
+
         let mut p = parent.to_string();
         if !p.is_empty() {
-            p = format!("{}_{}", p, app.get_name());
+            p = format!("{}_{}", p, name);
         } else {
-            p = app.get_name().to_string();
+            p = name.to_string();
         }
 
         let filename = format!("{p}.md");

src/docs_markdown.rs

@@ -47,13 +47,17 @@ fn do_markdown(doc: &mut MarkdownDocument, app: &Command, title: &str) -> Result
         doc.paragraph(about.to_string());
     }
 
-    if app.has_subcommands() {
+    let sub_commands = app
+        .get_subcommands()
+        .filter(|c| c.get_name() != "help")
+        .collect::<Vec<&Command>>();
+    if !sub_commands.is_empty() {
         doc.header("Subcommands".to_string(), pulldown_cmark::HeadingLevel::H3);
 
         doc.0
             .push(pulldown_cmark::Event::Start(pulldown_cmark::Tag::List(None)));
 
-        for cmd in app.get_subcommands() {
+        for cmd in sub_commands {
             doc.link_in_list(
                 format!("{} {}", title, cmd.get_name()),
                 format!("./{}_{}", title.replace(' ', "_"), cmd.get_name()),
@@ -64,6 +68,7 @@ fn do_markdown(doc: &mut MarkdownDocument, app: &Command, title: &str) -> Result
     }
 
     let args = app.get_arguments().collect::<Vec<&clap::Arg>>();
+    println!("args: {:?}", args);
     if !args.is_empty() {
         doc.header("Options".to_string(), pulldown_cmark::HeadingLevel::H3);