* [PATCH] Documentation/SubmittingPatches: add quotes to advised commit reference
@ 2016-08-26 22:27 Stefan Beller
2016-08-26 22:42 ` Junio C Hamano
0 siblings, 1 reply; 6+ messages in thread
From: Stefan Beller @ 2016-08-26 22:27 UTC (permalink / raw)
To: gitster; +Cc: git, hvoigt, dev+git, Stefan Beller
Junio finds it is easier to read text when the commit subject is quoted.
Signed-off-by: Stefan Beller <sbeller@google.com>
---
Documentation/SubmittingPatches | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/Documentation/SubmittingPatches b/Documentation/SubmittingPatches
index 500230c..a591229 100644
--- a/Documentation/SubmittingPatches
+++ b/Documentation/SubmittingPatches
@@ -123,7 +123,7 @@ archive, summarize the relevant points of the discussion.
If you want to reference a previous commit in the history of a stable
branch use the format "abbreviated sha1 (subject, date)". So for example
-like this: "Commit f86a374 (pack-bitmap.c: fix a memleak, 2015-03-30)
+like this: "Commit f86a374 ("pack-bitmap.c: fix a memleak", 2015-03-30)
noticed [...]".
--
2.10.0.rc1.1.g1ceb01a
^ permalink raw reply related [flat|nested] 6+ messages in thread
* Re: [PATCH] Documentation/SubmittingPatches: add quotes to advised commit reference
2016-08-26 22:27 [PATCH] Documentation/SubmittingPatches: add quotes to advised commit reference Stefan Beller
@ 2016-08-26 22:42 ` Junio C Hamano
2016-08-26 22:45 ` Stefan Beller
` (2 more replies)
0 siblings, 3 replies; 6+ messages in thread
From: Junio C Hamano @ 2016-08-26 22:42 UTC (permalink / raw)
To: Stefan Beller; +Cc: git, hvoigt, dev+git
Stefan Beller <sbeller@google.com> writes:
> Junio finds it is easier to read text when the commit subject is quoted.
>
> Signed-off-by: Stefan Beller <sbeller@google.com>
> ---
> Documentation/SubmittingPatches | 2 +-
> 1 file changed, 1 insertion(+), 1 deletion(-)
>
> diff --git a/Documentation/SubmittingPatches b/Documentation/SubmittingPatches
> index 500230c..a591229 100644
> --- a/Documentation/SubmittingPatches
> +++ b/Documentation/SubmittingPatches
> @@ -123,7 +123,7 @@ archive, summarize the relevant points of the discussion.
>
> If you want to reference a previous commit in the history of a stable
> branch use the format "abbreviated sha1 (subject, date)". So for example
> -like this: "Commit f86a374 (pack-bitmap.c: fix a memleak, 2015-03-30)
> +like this: "Commit f86a374 ("pack-bitmap.c: fix a memleak", 2015-03-30)
> noticed [...]".
Thanks, but it is not sufficient as you would not see the need for
quoting without the example.
My preference is not a main deciding factor in this case anyway. A
more important reason why it makes sense to quote (aside from the
fact that it makes more sense when reading) is because we already
have a tool support for that.
Perhaps something like this instead?
-- >8 --
From: Beat Bolli <dev+git@drbeat.li>
Subject: SubmittingPatches: use gitk's "Copy commit summary" format
Date: Fri, 26 Aug 2016 18:59:01 +0200
Update the suggestion in 175d38ca ("SubmittingPatches: document how
to reference previous commits", 2016-07-28) on the format to refer
to a commit to match what gitk has been giving since last year with
its "Copy commit summary" command; also mention this as one of the
ways to obtain a commit reference in this format.
Signed-off-by: Beat Bolli <dev+git@drbeat.li>
---
Documentation/SubmittingPatches | 11 ++++++++---
1 file changed, 8 insertions(+), 3 deletions(-)
diff --git a/Documentation/SubmittingPatches b/Documentation/SubmittingPatches
index 500230c..15adb86 100644
--- a/Documentation/SubmittingPatches
+++ b/Documentation/SubmittingPatches
@@ -122,9 +122,14 @@ without external resources. Instead of giving a URL to a mailing list
archive, summarize the relevant points of the discussion.
If you want to reference a previous commit in the history of a stable
-branch use the format "abbreviated sha1 (subject, date)". So for example
-like this: "Commit f86a374 (pack-bitmap.c: fix a memleak, 2015-03-30)
-noticed [...]".
+branch, use the format "abbreviated sha1 (subject, date)",
+with the subject enclosed in a pair of double-quotes, like this:
+
+ Commit f86a374 ("pack-bitmap.c: fix a memleak", 2015-03-30)
+ noticed that ...
+
+The "Copy commit summary" command of gitk can be used to obtain this
+format.
(3) Generate your patch using Git tools out of your commits.
^ permalink raw reply related [flat|nested] 6+ messages in thread
* Re: [PATCH] Documentation/SubmittingPatches: add quotes to advised commit reference
2016-08-26 22:42 ` Junio C Hamano
@ 2016-08-26 22:45 ` Stefan Beller
2016-08-27 8:04 ` Jakub Narębski
2016-08-29 11:24 ` Michael J Gruber
2 siblings, 0 replies; 6+ messages in thread
From: Stefan Beller @ 2016-08-26 22:45 UTC (permalink / raw)
To: Junio C Hamano; +Cc: git@vger.kernel.org, Heiko Voigt, Beat Bolli
On Fri, Aug 26, 2016 at 3:42 PM, Junio C Hamano <gitster@pobox.com> wrote:
>
> Perhaps something like this instead?
>
> -- >8 --
This is way better.
Let's take that.
Thanks,
Stefan
> From: Beat Bolli <dev+git@drbeat.li>
> Subject: SubmittingPatches: use gitk's "Copy commit summary" format
> Date: Fri, 26 Aug 2016 18:59:01 +0200
>
> Update the suggestion in 175d38ca ("SubmittingPatches: document how
> to reference previous commits", 2016-07-28) on the format to refer
> to a commit to match what gitk has been giving since last year with
> its "Copy commit summary" command; also mention this as one of the
> ways to obtain a commit reference in this format.
>
> Signed-off-by: Beat Bolli <dev+git@drbeat.li>
> ---
> Documentation/SubmittingPatches | 11 ++++++++---
> 1 file changed, 8 insertions(+), 3 deletions(-)
>
> diff --git a/Documentation/SubmittingPatches b/Documentation/SubmittingPatches
> index 500230c..15adb86 100644
> --- a/Documentation/SubmittingPatches
> +++ b/Documentation/SubmittingPatches
> @@ -122,9 +122,14 @@ without external resources. Instead of giving a URL to a mailing list
> archive, summarize the relevant points of the discussion.
>
> If you want to reference a previous commit in the history of a stable
> -branch use the format "abbreviated sha1 (subject, date)". So for example
> -like this: "Commit f86a374 (pack-bitmap.c: fix a memleak, 2015-03-30)
> -noticed [...]".
> +branch, use the format "abbreviated sha1 (subject, date)",
> +with the subject enclosed in a pair of double-quotes, like this:
> +
> + Commit f86a374 ("pack-bitmap.c: fix a memleak", 2015-03-30)
> + noticed that ...
> +
> +The "Copy commit summary" command of gitk can be used to obtain this
> +format.
>
>
> (3) Generate your patch using Git tools out of your commits.
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [PATCH] Documentation/SubmittingPatches: add quotes to advised commit reference
2016-08-26 22:42 ` Junio C Hamano
2016-08-26 22:45 ` Stefan Beller
@ 2016-08-27 8:04 ` Jakub Narębski
2016-08-29 18:18 ` Junio C Hamano
2016-08-29 11:24 ` Michael J Gruber
2 siblings, 1 reply; 6+ messages in thread
From: Jakub Narębski @ 2016-08-27 8:04 UTC (permalink / raw)
To: Junio C Hamano, Stefan Beller; +Cc: git, hvoigt, dev+git
W dniu 27.08.2016 o 00:42, Junio C Hamano <gitster@pobox.com> pisze:
> Stefan Beller <sbeller@google.com> writes:
> -- >8 --
> From: Beat Bolli <dev+git@drbeat.li>
???
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [PATCH] Documentation/SubmittingPatches: add quotes to advised commit reference
2016-08-26 22:42 ` Junio C Hamano
2016-08-26 22:45 ` Stefan Beller
2016-08-27 8:04 ` Jakub Narębski
@ 2016-08-29 11:24 ` Michael J Gruber
2 siblings, 0 replies; 6+ messages in thread
From: Michael J Gruber @ 2016-08-29 11:24 UTC (permalink / raw)
To: Junio C Hamano, Stefan Beller; +Cc: git, hvoigt, dev+git
Junio C Hamano venit, vidit, dixit 27.08.2016 00:42:
> Stefan Beller <sbeller@google.com> writes:
>
>> Junio finds it is easier to read text when the commit subject is quoted.
>>
>> Signed-off-by: Stefan Beller <sbeller@google.com>
>> ---
>> Documentation/SubmittingPatches | 2 +-
>> 1 file changed, 1 insertion(+), 1 deletion(-)
>>
>> diff --git a/Documentation/SubmittingPatches b/Documentation/SubmittingPatches
>> index 500230c..a591229 100644
>> --- a/Documentation/SubmittingPatches
>> +++ b/Documentation/SubmittingPatches
>> @@ -123,7 +123,7 @@ archive, summarize the relevant points of the discussion.
>>
>> If you want to reference a previous commit in the history of a stable
>> branch use the format "abbreviated sha1 (subject, date)". So for example
>> -like this: "Commit f86a374 (pack-bitmap.c: fix a memleak, 2015-03-30)
>> +like this: "Commit f86a374 ("pack-bitmap.c: fix a memleak", 2015-03-30)
>> noticed [...]".
>
> Thanks, but it is not sufficient as you would not see the need for
> quoting without the example.
>
> My preference is not a main deciding factor in this case anyway. A
> more important reason why it makes sense to quote (aside from the
> fact that it makes more sense when reading) is because we already
> have a tool support for that.
>
> Perhaps something like this instead?
>
> -- >8 --
> From: Beat Bolli <dev+git@drbeat.li>
> Subject: SubmittingPatches: use gitk's "Copy commit summary" format
> Date: Fri, 26 Aug 2016 18:59:01 +0200
>
> Update the suggestion in 175d38ca ("SubmittingPatches: document how
> to reference previous commits", 2016-07-28) on the format to refer
> to a commit to match what gitk has been giving since last year with
> its "Copy commit summary" command; also mention this as one of the
> ways to obtain a commit reference in this format.
>
> Signed-off-by: Beat Bolli <dev+git@drbeat.li>
> ---
> Documentation/SubmittingPatches | 11 ++++++++---
> 1 file changed, 8 insertions(+), 3 deletions(-)
>
> diff --git a/Documentation/SubmittingPatches b/Documentation/SubmittingPatches
> index 500230c..15adb86 100644
> --- a/Documentation/SubmittingPatches
> +++ b/Documentation/SubmittingPatches
> @@ -122,9 +122,14 @@ without external resources. Instead of giving a URL to a mailing list
> archive, summarize the relevant points of the discussion.
>
> If you want to reference a previous commit in the history of a stable
> -branch use the format "abbreviated sha1 (subject, date)". So for example
> -like this: "Commit f86a374 (pack-bitmap.c: fix a memleak, 2015-03-30)
> -noticed [...]".
> +branch, use the format "abbreviated sha1 (subject, date)",
> +with the subject enclosed in a pair of double-quotes, like this:
> +
> + Commit f86a374 ("pack-bitmap.c: fix a memleak", 2015-03-30)
> + noticed that ...
> +
> +The "Copy commit summary" command of gitk can be used to obtain this
> +format.
or (an alias for) the command
git show -s --date=format:%F --pretty='tformat:%h ("%s", %ad)'
>
> (3) Generate your patch using Git tools out of your commits.
>
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [PATCH] Documentation/SubmittingPatches: add quotes to advised commit reference
2016-08-27 8:04 ` Jakub Narębski
@ 2016-08-29 18:18 ` Junio C Hamano
0 siblings, 0 replies; 6+ messages in thread
From: Junio C Hamano @ 2016-08-29 18:18 UTC (permalink / raw)
To: Jakub Narębski; +Cc: Stefan Beller, git, hvoigt, dev+git
Jakub Narębski <jnareb@gmail.com> writes:
> W dniu 27.08.2016 o 00:42, Junio C Hamano <gitster@pobox.com> pisze:
>> Stefan Beller <sbeller@google.com> writes:
>
>> -- >8 --
>> From: Beat Bolli <dev+git@drbeat.li>
>
> ???
The primary value the change adds is to make readers aware of the
gitk feature. That comes from the primary author. Not something I
added, Stefan added or Heiko added.
^ permalink raw reply [flat|nested] 6+ messages in thread
end of thread, other threads:[~2016-08-29 18:18 UTC | newest]
Thread overview: 6+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2016-08-26 22:27 [PATCH] Documentation/SubmittingPatches: add quotes to advised commit reference Stefan Beller
2016-08-26 22:42 ` Junio C Hamano
2016-08-26 22:45 ` Stefan Beller
2016-08-27 8:04 ` Jakub Narębski
2016-08-29 18:18 ` Junio C Hamano
2016-08-29 11:24 ` Michael J Gruber
Code repositories for project(s) associated with this public inbox
https://80x24.org/mirrors/git.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).