From 1129780f6ab19f0a295c0b436890c510f71024f4 Mon Sep 17 00:00:00 2001 From: Junio C Hamano Date: Wed, 17 Dec 2025 03:54:15 +0900 Subject: [PATCH 1/2] commit: document that $command.signoff will not be added Every now and then we see this coming up on the list. Let's help new contributors who are not aware of past discussions by clearly documenting our past consensus. Helped-by: brian m. carlson Helped-by: Elijah Newren Helped-by: Johannes Sixt Signed-off-by: Junio C Hamano --- Documentation/gitfaq.adoc | 19 +++++++++++++++++++ Documentation/signoff-option.adoc | 4 ++++ 2 files changed, 23 insertions(+) diff --git a/Documentation/gitfaq.adoc b/Documentation/gitfaq.adoc index f2917d142c..8d3647d359 100644 --- a/Documentation/gitfaq.adoc +++ b/Documentation/gitfaq.adoc @@ -83,6 +83,25 @@ Windows would be the configuration `"C:\Program Files\Vim\gvim.exe" --nofork`, which quotes the filename with spaces and specifies the `--nofork` option to avoid backgrounding the process. +[[sign-off]] +Why not have `commit.signoff` and other configuration variables?:: + Git intentionally does not (and will not) provide a + configuration variable, such as `commit.signoff`, to + automatically add `--signoff` by default. The reason is to + protect the legal and intentional significance of a sign-off. + If there were more automated and widely publicized ways for + sign-offs to be appended, it would become easier for someone + to argue later that a "Signed-off-by" trailer was just added + out of habit or by automation, without the committer's full + awareness or intent to certify their agreement with the + Developer Certificate of Origin (DCO) or a similar statement. + This could undermine the sign-off’s credibility in legal or + contractual situations. ++ +There exists `format.signoff`, but that is a historical mistake, and +it is not an excuse to add more mistakes of the same kind on top. + + Credentials ----------- diff --git a/Documentation/signoff-option.adoc b/Documentation/signoff-option.adoc index cddfb225d1..9a80d60f1b 100644 --- a/Documentation/signoff-option.adoc +++ b/Documentation/signoff-option.adoc @@ -16,3 +16,7 @@ endif::git-commit[] + The `--no-signoff` option can be used to countermand an earlier `--signoff` option on the command line. ++ +Git does not (and will not) have a configuration variable to enable +the `--signoff` command line option by default; see the +`commit.signoff` entry in the gitfaq for more details. From a0c813951afc4bbf5978e67201bccd8d20e9b36b Mon Sep 17 00:00:00 2001 From: Junio C Hamano Date: Fri, 19 Dec 2025 21:51:01 +0900 Subject: [PATCH 2/2] signoff-option: linkify the reference to gitfaq The GitFAQ is a proper manual page in the section 7, so refer to it using the usual linkgit:stuff[7] syntax. Helped-by: Kristoffer Haugsbakk Signed-off-by: Junio C Hamano --- Documentation/signoff-option.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/signoff-option.adoc b/Documentation/signoff-option.adoc index 9a80d60f1b..6fc2769257 100644 --- a/Documentation/signoff-option.adoc +++ b/Documentation/signoff-option.adoc @@ -19,4 +19,4 @@ option on the command line. + Git does not (and will not) have a configuration variable to enable the `--signoff` command line option by default; see the -`commit.signoff` entry in the gitfaq for more details. +`commit.signoff` entry in linkgit:gitfaq[7] for more details.