From c19dac5aef9d54a3146cbaffba3aeba98ab42c6a Mon Sep 17 00:00:00 2001
From: Nils Andreas Svee <me@lochnair.net>
Date: Wed, 13 May 2026 21:36:30 +0700
Subject: [PATCH] docs(irtt-cli): expand duration flag documentation

Add detailed help text to clarify the difference in statistics handling between finite and continuous test modes.
---
 crates/irtt-cli/src/lib.rs | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/crates/irtt-cli/src/lib.rs b/crates/irtt-cli/src/lib.rs
index c9df4b6..d4a6fc8 100644
--- a/crates/irtt-cli/src/lib.rs
+++ b/crates/irtt-cli/src/lib.rs
@@ -24,8 +24,13 @@ pub struct CliArgs {
     /// Server address or host, with optional port.
     pub server: String,
 
-    /// Test duration; use 0 for continuous mode.
-    #[arg(long, default_value = "10s", value_parser = parse_test_duration)]
+    #[arg(
+        long,
+        default_value = "10s",
+        value_parser = parse_test_duration,
+        help = "Test duration; use 0 for continuous mode",
+        long_help = "Test duration; use 0 for continuous mode.\n\nFinite runs retain exact statistics for final summaries. Continuous mode uses bounded-memory running statistics and does not print a finite summary."
+    )]
     pub duration: Duration,
 
     /// Probe interval.