git/list[1] front-page[2] threads[3] people[4] search[5] about
 

[PATCH v2 1/3] credential: make -h output and SYNOPSIS agree

From
WEWasswa Edson <edsonwasswa54@gmail.com>
Date
Nov 14, 2026, 18:47 UTC
Message-ID
<20261114184752.1417-2-edsonwasswa54@gmail.com>
In-Reply-To
<20261114184752.1417-1-edsonwasswa54@gmail.com>

The usage string of "git credential" does not mention the "capability" subcommand, even though it is documented and implemented. The SYNOPSIS in its documentation does list it, but is written as a plain literal block instead of using [verse], so t0450 cannot extract it, and "credential" has been listed as a known mismatch between the "-h" output and the documentation.

Add "capability" to the usage string, mark the SYNOPSIS as [verse], and drop "credential" from the list of known mismatches.

Signed-off-by: Wasswa Edson <edsonwasswa54@gmail.com>
---
 Documentation/git-credential.adoc | 3 +--
 builtin/credential.c              | 2 +-
 t/t0450/adoc-help-mismatches      | 1 -
 3 files changed, 2 insertions(+), 4 deletions(-)
diff --git a/Documentation/git-credential.adoc b/Documentation/git-credential.adoc
index e41493292f..e12d429f43 100644
--- a/Documentation/git-credential.adoc
+++ b/Documentation/git-credential.adoc
@@ -7,9 +7,8 @@ git-credential - Retrieve and store user credentials
 
 SYNOPSIS
 --------
-------------------
+[verse]
 'git credential' (fill|approve|reject|capability)
-------------------
 
 DESCRIPTION
 -----------
diff --git a/builtin/credential.c b/builtin/credential.c
index a295c80b36..72e7b2af4e 100644
--- a/builtin/credential.c
+++ b/builtin/credential.c
@@ -7,7 +7,7 @@
 #include "config.h"
 
 static const char usage_msg[] =
-	"git credential (fill|approve|reject)";
+	"git credential (fill|approve|reject|capability)";
 
 int cmd_credential(int argc,
 		   const char **argv,
diff --git a/t/t0450/adoc-help-mismatches b/t/t0450/adoc-help-mismatches
index baf3b1d809..939e47bf3a 100644
--- a/t/t0450/adoc-help-mismatches
+++ b/t/t0450/adoc-help-mismatches
@@ -9,7 +9,6 @@ checkout
 checkout-index
 clone
 column
-credential
 credential-cache
 credential-store
 fetch-pack
-- 
2.53.0
Previous: Wasswa EdsonNext: Wasswa Edson
Message 4 of 6 in “credential: parse subcommands with OPT_SUBCOMMAND”
  1. credential: parse subcommands with OPT_SUBCOMMANDWasswa Edson, Nov 4, 2026
  2. Tanga JorisNov 8, 2026
  3. 0/3 credential: parse subcommands with OPT_SUBCOMMANDWasswa Edson, Nov 14, 2026
  4. 1/3 credential: make -h output and SYNOPSIS agreeWasswa Edson, Nov 14, 2026
  5. 2/3 credential: move each subcommand into its own functionWasswa Edson, Nov 14, 2026
  6. 3/3 credential: parse subcommands with OPT_SUBCOMMANDWasswa Edson, Nov 14, 2026

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.