Re: [PATCH v4] docs: submitting-patches: say which commit a Fixes tag names

[Jonathan Corbet]

Sasha Levin <sashal@xxxxxxxxxx> writes:

> The description of the Fixes: tag does not say which commit to name when
> a later commit made an older bug reachable, or when more than one commit
> introduced the same bug, and both questions come up regularly. The
> commit that blame points at is also often one that only moved the code.
>
> Say that the tag names the commit that introduced the bug, that a
> later commit that exposed it gets a tag too, as handling-regressions.rst
> already asks for the commit causing a regression, and that each commit
> that introduced the bug separately gets its own tag. Say that the tags
> tell the stable team which trees need the fix, and that trees without
> any of the tagged commits do not.
>
> Link: https://lore.kernel.org/r/c3ce794d-1ac2-4ef3-9e5c-1e171bd77a89@xxxxxxxxxxxxx
> Link: https://lore.kernel.org/r/20261013003535-mutt-send-email-mst@xxxxxxxxxx
> Link: https://lore.kernel.org/r/atCI4q2HvqVXOag1@stanley.mountain
> Link: https://lore.kernel.org/r/bcef59f8-33fe-4bbe-8429-307630dc6bb5@xxxxxxxxxxxxx
> Assisted-by: LLM
> Signed-off-by: Sasha Levin <sashal@xxxxxxxxxx>
> ---
> v4:
>  - Split out of the agents skills series, where this was patch 2/7 of v3:
>    https://lore.kernel.org/r/20261016152828.3765695-3-sashal@xxxxxxxxxx
>  - Take Thorsten's rewording. A later commit that exposed the bug now
>    gets a Fixes: tag too, as handling-regressions.rst already asks.
>
>  Documentation/process/submitting-patches.rst | 8 ++++++++
>  1 file changed, 8 insertions(+)

Applied, thanks.

jon