From: Jeff King <peff@peff.net>
To: Junio C Hamano <gitster@pobox.com>
Cc: Phillip Susi <psusi@ubuntu.com>, git@vger.kernel.org
Subject: Re: Enabling scissors by default?
Date: Wed, 9 Jan 2013 12:10:11 -0500 [thread overview]
Message-ID: <20130109171011.GB5332@sigill.intra.peff.net> (raw)
In-Reply-To: <7vr4lvb63a.fsf@alter.siamese.dyndns.org>
On Tue, Jan 08, 2013 at 03:36:09PM -0800, Junio C Hamano wrote:
> You could introduce a new configuration variable "am.scissors" and
> personally turn it on, though. Setting that variable *does* count
> as the user explicitly asking for it.
I think we have mailinfo.scissors already.
> > I often see patches being tweaked in response to feedback and
> > resubmitted, usually with a description of what has changed since the
> > previous version. Such descriptions don't need to be in the change
> > log when it is finally applied and seem a perfect use of scissors.
>
> Putting such small logs under "---" line is the accepted practice.
Maybe it is just me, but I find the scissors form more readable, because
the "cover letter" material often serves to introduce and give context
to the patch (e.g., "Thanks for your feedback. I've tried to do X, and
it came out well. Here's the patch." serves as an introduction, and
logically comes before the commit message itself).
That does not say anything one way or another about how dangerous or not
it might be to enable scissors by default. Just my two cents that I like
the scissors style for patches that come as part of a discussion (and I
prefer the "---" style when making comments on the contents of a patch;
i.e., when the comments make more sense to be read after reading the
commit message to understand what the patch does).
-Peff
next prev parent reply other threads:[~2013-01-09 17:10 UTC|newest]
Thread overview: 6+ messages / expand[flat|nested] mbox.gz Atom feed top
2013-01-08 21:42 Enabling scissors by default? Phillip Susi
2013-01-08 22:42 ` Junio C Hamano
2013-01-08 23:25 ` Phillip Susi
2013-01-08 23:36 ` Junio C Hamano
2013-01-09 17:10 ` Jeff King [this message]
2013-01-09 17:40 ` Junio C Hamano
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20130109171011.GB5332@sigill.intra.peff.net \
--to=peff@peff.net \
--cc=git@vger.kernel.org \
--cc=gitster@pobox.com \
--cc=psusi@ubuntu.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
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 NNTP newsgroup(s).