LKML Archive on lore.kernel.org
help / color / mirror / Atom feed
From: Junio C Hamano <junio@pobox.com>
To: Linus Torvalds <torvalds@linux-foundation.org>
Cc: corbet@lwn.net, linux-kernel@vger.kernel.org, akpm@linux-foundation.org
Subject: Re: [PATCH] Documentation/patch-tags, one more time
Date: Fri, 08 Feb 2008 12:50:40 -0800	[thread overview]
Message-ID: <7v1w7njhpb.fsf@gitster.siamese.dyndns.org> (raw)
In-Reply-To: <alpine.LFD.1.00.0802080959130.2896@woody.linux-foundation.org> (Linus Torvalds's message of "Fri, 8 Feb 2008 10:00:36 -0800 (PST)")

Linus Torvalds <torvalds@linux-foundation.org> writes:

> On Fri, 8 Feb 2008, Jonathan Corbet wrote:
>> +
>> +These tags are:
>> +
>> +From: 	   	The original author of the patch.  This tag will ensure
>> +		that credit is properly given when somebody other than the
>> +		original author submits the patch.
>
> "From:" is not a tag. It's a special marker at the *top* (and _only_ the 
> top) of the email, which indicates authorship. It goes along with markers 
> like "Date:" and "Subject:", and has nothing to do with the sign-off-like 
> tags at the end.

True.  When one or more of these appear at the top (and _only_
the top) of a patch e-mail,

	From:		the person who wrote the patch
        Date:		the date of the authorship
        Subject:	the title of the patch

we override the corresponding values we obtain from the mail
header.  Documenting them is probably a good idea but they
should be described separately from S-o-b: and friends to avoid
confusion.



  parent reply	other threads:[~2008-02-08 20:51 UTC|newest]

Thread overview: 11+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2008-02-08 16:51 Jonathan Corbet
2008-02-08 17:07 ` Pekka Enberg
2008-02-08 18:00 ` Linus Torvalds
2008-02-08 19:01   ` Paul Jackson
2008-02-08 20:42     ` [PATCH] Documenting patch tags yet " Jonathan Corbet
2008-02-09  0:23       ` Paul Jackson
2008-02-09  8:37         ` Stefan Richter
2008-02-08 20:50   ` Junio C Hamano [this message]
2008-02-18  2:58   ` [PATCH] Documentation/patch-tags, " Neil Brown
2008-02-18  3:15     ` Paul Jackson
2008-02-18  3:58       ` Neil Brown

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=7v1w7njhpb.fsf@gitster.siamese.dyndns.org \
    --to=junio@pobox.com \
    --cc=akpm@linux-foundation.org \
    --cc=corbet@lwn.net \
    --cc=linux-kernel@vger.kernel.org \
    --cc=torvalds@linux-foundation.org \
    --subject='Re: [PATCH] Documentation/patch-tags, one more time' \
    /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

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).