From 6296dca5f934eda30ec9a78ece9d23af2e6c0e84 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Sun, 22 Mar 2026 01:12:33 +0000
Subject: [PATCH 1/3] Initial plan


From 7ef3c1615dfac14978be2ccd511caec5ccc310d8 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Sun, 22 Mar 2026 01:16:49 +0000
Subject: [PATCH 2/3] Promote -q/--quiet flag from -H help to -h help display

Co-authored-by: tats-u <12870451+tats-u@users.noreply.github.com>
Agent-Logs-Url: https://github.com/tats-u/zstd/sessions/4ef2780f-a5e0-42fc-b9b6-4a9c0c47fd74
---
 programs/zstdcli.c                        | 4 ++--
 tests/cli-tests/basic/help.sh.stdout.glob | 1 +
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/programs/zstdcli.c b/programs/zstdcli.c
index 31b06d67be5..2b38387f549 100644
--- a/programs/zstdcli.c
+++ b/programs/zstdcli.c
@@ -170,7 +170,8 @@ static void usage(FILE* f, const char* programName)
     DISPLAY_F(f, "  -f, --force                   Disable input and output checks. Allows overwriting existing files,\n");
     DISPLAY_F(f, "                                receiving input from the console, printing output to STDOUT, and\n");
     DISPLAY_F(f, "                                operating on links, block devices, etc. Unrecognized formats will be\n");
-    DISPLAY_F(f, "                                passed-through through as-is.\n\n");
+    DISPLAY_F(f, "                                passed-through through as-is.\n");
+    DISPLAY_F(f, "  -q, --quiet                   Suppress warnings; pass twice to suppress errors.\n\n");
 
     DISPLAY_F(f, "  -h                            Display short usage and exit.\n");
     DISPLAY_F(f, "  -H, --help                    Display full help and exit.\n");
@@ -186,7 +187,6 @@ static void usageAdvanced(const char* programName)
     DISPLAYOUT("Advanced options:\n");
 
     DISPLAYOUT("  -v, --verbose                 Enable verbose output; pass multiple times to increase verbosity.\n");
-    DISPLAYOUT("  -q, --quiet                   Suppress warnings; pass twice to suppress errors.\n");
 #ifndef ZSTD_NOTRACE
     DISPLAYOUT("  --trace LOG                   Log tracing information to LOG.\n");
 #endif
diff --git a/tests/cli-tests/basic/help.sh.stdout.glob b/tests/cli-tests/basic/help.sh.stdout.glob
index 08cfdb1b348..c70587e2f5a 100644
--- a/tests/cli-tests/basic/help.sh.stdout.glob
+++ b/tests/cli-tests/basic/help.sh.stdout.glob
@@ -20,6 +20,7 @@ Options:
                                 receiving input from the console, printing output to STDOUT, and
                                 operating on links, block devices, etc. Unrecognized formats will be
                                 passed-through through as-is.
+  -q, --quiet                   Suppress warnings; pass twice to suppress errors.
 
   -h                            Display short usage and exit.
   -H, --help                    Display full help and exit.

From 0fc7659560606198a189eb3921169f90184b2e0e Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Sun, 22 Mar 2026 01:27:48 +0000
Subject: [PATCH 3/3] Promote -v/--verbose to -h help display alongside
 -q/--quiet

Co-authored-by: tats-u <12870451+tats-u@users.noreply.github.com>
Agent-Logs-Url: https://github.com/tats-u/zstd/sessions/5d2ca937-0c61-458f-bc5f-5ba7dcc491c6
---
 programs/zstdcli.c                        | 4 ++--
 tests/cli-tests/basic/help.sh.stdout.glob | 1 +
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/programs/zstdcli.c b/programs/zstdcli.c
index 2b38387f549..1135fb822bd 100644
--- a/programs/zstdcli.c
+++ b/programs/zstdcli.c
@@ -171,7 +171,8 @@ static void usage(FILE* f, const char* programName)
     DISPLAY_F(f, "                                receiving input from the console, printing output to STDOUT, and\n");
     DISPLAY_F(f, "                                operating on links, block devices, etc. Unrecognized formats will be\n");
     DISPLAY_F(f, "                                passed-through through as-is.\n");
-    DISPLAY_F(f, "  -q, --quiet                   Suppress warnings; pass twice to suppress errors.\n\n");
+    DISPLAY_F(f, "  -q, --quiet                   Suppress warnings; pass twice to suppress errors.\n");
+    DISPLAY_F(f, "  -v, --verbose                 Enable verbose output; pass multiple times to increase verbosity.\n\n");
 
     DISPLAY_F(f, "  -h                            Display short usage and exit.\n");
     DISPLAY_F(f, "  -H, --help                    Display full help and exit.\n");
@@ -186,7 +187,6 @@ static void usageAdvanced(const char* programName)
     usage(stdout, programName);
     DISPLAYOUT("Advanced options:\n");
 
-    DISPLAYOUT("  -v, --verbose                 Enable verbose output; pass multiple times to increase verbosity.\n");
 #ifndef ZSTD_NOTRACE
     DISPLAYOUT("  --trace LOG                   Log tracing information to LOG.\n");
 #endif
diff --git a/tests/cli-tests/basic/help.sh.stdout.glob b/tests/cli-tests/basic/help.sh.stdout.glob
index c70587e2f5a..59e69db24e0 100644
--- a/tests/cli-tests/basic/help.sh.stdout.glob
+++ b/tests/cli-tests/basic/help.sh.stdout.glob
@@ -21,6 +21,7 @@ Options:
                                 operating on links, block devices, etc. Unrecognized formats will be
                                 passed-through through as-is.
   -q, --quiet                   Suppress warnings; pass twice to suppress errors.
+  -v, --verbose                 Enable verbose output; pass multiple times to increase verbosity.
 
   -h                            Display short usage and exit.
   -H, --help                    Display full help and exit.