From: Randy Dunlap <rdunlap@infradead.org>
To: Konstantin Ryabitsev <konstantin@linuxfoundation.org>,
Eric Biggers <ebiggers@kernel.org>
Cc: linux-doc@vger.kernel.org, workflows@vger.kernel.org,
Jonathan Corbet <corbet@lwn.net>,
Shuah Khan <skhan@linuxfoundation.org>,
linux-kernel@vger.kernel.org
Subject: Re: [PATCH] docs: submitting-patches: Require base tree information
Date: Tue, 20 Oct 2026 23:07:05 -0700 [thread overview]
Message-ID: <f6d6d8d2-03ca-498d-b5d2-578aece560d9@infradead.org> (raw)
In-Reply-To: <20261020-brown-potoo-of-relaxation-3e9a72@lemur>
On 10/20/26 3:07 PM, Konstantin Ryabitsev wrote:
> On Tue, Oct 20, 2026 at 09:22:35PM +0000, Eric Biggers wrote:
>> Many patches still don't include base tree information and can't be
>> applied. Such patches can't be properly reviewed or tested, nor can
>> they be accepted. submitting-patches.rst already describes how to
>> include base tree information, but it's characterized as optional,
>> appears only towards the end of the document, and is missing details.
>
> I'm happy with this change, but I'd disambiguate the title a bit. With b4, we
> started providing both a base-commit and base-tree footer, specifically
> because often times the "base-commit:" line by itself is not sufficient.
>
> Imagine this scenario: a developer is working on some code in a feature branch
> and come across a pre-existing bug. They create a fork off of their feature
> branch to fix the bug and send it in. In this situation, the "base-commit"
> footer would be meaningless, because it references some transient commit-id in
> their feature branch. In an ideal scenario, the developer would rebase that
> bugfix branch on a known tag, but that doesn't always happen.
>
> This observation doesn't really preclude this patch from being accepted, I'm
> just recording my own experience that, by itself, base-commit is often
> insufficient.
Yeah, I was wondering about specifying tree as well as commit, so thanks
answering before I even asked the question.
Most of my patches are made against linux-next. So: is this going to be
acceptable?
(for linux-next-20261020:)
base-commit: 053966c344dbd346e71305f530e91ea77916189f
base-tree: git://git.kernel.org/pub/scm/linux/kernel/git/next/linux-next.git master
linux-next how has over 400 trees in it. That's a tad prohibitive AFA cloning is
concerned.
thanks.
--
~Randy
next prev parent reply other threads:[~2026-10-21 6:07 UTC|newest]
Thread overview: 11+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-10-20 21:22 Eric Biggers
2026-10-20 22:07 ` Konstantin Ryabitsev
2026-10-21 6:07 ` Randy Dunlap [this message]
2026-10-21 6:35 ` Krzysztof Kozlowski
2026-10-21 6:44 ` Eric Biggers
2026-10-21 6:47 ` Krzysztof Kozlowski
2026-10-21 3:17 ` Weijie Yuan
2026-10-21 6:26 ` Krzysztof Kozlowski
2026-10-21 6:39 ` Eric Biggers
2026-10-21 6:41 ` Krzysztof Kozlowski
2026-10-21 6:49 ` Eric Biggers
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=f6d6d8d2-03ca-498d-b5d2-578aece560d9@infradead.org \
--to=rdunlap@infradead.org \
--cc=corbet@lwn.net \
--cc=ebiggers@kernel.org \
--cc=konstantin@linuxfoundation.org \
--cc=linux-doc@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=skhan@linuxfoundation.org \
--cc=workflows@vger.kernel.org \
/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
all inboxes | Powered by JetHome®