mirror of https://lore.kernel.org/lkml/
 help / color / mirror / Atom feed
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


  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®