From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-alma10-1.taild15c8.ts.net [100.103.45.18]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id E52FE4AA570; Fri, 25 Sep 2026 14:32:21 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=100.103.45.18 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1790346747; cv=none; b=P4XH5Spta/ZaN1R1TtF7h/OrzLQvnIVTW4IBsyrbxA+D9oTdJLrU7gTMJBAIUUP4x01bjqVD9IEk4wE9FgXLG0upFkOB6y8YmCqhIrRcp7JkZm1rTUG5nRyNLrGTU0dJJof4zLKNccQzlu9BcE31tzEMWYIHtyOinZxWmMLehic= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1790346747; c=relaxed/simple; bh=v3FMi+b02XWIBXh6jqZOCKAJ2nGcSKxqBKDRbeNTS78=; h=Date:Message-ID:From:To:Cc:Subject:In-Reply-To:References: MIME-Version:Content-Type; b=GKVDSNpHtSFogkdZzP4e/Evnj1c3SiV5cSpCoX12byZnafpZob2CcqWflctvokWw1hOhl4PhzkZszc8ti6xoxFlr0FenivxuOuFurcZpiMr+FIvesgEie+7wejJPDKO9c5eui4CdipK6hGHMO99YHzrlJUpuxwNFALIr7l4/pjg= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=M7g+X+Rq; arc=none smtp.client-ip=100.103.45.18 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="M7g+X+Rq" Received: by smtp.kernel.org (Postfix) with ESMTPSA id CFBF81F000FF; Fri, 25 Sep 2026 14:32:17 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=kernel.org; s=k20260515; t=1790346737; bh=1LuBgTKNWvS+QpmulpULDhVXBuxZOuSCaodcWO3gbCg=; h=Date:From:To:Cc:Subject:In-Reply-To:References; b=M7g+X+Rqm2ljyT5+jHrvNiAITCyvqpPwp9i9+iEP7YA20KZkG9s1nIxYYYB1pg5hP cuOj/+xtqABBcjkUaG1P/jnw/WiizKEmfqSBzKytDHXNJdq/Gsb6cc8Z6dTDaA9dR3 3PSZZE11QU7gZgXcrkWl+OhHpASoaVqBgqpkmSvAC9PjZih40gdrrQoNA1Eb2bV23q tGLOJVsBM4OiwkwYw/Xa4I07zEX8TyrHOzeHIkVRAh4eiwdoIF/PpBf0lFHQPGTjrY gfPKtAcNLsPDiATU9gSVqoJu+RsgQua18i+xvZd0D2USu8PB6AaOp4QZI1ykG77oib Rni96voLQ7Y9g== Received: from sofa.misterjones.org ([185.219.108.64] helo=lobster-girl.misterjones.org) by disco-boy.misterjones.org with esmtpsa (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.98.2) (envelope-from ) id 1xA6yF-0000000DTr4-17km; Fri, 25 Sep 2026 14:32:15 +0000 Date: Fri, 25 Sep 2026 15:35:20 +0100 Message-ID: <874ifd4cwn.wl-maz@kernel.org> From: Marc Zyngier To: Matthias Goergens Cc: corbet@lwn.net, skhan@linuxfoundation.org, rdunlap@infradead.org, tytso@mit.edu, krzk@kernel.org, cassel@kernel.org, ebiggers@kernel.org, workflows@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: Re: [PATCH v2] MAINTAINERS: document the branch in git T: entries In-Reply-To: <20260925120047.1093617-1-matthias.goergens@gmail.com> References: <20260925120047.1093617-1-matthias.goergens@gmail.com> User-Agent: Wanderlust/2.15.9 (Almost Unreal) SEMI-EPG/1.14.7 (Harue) FLIM-LB/1.14.9 (=?UTF-8?B?R29qxY0=?=) APEL-LB/10.8 EasyPG/1.0.0 Emacs/30.1 (aarch64-unknown-linux-gnu) MULE/6.0 (HANACHIRUSATO) Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 (generated by SEMI-EPG 1.14.7 - "Harue") Content-Type: text/plain; charset=US-ASCII X-SA-Exim-Connect-IP: 185.219.108.64 X-SA-Exim-Rcpt-To: matthias.goergens@gmail.com, corbet@lwn.net, skhan@linuxfoundation.org, rdunlap@infradead.org, tytso@mit.edu, krzk@kernel.org, cassel@kernel.org, ebiggers@kernel.org, workflows@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org X-SA-Exim-Mail-From: maz@kernel.org X-SA-Exim-Scanned: No (on disco-boy.misterjones.org); SAEximRunCond expanded to false On Fri, 25 Sep 2026 13:00:47 +0100, Matthias Goergens wrote: > > A git T: entry can name a branch after the repository URL. The first > to do so, commit a1aa5a770dc3 ("MAINTAINERS: update hwmon subsystem > git trees"), added two T: lines for one repository, one per branch. > Today 109 of the 846 git T: lines name a branch, and ten entries list > one repository more than once with different branches. Commit > 083bf9c56d06 ("get_maintainer: add more --self-test options") taught > get_maintainer.pl to check the branch with git ls-remote. Neither the > MAINTAINERS preamble nor submitting-patches.rst mentions any of this. > > Document the syntax only. What a named branch is for varies: many > entries name the branch linux-next merges, others a fixes or topic > branch, and some subsystems want patches based on a mainline tag rather > than on any branch of their tree. maintainer-entry-profile.rst already > asks a profile to say which branches go into linux-next and which one > contributors should submit against, so point there. > > In submitting-patches.rst, say that fixes for the current release cycle > and new development usually start from different places, and where to > find out which. > > Suggested-by: Theodore Ts'o > Link: https://lore.kernel.org/all/arSMwd1bGO1vrif-@mit.edu/ > Signed-off-by: Matthias Goergens Acked-by: Marc Zyngier M. -- Jazz isn't dead. It just smells funny.