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

[PATCH] replay: drop rev-list formatting options from manual

From
D. Ben Knoble <ben.knoble+github@gmail.com>
Date
Jan 20, 2026, 01:47 UTC
Message-ID
<01a7acfaf87494419b3766da57d4c05cf99c79bb.1768873599.git.ben.knoble+github@gmail.com>

The rev-list options in our manuals are quite long; git-replay's manual is no exception. Since replay doesn't use the formatting options at all (it has its own output format), drop them.

Signed-off-by: D. Ben Knoble <ben.knoble+github@gmail.com>
---
Notes (benknoble/commits):
    I noticed this while reading. It took me a minute to find the
    Asciidoc reference on multiple attributes [1] since it's not used
    elsewhere in the rev-list include :) I'm not sure it needs to be
    included in the commit message, though normally I would, personally.
    
    [1]: https://docs.asciidoctor.org/asciidoc/latest/directives/ifdef-ifndef/
 Documentation/git-replay.adoc       | 1 +
 Documentation/rev-list-options.adoc | 4 ++--
 2 files changed, 3 insertions(+), 2 deletions(-)
diff --git a/Documentation/git-replay.adoc b/Documentation/git-replay.adoc
index 4c61f3aa1f..c3b214ec69 100644
--- a/Documentation/git-replay.adoc
+++ b/Documentation/git-replay.adoc
@@ -64,6 +64,7 @@ The default mode can be configured via the `replay.refAction` configuration vari
 	range should have a single tip, so that it's clear to which tip the
 	advanced <branch> should point.
 
+:git-replay: 1
 include::rev-list-options.adoc[]
 
 [[output]]
diff --git a/Documentation/rev-list-options.adoc b/Documentation/rev-list-options.adoc
index 453ec59057..c4d7a6b989 100644
--- a/Documentation/rev-list-options.adoc
+++ b/Documentation/rev-list-options.adoc
@@ -1096,7 +1096,7 @@ endif::git-rev-list[]
 	Overrides a previous `--no-walk`.
 endif::git-shortlog[]
 
-ifndef::git-shortlog[]
+ifndef::git-shortlog,git-replay[]
 Commit Formatting
 ~~~~~~~~~~~~~~~~~
 
@@ -1265,4 +1265,4 @@ ifdef::git-rev-list[]
 	counts and print the count for equivalent commits separated
 	by a tab.
 endif::git-rev-list[]
-endif::git-shortlog[]
+endif::git-shortlog,git-replay[]

base-commit: b5c409c40f1595e3e590760c6f14a16b6683e22c
-- 
2.52.0.rc0.569.g0e1cb519e9.dirty
Next: Junio C Hamano
Message 1 of 11 in “replay: drop rev-list formatting options from manual”
  1. replay: drop rev-list formatting options from manualD. Ben Knoble, Jan 20, 2026
  2. Junio C HamanoJan 20, 2026
  3. D. Ben KnobleJan 20, 2026
  4. Junio C HamanoJan 20, 2026
  5. Junio C HamanoJan 20, 2026
  6. Junio C HamanoJan 20, 2026
  7. Jean-Noël AvilaJan 21, 2026
  8. Junio C HamanoJan 21, 2026
  9. D. Ben KnobleJan 21, 2026
  10. D. Ben KnobleJan 27, 2026
  11. replay: drop rev-list formatting options from manualD. Ben Knoble, Jan 20, 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.