docs/sending-patches: document "Amends:" tag

On rare occasions Fixes: isn't quite appropriate to use, yet another
commit still wants making a connection to in a formalized way. Such could
e.g. happen if a pretty obvious optimization was left out (which isn't a
bug, but still a shortcoming). Formalize Amends: as a tage to use in such
a situation.

Requested-by: Roger Pau Monné <roger.pau@citrix.com>
Signed-off-by: Jan Beulich <jbeulich@suse.com>
Acked-by: Michal Orzel <michal.orzel@amd.com>
This commit is contained in:
Jan Beulich committed 2025-09-04 16:54:47 +02:00
1 parent 45bb8868ef
commit c08845e230
1 file changed
+7 -1
+7 -1
View File
@@ -42,7 +42,7 @@ should be mentioned.
When referencing other patches (e.g. `similar to patch xy ...`) those
patches should be referenced via their commit id (at least 12 digits)
and the patch subject, if the very same patch isn't referenced by the
and the patch subject, if the very same patch isn't referenced by e.g. a
`Fixes:` tag, too:
Similar to commit 67d01cdb5518 ("x86: infrastructure to allow converting
@@ -106,6 +106,12 @@ If git was configured as explained earlier, this can be retrieved using
``git log --pretty=fixes`` otherwise ``git log --abbrev=12 --oneline`` will
give the proper tag and commit-id.
### Amends:
If your patch doesn't quite fix a bug, but still amends a specific commit,
e.g. because an omission was found, please consider using an `Amends:` tag.
See the `Fixes:` tag description above for how to use it.
### Resolves:
If your patch addresses an issue logged in a GitLab ticket, use the `Resolves:`
Reference in new issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.