]> git.ipfire.org Git - thirdparty/git.git/commitdiff
doc: patch-id: --verbatim locks in --stable
authorKristoffer Haugsbakk <code@khaugsbakk.name>
Thu, 8 Jan 2026 06:28:20 +0000 (07:28 +0100)
committerJunio C Hamano <gitster@pobox.com>
Fri, 9 Jan 2026 14:08:37 +0000 (06:08 -0800)
The default `--unstable` is a legacy format that predates `--stable`.
That’s why 2871f4d4 (builtin: patch-id: add --verbatim as a command mode,
2022-10-24) made `--verbatim` lock in[1] `--stable`:

    Users of --unstable mainly care about compatibility with old git
    versions, which unstripping the whitespace would break. Thus there
    isn't a usecase for the combination of --verbatim and --unstable,
    and we don't expose this so as to not add maintainence burden.

† 1: imply `--stable`, disallow `--unstable`

Signed-off-by: Kristoffer Haugsbakk <code@khaugsbakk.name>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git-patch-id.adoc

index 61498def317984e4f1bc94734b29be41ae53f0de..013e1a6190681befffa188f4c09971ee120dbda8 100644 (file)
@@ -32,7 +32,7 @@ OPTIONS
 
 `--verbatim`::
        Calculate the patch ID of the input as it is given, do not strip
-       any whitespace.
+       any whitespace. Implies `--stable` and forbids `--unstable`.
 +
 This is the default if `patchid.verbatim` is `true`.