git-commit-vandalism/Documentation/signoff-option.txt

ifdef::git-commit[]
-s::
endif::git-commit[]
--signoff::
--no-signoff::
	Add a Signed-off-by trailer by the committer at the end of the commit
	log message.  The meaning of a signoff depends on the project
	to which you're committing.  For example, it may certify that
	the committer has the rights to submit the work under the
	project's license or agrees to some contributor representation,
	such as a Developer Certificate of Origin.
	(See http://developercertificate.org for the one used by the
	Linux kernel and Git projects.)  Consult the documentation or
	leadership of the project to which you're contributing to
	understand how the signoffs are used in that project.
+
The --no-signoff option can be used to countermand an earlier --signoff
option on the command line.
doc: preparatory clean-up of description on the sign-off option Almost identical text on the signed-off-by trailer appears in the documentation for "git commit" and "git merge" and its friends. Introduce a new signoff-option.txt file to be shared. A couple of things of note are: - The short-form "-s" is available only in "git commit", but not in commands that are friends of "git merge", as it is used as a short-hand for "--strategy". - The original lacks description on the negated "--no-signoff" form on "git commit" side, but it equally is applicable. It however was unclear in the original text that not adding a Signed-off-by trailer is the default, so rephrase to explain it as a way to countermand a --signoff option that appeared earlier on the same command line. This is in preparation to apply a further clarification on what exactly the Signed-off-by trailer means. Suggested-by: Philippe Blain <levraiphilippeblain@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com> Reviewed-by: Taylor Blau <me@ttaylorr.com> Reviewed-by: Bradley M. Kuhn <bkuhn@sfconservancy.org> Signed-off-by: Junio C Hamano <gitster@pobox.com> 2020-10-20 03:03:52 +02:00			`ifdef::git-commit[]`
			`-s::`
			`endif::git-commit[]`
			`--signoff::`
			`--no-signoff::`
Documentation: clarify and expand description of --signoff Building on past documentation improvements in b2c150d3aa (Expand documentation describing --signoff, 2016-01-05), further clarify that any project using Git may and often does set its own policy. However, leave intact reference to the Linux DCO, which Git also uses. It is reasonable for Git to advocate for its own Signed-off-by methodology in its documentation, as long as the documentation remains respectful that YMMV and other projects may well have very different contributor representations tied to Signed-off-by. Signed-off-by: Bradley M. Kuhn <bkuhn@sfconservancy.org> Signed-off-by: Junio C Hamano <gitster@pobox.com> Signed-off-by: Jeff King <peff@peff.net> Reviewed-by: Taylor Blau <me@ttaylorr.com> Signed-off-by: Junio C Hamano <gitster@pobox.com> 2020-10-20 03:03:53 +02:00			`Add a Signed-off-by trailer by the committer at the end of the commit`
			`log message. The meaning of a signoff depends on the project`
			`to which you're committing. For example, it may certify that`
			`the committer has the rights to submit the work under the`
			`project's license or agrees to some contributor representation,`
			`such as a Developer Certificate of Origin.`
			`(See http://developercertificate.org for the one used by the`
			`Linux kernel and Git projects.) Consult the documentation or`
			`leadership of the project to which you're contributing to`
			`understand how the signoffs are used in that project.`
doc: preparatory clean-up of description on the sign-off option Almost identical text on the signed-off-by trailer appears in the documentation for "git commit" and "git merge" and its friends. Introduce a new signoff-option.txt file to be shared. A couple of things of note are: - The short-form "-s" is available only in "git commit", but not in commands that are friends of "git merge", as it is used as a short-hand for "--strategy". - The original lacks description on the negated "--no-signoff" form on "git commit" side, but it equally is applicable. It however was unclear in the original text that not adding a Signed-off-by trailer is the default, so rephrase to explain it as a way to countermand a --signoff option that appeared earlier on the same command line. This is in preparation to apply a further clarification on what exactly the Signed-off-by trailer means. Suggested-by: Philippe Blain <levraiphilippeblain@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com> Reviewed-by: Taylor Blau <me@ttaylorr.com> Reviewed-by: Bradley M. Kuhn <bkuhn@sfconservancy.org> Signed-off-by: Junio C Hamano <gitster@pobox.com> 2020-10-20 03:03:52 +02:00			`+`
			`The --no-signoff option can be used to countermand an earlier --signoff`
			`option on the command line.`