diff options
| author | Junio C Hamano <gitster@pobox.com> | 2025-12-28 17:36:16 +0900 |
|---|---|---|
| committer | Junio C Hamano <gitster@pobox.com> | 2025-12-28 17:36:16 +0900 |
| commit | 86862bf287a09bba5243eb8a87878ec0d77aac7f (patch) | |
| tree | 494de2ef8a58d40cc8b43862afc9f7e0d4b69f9f /Documentation | |
| parent | c744b2c16ac7fcef617d60c01c51a681646445f3 (diff) | |
| parent | a0c813951afc4bbf5978e67201bccd8d20e9b36b (diff) | |
Merge branch 'jc/doc-commit-signoff-config'
Documentation update.
* jc/doc-commit-signoff-config:
signoff-option: linkify the reference to gitfaq
commit: document that $command.signoff will not be added
Diffstat (limited to 'Documentation')
| -rw-r--r-- | Documentation/gitfaq.adoc | 19 | ||||
| -rw-r--r-- | Documentation/signoff-option.adoc | 4 |
2 files changed, 23 insertions, 0 deletions
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..6fc2769257 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 linkgit:gitfaq[7] for more details. |