]> Kevux Git Server - rit/commitdiff
replay: drop rev-list formatting options from manual
authorD. Ben Knoble <ben.knoble+github@gmail.com>
Tue, 20 Jan 2026 14:05:57 +0000 (09:05 -0500)
committerJunio C Hamano <gitster@pobox.com>
Tue, 20 Jan 2026 17:38:56 +0000 (09:38 -0800)
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.

This is the first time we have needed compound tests [1] for if[n]def in
our documentation:

    git grep '^ifn\?def::' Documentation | grep '[,+]'

[1]: https://docs.asciidoctor.org/asciidoc/latest/directives/ifdef-ifndef/

For both ifdef and ifndef, the "," takes on the intuitive meaning:
- ifdef: if any of the listed attributes are set…
- ifndef: unless any of the listed attributes are set

(Use "+" for "all".)

Signed-off-by: D. Ben Knoble <ben.knoble+github@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git-replay.adoc
Documentation/rev-list-options.adoc

index 4c61f3a..c3b214e 100644 (file)
@@ -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]]
index 453ec59..c4d7a6b 100644 (file)
@@ -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[]