update(bin): add doccomments to subcommands

Cargo.toml

@@ -38,5 +38,5 @@ thiserror = "2.0"
 vergen-gitcl = { version = "1.0", features = ["build", "cargo", "rustc", "si"] }
 
 [features]
-bin = ["anyhow", "env_logger"]
+bin = ["anyhow", "env_logger", "flatmap"]
 flatmap = ["csv"]

src/main.rs

@@ -15,13 +15,16 @@ struct Args {
 
 #[derive(Debug, Subcommand)]
 enum Commands {
+    /// Generate register interface code.
     Generate {
         /// Output directory.
         out: path::PathBuf,
     },
+    /// Generate flattened register map in CSV.
     #[cfg(feature = "flatmap")]
     Flatmap {
         /// Flattened csv out path.
+        /// Print to stdout by default.
         flatmap: Option<path::PathBuf>,
     },
 }