]> Kevux Git Server - rit/commitdiff
doc: diff-options.adoc: show format.noprefix for format-patch
authorKristoffer Haugsbakk <code@khaugsbakk.name>
Mon, 23 Feb 2026 23:30:51 +0000 (00:30 +0100)
committerJunio C Hamano <gitster@pobox.com>
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 <code@khaugsbakk.name>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
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]).