]> git.ipfire.org Git - thirdparty/git.git/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 4c61f3aa1f1c707eecf77bc91a216d3d3f021eda..c3b214ec6964c71c8f134cf69c7f0d69566a2c40 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 453ec590571ffced37db55f27c4eb473c77633c6..c4d7a6b989fd0f92542e40dde0ee35c6765f8dd7 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[]