]> git.99rst.org Git - git.git/commitdiff
doc: diff-options.adoc: show format.noprefix for format-patch
authorKristoffer Haugsbakk <redacted>
Mon, 23 Feb 2026 23:30:51 +0000 (00:30 +0100)
committerJunio C Hamano <redacted>
Mon, 23 Feb 2026 23:55:19 +0000 (15:55 -0800)
git-format-patch(1) uses `format.noprefix` and ignores `diff.noprefix`.

The configuration variable `format.prefix` was added as an “escape
hatch”, and “it’s unlikely that anybody really wants format.
noprefix=true in the first place.”[1] Based on that there doesn’t
seem to be a need to widely advertise this configuration variable.

But in any case: the documentation for this option should not claim
that it overrides a config that is always ignored.

† 1: 8d5213de (format-patch: add format.noprefix option, 2023-03-09)

Signed-off-by: Kristoffer Haugsbakk <redacted>
Signed-off-by: Junio C Hamano <redacted>
Documentation/diff-options.adoc

index 9cdad6f72a0c7d9186166c3d8789c531732b74ea..8f632d5fe1a71cba9ca1a287bdcb8c41e592fb85 100644 (file)
@@ -860,7 +860,9 @@ endif::git-format-patch[]
 
 `--default-prefix`::
        Use the default source and destination prefixes ("a/" and "b/").
-       This overrides configuration variables such as `diff.noprefix`,
+       This overrides configuration variables such as
+ifndef::git-format-patch[`diff.noprefix`,]
+ifdef::git-format-patch[`format.noprefix`,]
        `diff.srcPrefix`, `diff.dstPrefix`, and `diff.mnemonicPrefix`
        (see linkgit:git-config[1]).
 
git clone https://git.99rst.org/PROJECT