fix: document missing capture help flags

Author: seasonyuu

crates/dsview-cli/src/main.rs

@@ -71,21 +71,42 @@ struct ListArgs {
 struct OpenArgs {
     #[command(flatten)]
     runtime: SharedRuntimeArgs,
-    #[arg(long, value_name = "HANDLE")]
+    #[arg(
+        long,
+        value_name = "HANDLE",
+        help = "Selection handle returned by `devices list`"
+    )]
     handle: u64,
 }
 
 #[derive(Args, Debug)]
 struct CaptureArgs {
     #[command(flatten)]
     runtime: SharedRuntimeArgs,
-    #[arg(long, value_name = "HANDLE")]
+    #[arg(
+        long,
+        value_name = "HANDLE",
+        help = "Selection handle returned by `devices list`"
+    )]
     handle: u64,
-    #[arg(long = "sample-rate-hz", value_name = "HZ")]
+    #[arg(
+        long = "sample-rate-hz",
+        value_name = "HZ",
+        help = "Requested capture sample rate in hertz"
+    )]
     sample_rate_hz: u64,
-    #[arg(long = "sample-limit", value_name = "SAMPLES")]
+    #[arg(
+        long = "sample-limit",
+        value_name = "SAMPLES",
+        help = "Requested sample count before the finite capture stops"
+    )]
     sample_limit: u64,
-    #[arg(long = "channels", value_delimiter = ',', value_name = "IDX[,IDX...]")]
+    #[arg(
+        long = "channels",
+        value_delimiter = ',',
+        value_name = "IDX[,IDX...]",
+        help = "Comma-separated logic channel indexes to enable, for example 0,1,2,3"
+    )]
     channels: Vec<u16>,
     #[arg(
         long = "output",
@@ -99,9 +120,17 @@ struct CaptureArgs {
         help = "Optional metadata JSON path; defaults to the VCD path with a .json extension"
     )]
     metadata_output: Option<PathBuf>,
-    #[arg(long = "wait-timeout-ms", default_value_t = 10_000)]
+    #[arg(
+        long = "wait-timeout-ms",
+        default_value_t = 10_000,
+        help = "Maximum time to wait for capture completion before aborting"
+    )]
     wait_timeout_ms: u64,
-    #[arg(long = "poll-interval-ms", default_value_t = 50)]
+    #[arg(
+        long = "poll-interval-ms",
+        default_value_t = 50,
+        help = "Polling interval for checking capture progress while waiting"
+    )]
     poll_interval_ms: u64,
 }
 

crates/dsview-cli/tests/capture_cli.rs

@@ -14,8 +14,20 @@ fn capture_help_mentions_bundled_resource_override_and_artifact_controls() {
         .success()
         .stdout(predicate::str::contains("--resource-dir <PATH>"))
         .stdout(predicate::str::contains("bundled resources are used by default"))
+        .stdout(predicate::str::contains("--handle <HANDLE>"))
+        .stdout(predicate::str::contains("Selection handle returned by `devices list`"))
+        .stdout(predicate::str::contains("--sample-rate-hz <HZ>"))
+        .stdout(predicate::str::contains("Requested capture sample rate in hertz"))
+        .stdout(predicate::str::contains("--sample-limit <SAMPLES>"))
+        .stdout(predicate::str::contains("Requested sample count before the finite capture stops"))
+        .stdout(predicate::str::contains("--channels <IDX[,IDX...]>"))
+        .stdout(predicate::str::contains("Comma-separated logic channel indexes to enable"))
         .stdout(predicate::str::contains("--output <PATH>"))
         .stdout(predicate::str::contains("--metadata-output <PATH>"))
+        .stdout(predicate::str::contains("--wait-timeout-ms <WAIT_TIMEOUT_MS>"))
+        .stdout(predicate::str::contains("Maximum time to wait for capture completion before aborting"))
+        .stdout(predicate::str::contains("--poll-interval-ms <POLL_INTERVAL_MS>"))
+        .stdout(predicate::str::contains("Polling interval for checking capture progress while waiting"))
         .stdout(predicate::str::contains("json is stable for automation"))
         .stdout(predicate::str::contains("must end with .vcd"))
         .stdout(predicate::str::contains("defaults to the VCD path with a .json extension"))