summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--Documentation/gitfaq.adoc19
-rw-r--r--Documentation/signoff-option.adoc4
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.