From 28db7669f4113fed431c4b4b9fa74d55e16e1ca0 Mon Sep 17 00:00:00 2001
From: Sebastian Kuzminsky <seb@highlab.com>
Date: Sat, 12 Jul 2025 14:24:20 -0600
Subject: [PATCH] ent: better `ent list --help`

---
 Cargo.toml          | 2 +-
 src/bin/ent/main.rs | 9 +++++++++
 2 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/Cargo.toml b/Cargo.toml
index af271d7..864691a 100644
--- a/Cargo.toml
+++ b/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"] }
diff --git a/src/bin/ent/main.rs b/src/bin/ent/main.rs
index 9c87234..e09b1a9 100644
--- a/src/bin/ent/main.rs
+++ b/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,
     },