Skip site navigation (1)Skip section navigation (2)
Date:      Fri, 22 Jan 2021 08:26:02 -0600
From:      Kyle Evans <kevans@freebsd.org>
To:        Hans Petter Selasky <hps@selasky.org>
Cc:        src-committers <src-committers@freebsd.org>, dev-commits-src-all@freebsd.org,  dev-commits-src-branches@freebsd.org, Warner Losh <imp@bsdimp.com>
Subject:   Re: git: e006b6a2c1b9 - stable/12 - MFC 376479200760: Fix whitespace in mlx5en(4).
Message-ID:  <CACNAnaEkqU5xr9jr-5hY0nZgZd6%2BQB3-zud6ejzKEhvH82AWqg@mail.gmail.com>
In-Reply-To: <30b9e294-6767-abd4-e3a3-7a2d268323f9@selasky.org>
References:  <202101221230.10MCULuw000439@gitrepo.freebsd.org> <CACNAnaHJ1vdtUnH=9rDHpT-zhX4UujExSdkin6NvkpyvAs1-aQ@mail.gmail.com> <30b9e294-6767-abd4-e3a3-7a2d268323f9@selasky.org>

next in thread | previous in thread | raw e-mail | index | archive | help
On Fri, Jan 22, 2021 at 8:19 AM Hans Petter Selasky <hps@selasky.org> wrote:
>
> On 1/22/21 2:59 PM, Kyle Evans wrote:
> > For the record, as per [0], these should have been cherry-picked using
> > -x which adds a " (cherry picked from commit ...)" annotation at the
> > bottom. With the annotation in place, the leading MFC line can be
> > dropped and the original message otherwise preserved (dropping any
> > metadata at the bottom that makes sense, e.g. "MFC after" tags). The
> > -x line helps at least the MFC tracker match the commit from main.
> >
> > Thanks,
> >
> > Kyle Evans
> >
> > [0]https://github.com/bsdimp/freebsd-git-docs/blob/main/MFC.md
>
> Hi Kyle,
>
> Shouldn't the committers-guide be updated to reflect this is now the
> official way to do it?
>
> https://www.freebsd.org/doc/en_US.ISO8859-1/articles/committers-guide/
>

The committers guide wasn't going to be updated with the contents of
Warner's freebsd-git-docs until the doc switch to a less arcane
format.

> I see no problem keeping MFC at the beginning of commit e-mails. Makes
> it easier to sort, and it is backwards compatible!
>
> MFC rXXXXX refers to a SVN commit.
> MFC [0-9 A-F] indicate a GIT commit.
>
> BTW: When MFC-ing a commit which was done using SVN, should we use MFC r
>   or refer to the git hash?
>

I can see a good argument for wanting to record the svn revision
number where that's relevant, but I'd propose not prepending MFC when
cherry-picking any git-originating commits so that oneline/shortlog or
whatever it's called is as usable on stable as it is on main going
forward.

To be clear, I think the recommendation should be to:

1.) Use cherry-pick -x regardless so that the MFC tooling doesn't need
to grok both going forward, and
2.) Optionally prepend an "MFC rXXXXXX" if it came from svn

Thanks,

Kyle Evans



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CACNAnaEkqU5xr9jr-5hY0nZgZd6%2BQB3-zud6ejzKEhvH82AWqg>