ent: better ent list --help

Cargo.toml

@@ -10,7 +10,7 @@ log = ["dep:log", "dep:simple_logger"]
 [dependencies]
 anyhow = "1.0.95"
 chrono = "0.4.41"
-clap = { version = "4.5.26", features = ["derive"] }
+clap = { version = "4.5.26", features = ["derive", "wrap_help"] }
 log = { version = "0.4.27", optional = true }
 rand = "0.9.1"
 serde = { version = "1.0.217", features = ["derive"] }

src/bin/ent/main.rs

@@ -25,6 +25,15 @@ enum Commands {
     /// List issues.
     List {
         /// Filter string, describes issues to include in the list.
+        /// The filter string is composed of chunks separated by ":".
+        /// Each chunk is of the form "name=condition".  The supported
+        /// names and their matching conditions are:
+        ///
+        /// "state": Comma-separated list of states to list.
+        ///
+        /// "assignee": Comma-separated list of assignees to list.
+        /// Defaults to all assignees if not set.
+        ///
         #[arg(default_value_t = String::from("state=New,Backlog,Blocked,InProgress"))]
         filter: String,
     },