mirror of
https://github.com/git/git
synced 2024-10-02 14:45:21 +00:00
Documentation: stylistically normalize references to Signed-off-by:
Ted reported an old typo in the git-commit.txt and merge-options.txt. Namely, the phrase "Signed-off-by line" was used without either a definite nor indefinite article. Upon examination, it seems that the documentation (including items in Documentation/, but also option help strings) have been quite inconsistent on usage when referring to `Signed-off-by`. First, very few places used a definite or indefinite article with the phrase "Signed-off-by line", but that was the initial typo that led to this investigation. So, normalize using either an indefinite or definite article consistently. The original phrasing, in Commit3f971fc425
(Documentation updates, 2005-08-14), is "Add Signed-off-by line". Commit6f855371a5
(Add --signoff, --check, and long option-names. 2005-12-09) switched to using "Add `Signed-off-by:` line", but didn't normalize the former commit to match. Later commits seem to have cut and pasted from one or the other, which is likely how the usage became so inconsistent. Junio stated on the git mailing list in <xmqqy2k1dfoh.fsf@gitster.c.googlers.com> a preference to leave off the colon. Thus, prefer `Signed-off-by` (with backticks) for the documentation files and Signed-off-by (without backticks) for option help strings. Additionally, Junio argued that "trailer" is now the standard term to refer to `Signed-off-by`, saying that "becomes plenty clear that we are not talking about any random line in the log message". As such, prefer "trailer" over "line" anywhere the former word fits. However, leave alone those few places in documentation that use Signed-off-by to refer to the process (rather than the specific trailer), or in places where mail headers are generally discussed in comparison with Signed-off-by. Reported-by: "Theodore Y. Ts'o" <tytso@mit.edu> Signed-off-by: Bradley M. Kuhn <bkuhn@sfconservancy.org> Acked-by: Taylor Blau <me@ttaylorr.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
This commit is contained in:
parent
a650fa7497
commit
3abd4a67d9
|
@ -249,7 +249,7 @@ component you're working on, followed by a blank line (always required) and then
|
|||
the body of your commit message, which should provide the bulk of the context.
|
||||
Remember to be explicit and provide the "Why" of your change, especially if it
|
||||
couldn't easily be understood from your diff. When editing your commit message,
|
||||
don't remove the Signed-off-by line which was added by `-s` above.
|
||||
don't remove the `Signed-off-by` trailer which was added by `-s` above.
|
||||
|
||||
----
|
||||
psuh: add a built-in by popular demand
|
||||
|
|
|
@ -209,7 +209,7 @@ send them as replies to either an additional "cover letter" message
|
|||
(see below), the first patch, or the respective preceding patch.
|
||||
|
||||
If your log message (including your name on the
|
||||
Signed-off-by line) is not writable in ASCII, make sure that
|
||||
`Signed-off-by` trailer) is not writable in ASCII, make sure that
|
||||
you send off a message in the correct encoding.
|
||||
|
||||
WARNING: Be wary of your MUAs word-wrap
|
||||
|
@ -229,7 +229,7 @@ previously sent.
|
|||
The `git format-patch` command follows the best current practice to
|
||||
format the body of an e-mail message. At the beginning of the
|
||||
patch should come your commit message, ending with the
|
||||
Signed-off-by: lines, and a line that consists of three dashes,
|
||||
`Signed-off-by` trailers, and a line that consists of three dashes,
|
||||
followed by the diffstat information and the patch itself. If
|
||||
you are forwarding a patch from somebody else, optionally, at
|
||||
the beginning of the e-mail message just before the commit
|
||||
|
@ -298,7 +298,7 @@ Do not forget to add trailers such as `Acked-by:`, `Reviewed-by:` and
|
|||
patch.
|
||||
|
||||
[[sign-off]]
|
||||
=== Certify your work by adding your "Signed-off-by: " line
|
||||
=== Certify your work by adding your `Signed-off-by` trailer
|
||||
|
||||
To improve tracking of who did what, we ask you to certify that you
|
||||
wrote the patch or have the right to pass it on under the same license
|
||||
|
@ -345,7 +345,7 @@ this:
|
|||
This line can be added by Git if you run the git-commit command with
|
||||
the -s option.
|
||||
|
||||
Notice that you can place your own Signed-off-by: line when
|
||||
Notice that you can place your own `Signed-off-by` trailer when
|
||||
forwarding somebody else's patch with the above rules for
|
||||
D-C-O. Indeed you are encouraged to do so. Do not forget to
|
||||
place an in-body "From: " line at the beginning to properly attribute
|
||||
|
@ -357,7 +357,7 @@ your patch differs from project to project, so it may be different
|
|||
from that of the project you are accustomed to.
|
||||
|
||||
[[real-name]]
|
||||
Also notice that a real name is used in the Signed-off-by: line. Please
|
||||
Also notice that a real name is used in the `Signed-off-by` trailer. Please
|
||||
don't hide your real name.
|
||||
|
||||
[[commit-trailers]]
|
||||
|
|
|
@ -79,7 +79,7 @@ format.thread::
|
|||
|
||||
format.signOff::
|
||||
A boolean value which lets you enable the `-s/--signoff` option of
|
||||
format-patch by default. *Note:* Adding the Signed-off-by: line to a
|
||||
format-patch by default. *Note:* Adding the `Signed-off-by` trailer to a
|
||||
patch should be a conscious act and means that you certify you have
|
||||
the rights to submit this work under the same open source license.
|
||||
Please see the 'SubmittingPatches' document for further discussion.
|
||||
|
|
|
@ -33,7 +33,7 @@ OPTIONS
|
|||
|
||||
-s::
|
||||
--signoff::
|
||||
Add a `Signed-off-by:` line to the commit message, using
|
||||
Add a `Signed-off-by` trailer to the commit message, using
|
||||
the committer identity of yourself.
|
||||
See the signoff option in linkgit:git-commit[1] for more information.
|
||||
|
||||
|
|
|
@ -104,7 +104,7 @@ effect to your index in a row.
|
|||
|
||||
-s::
|
||||
--signoff::
|
||||
Add Signed-off-by line at the end of the commit message.
|
||||
Add a `Signed-off-by` trailer at the end of the commit message.
|
||||
See the signoff option in linkgit:git-commit[1] for more information.
|
||||
|
||||
-S[<keyid>]::
|
||||
|
|
|
@ -119,7 +119,7 @@ include::diff-options.txt[]
|
|||
|
||||
-s::
|
||||
--signoff::
|
||||
Add `Signed-off-by:` line to the commit message, using
|
||||
Add a `Signed-off-by` trailer to the commit message, using
|
||||
the committer identity of yourself.
|
||||
See the signoff option in linkgit:git-commit[1] for more information.
|
||||
|
||||
|
|
|
@ -496,7 +496,7 @@ See also INCOMPATIBLE OPTIONS below.
|
|||
See also INCOMPATIBLE OPTIONS below.
|
||||
|
||||
--signoff::
|
||||
Add a Signed-off-by: trailer to all the rebased commits. Note
|
||||
Add a `Signed-off-by` trailer to all the rebased commits. Note
|
||||
that if `--interactive` is given then only commits marked to be
|
||||
picked, edited or reworded will have the trailer added.
|
||||
+
|
||||
|
|
|
@ -99,7 +99,7 @@ effect to your index in a row.
|
|||
|
||||
-s::
|
||||
--signoff::
|
||||
Add Signed-off-by line at the end of the commit message.
|
||||
Add a `Signed-off-by` trailer at the end of the commit message.
|
||||
See the signoff option in linkgit:git-commit[1] for more information.
|
||||
|
||||
--strategy=<strategy>::
|
||||
|
|
|
@ -313,7 +313,7 @@ Automating
|
|||
the value of `sendemail.identity`.
|
||||
|
||||
--[no-]signed-off-by-cc::
|
||||
If this is set, add emails found in Signed-off-by: or Cc: lines to the
|
||||
If this is set, add emails found in the `Signed-off-by` trailer or Cc: lines to the
|
||||
cc list. Default is the value of `sendemail.signedoffbycc` configuration
|
||||
value; if that is unspecified, default to --signed-off-by-cc.
|
||||
|
||||
|
@ -340,7 +340,7 @@ Automating
|
|||
except for self (use 'self' for that).
|
||||
- 'bodycc' will avoid including anyone mentioned in Cc lines in the
|
||||
patch body (commit message) except for self (use 'self' for that).
|
||||
- 'sob' will avoid including anyone mentioned in Signed-off-by lines except
|
||||
- 'sob' will avoid including anyone mentioned in the Signed-off-by trailers except
|
||||
for self (use 'self' for that).
|
||||
- 'misc-by' will avoid including anyone mentioned in Acked-by,
|
||||
Reviewed-by, Tested-by and other "-by" lines in the patch body,
|
||||
|
|
|
@ -701,7 +701,7 @@ creating the branch or tag.
|
|||
|
||||
--use-log-author::
|
||||
When retrieving svn commits into Git (as part of 'fetch', 'rebase', or
|
||||
'dcommit' operations), look for the first `From:` or `Signed-off-by:` line
|
||||
'dcommit' operations), look for the first `From:` line or `Signed-off-by` trailer
|
||||
in the log message and use that as the author string.
|
||||
+
|
||||
[verse]
|
||||
|
@ -710,7 +710,7 @@ config key: svn.useLogAuthor
|
|||
--add-author-from::
|
||||
When committing to svn from Git (as part of 'set-tree' or 'dcommit'
|
||||
operations), if the existing log message doesn't already have a
|
||||
`From:` or `Signed-off-by:` line, append a `From:` line based on the
|
||||
`From:` or `Signed-off-by` trailer, append a `From:` line based on the
|
||||
Git commit's author string. If you use this, then `--use-log-author`
|
||||
will retrieve a valid author string for all commits.
|
||||
+
|
||||
|
|
|
@ -164,7 +164,7 @@ can also be used to refuse the commit after inspecting the message
|
|||
file.
|
||||
|
||||
The default 'commit-msg' hook, when enabled, detects duplicate
|
||||
"Signed-off-by" lines, and aborts the commit if one is found.
|
||||
`Signed-off-by` trailers, and aborts the commit if one is found.
|
||||
|
||||
post-commit
|
||||
~~~~~~~~~~~
|
||||
|
|
|
@ -3,7 +3,7 @@ ifdef::git-commit[]
|
|||
endif::git-commit[]
|
||||
--signoff::
|
||||
--no-signoff::
|
||||
Add a Signed-off-by trailer by the committer at the end of the commit
|
||||
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
|
||||
|
|
|
@ -2237,7 +2237,7 @@ int cmd_am(int argc, const char **argv, const char *prefix)
|
|||
N_("allow fall back on 3way merging if needed")),
|
||||
OPT__QUIET(&state.quiet, N_("be quiet")),
|
||||
OPT_SET_INT('s', "signoff", &state.signoff,
|
||||
N_("add a Signed-off-by line to the commit message"),
|
||||
N_("add a Signed-off-by trailer to the commit message"),
|
||||
SIGNOFF_EXPLICIT),
|
||||
OPT_BOOL('u', "utf8", &state.utf8,
|
||||
N_("recode into utf8 (default)")),
|
||||
|
|
|
@ -1507,7 +1507,7 @@ int cmd_commit(int argc, const char **argv, const char *prefix)
|
|||
OPT_STRING(0, "fixup", &fixup_message, N_("commit"), N_("use autosquash formatted message to fixup specified commit")),
|
||||
OPT_STRING(0, "squash", &squash_message, N_("commit"), N_("use autosquash formatted message to squash specified commit")),
|
||||
OPT_BOOL(0, "reset-author", &renew_authorship, N_("the commit is authored by me now (used with -C/-c/--amend)")),
|
||||
OPT_BOOL('s', "signoff", &signoff, N_("add Signed-off-by:")),
|
||||
OPT_BOOL('s', "signoff", &signoff, N_("add a Signed-off-by trailer")),
|
||||
OPT_FILENAME('t', "template", &template_file, N_("use specified template file")),
|
||||
OPT_BOOL('e', "edit", &edit_flag, N_("force edit of commit")),
|
||||
OPT_CLEANUP(&cleanup_arg),
|
||||
|
|
|
@ -1738,7 +1738,7 @@ int cmd_format_patch(int argc, const char **argv, const char *prefix)
|
|||
OPT_CALLBACK_F('N', "no-numbered", &numbered, NULL,
|
||||
N_("use [PATCH] even with multiple patches"),
|
||||
PARSE_OPT_NOARG | PARSE_OPT_NONEG, no_numbered_callback),
|
||||
OPT_BOOL('s', "signoff", &do_signoff, N_("add Signed-off-by:")),
|
||||
OPT_BOOL('s', "signoff", &do_signoff, N_("add a Signed-off-by trailer")),
|
||||
OPT_BOOL(0, "stdout", &use_stdout,
|
||||
N_("print patches to standard out")),
|
||||
OPT_BOOL(0, "cover-letter", &cover_letter,
|
||||
|
|
|
@ -289,7 +289,7 @@ static struct option builtin_merge_options[] = {
|
|||
N_("GPG sign commit"), PARSE_OPT_OPTARG, NULL, (intptr_t) "" },
|
||||
OPT_AUTOSTASH(&autostash),
|
||||
OPT_BOOL(0, "overwrite-ignore", &overwrite_ignore, N_("update ignored files (default)")),
|
||||
OPT_BOOL(0, "signoff", &signoff, N_("add Signed-off-by:")),
|
||||
OPT_BOOL(0, "signoff", &signoff, N_("add a Signed-off-by trailer")),
|
||||
OPT_BOOL(0, "no-verify", &no_verify, N_("bypass pre-merge-commit and commit-msg hooks")),
|
||||
OPT_END()
|
||||
};
|
||||
|
|
|
@ -142,7 +142,7 @@ static struct option pull_options[] = {
|
|||
N_("add (at most <n>) entries from shortlog to merge commit message"),
|
||||
PARSE_OPT_OPTARG),
|
||||
OPT_PASSTHRU(0, "signoff", &opt_signoff, NULL,
|
||||
N_("add Signed-off-by:"),
|
||||
N_("add a Signed-off-by trailer"),
|
||||
PARSE_OPT_OPTARG),
|
||||
OPT_PASSTHRU(0, "squash", &opt_squash, NULL,
|
||||
N_("create a single commit instead of doing a merge"),
|
||||
|
|
|
@ -1324,7 +1324,7 @@ int cmd_rebase(int argc, const char **argv, const char *prefix)
|
|||
N_("do not show diffstat of what changed upstream"),
|
||||
PARSE_OPT_NOARG, NULL, REBASE_DIFFSTAT },
|
||||
OPT_BOOL(0, "signoff", &options.signoff,
|
||||
N_("add a Signed-off-by: line to each commit")),
|
||||
N_("add a Signed-off-by trailer to each commit")),
|
||||
OPT_BOOL(0, "committer-date-is-author-date",
|
||||
&options.committer_date_is_author_date,
|
||||
N_("make committer date match author date")),
|
||||
|
|
|
@ -107,7 +107,7 @@ static int run_sequencer(int argc, const char **argv, struct replay_opts *opts)
|
|||
OPT_BOOL('n', "no-commit", &opts->no_commit, N_("don't automatically commit")),
|
||||
OPT_BOOL('e', "edit", &opts->edit, N_("edit the commit message")),
|
||||
OPT_NOOP_NOARG('r', NULL),
|
||||
OPT_BOOL('s', "signoff", &opts->signoff, N_("add Signed-off-by:")),
|
||||
OPT_BOOL('s', "signoff", &opts->signoff, N_("add a Signed-off-by trailer")),
|
||||
OPT_CALLBACK('m', "mainline", opts, N_("parent-number"),
|
||||
N_("select mainline parent"), option_parse_m),
|
||||
OPT_RERERE_AUTOUPDATE(&opts->allow_rerere_auto),
|
||||
|
|
2
commit.c
2
commit.c
|
@ -1586,7 +1586,7 @@ const char *find_commit_header(const char *msg, const char *key, size_t *out_len
|
|||
|
||||
/*
|
||||
* Inspect the given string and determine the true "end" of the log message, in
|
||||
* order to find where to put a new Signed-off-by: line. Ignored are
|
||||
* order to find where to put a new Signed-off-by trailer. Ignored are
|
||||
* trailing comment lines and blank lines. To support "git commit -s
|
||||
* --amend" on an existing commit, we also ignore "Conflicts:". To
|
||||
* support "git commit -v", we truncate at cut lines.
|
||||
|
|
Loading…
Reference in a new issue