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

[PATCH 2/2] bisect: document command line arguments for "bisect start"

From
Junio C Hamano <gitster@pobox.com>
Date
Feb 7, 2024, 21:44 UTC
Message-ID
<20240207214436.538586-3-gitster@pobox.com>
In-Reply-To
<20240207214436.538586-1-gitster@pobox.com>

The syntax commonly used for alternatives is --opt-(a|b), not --opt-{a,b}.

List bad/new and good/old consistently in this order, to be consistent with the description for "git bisect terms". Clarify <term> to either <term-old> or <term-new> to make them consistent with the description of "git bisect (good|bad)" subcommands.

Suggested-by: Matthieu Moy <git@matthieu-moy.fr>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
---
 Documentation/git-bisect.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/Documentation/git-bisect.txt b/Documentation/git-bisect.txt
index 3d813f9c77..73f889b97b 100644
--- a/Documentation/git-bisect.txt
+++ b/Documentation/git-bisect.txt
@@ -16,7 +16,7 @@ DESCRIPTION
 The command takes various subcommands, and different options depending
 on the subcommand:
 
- git bisect start [--term-{new,bad}=<term> --term-{old,good}=<term>]
+ git bisect start [--term-(bad|new)=<term-new> --term-(good|old)=<term-old>]
 		  [--no-checkout] [--first-parent] [<bad> [<good>...]] [--] [<paths>...]
  git bisect (bad|new|<term-new>) [<rev>]
  git bisect (good|old|<term-old>) [<rev>...]
-- 
2.43.0-561-g235986be82
Previous: Junio C HamanoNext: Jean-Noël Avila
Message 9 of 11 in “[BUG] git-bisect man page description of terms command doesn't mention old/new support”
  1. Britton KerinDec 9, 2023
  2. Re* [BUG] git-bisect man page description of terms command doesn't mention old/new supportJunio C Hamano, Dec 9, 2023
  3. Matthieu MoyDec 11, 2023
  4. Junio C HamanoDec 11, 2023
  5. 0/2 minute "git bisect" doc updatesJunio C Hamano, Feb 7, 2024
  6. 1/2 bisect: document "terms" subcommand more fullyJunio C Hamano, Feb 7, 2024
  7. Kristoffer HaugsbakkFeb 8, 2024
  8. Junio C HamanoFeb 8, 2024
  9. 2/2 bisect: document command line arguments for "bisect start"Junio C Hamano, Feb 7, 2024
  10. Jean-Noël AvilaFeb 8, 2024
  11. Christian CouderFeb 9, 2024

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.