From nobody Thu Oct 30 22:42:09 2025 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of lists.xenproject.org designates 192.237.175.120 as permitted sender) client-ip=192.237.175.120; envelope-from=xen-devel-bounces@lists.xenproject.org; helo=lists.xenproject.org; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of lists.xenproject.org designates 192.237.175.120 as permitted sender) smtp.mailfrom=xen-devel-bounces@lists.xenproject.org; dmarc=pass(p=quarantine dis=none) header.from=suse.com ARC-Seal: i=1; a=rsa-sha256; t=1756717243; cv=none; d=zohomail.com; s=zohoarc; b=EhceRgQMNJfe5SkhXpQiDFAzOakSXgzdwQGaxl+mhRJMAedUZVkEcKhrQhMyNtx4zMqP3SotWcKEg5M+Tt98AOzuPBh0hozeU/bfsiXc8GYb3IcqJnNm9TYMMdHWEiLczqE6FxZ+E53e5HlIc2F64Shlw311qh+lT7ioY3wYy6M= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1756717243; h=Content-Type:Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:List-Subscribe:List-Post:List-Id:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=q2J8zmsIOb81RGVTk4ElRHWcQuRIoi5c75HY0w93Vhc=; b=Iq+GyfEje7bGJ6h/DRVJIR+lTfYETYZNgkcYijW2+iM2vCKO+NcZ2nNpXs0mCgEPGNFrNJ06fCgARA/xbiBC7zn8ODpZA1M3FL4P6CITwwyeq9dng/95I67AhqwhRaDvnQoC2i4llm/NdTm0CBI++t1226uPRocfZJ1/12kH/J8= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of lists.xenproject.org designates 192.237.175.120 as permitted sender) smtp.mailfrom=xen-devel-bounces@lists.xenproject.org; dmarc=pass header.from= (p=quarantine dis=none) Return-Path: Received: from lists.xenproject.org (lists.xenproject.org [192.237.175.120]) by mx.zohomail.com with SMTPS id 1756717243140418.6820461834441; Mon, 1 Sep 2025 02:00:43 -0700 (PDT) Received: from list by lists.xenproject.org with outflank-mailman.1104196.1455309 (Exim 4.92) (envelope-from ) id 1ut0Om-0003Rf-9n; Mon, 01 Sep 2025 09:00:24 +0000 Received: by outflank-mailman (output) from mailman id 1104196.1455309; Mon, 01 Sep 2025 09:00:24 +0000 Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1ut0Om-0003RY-6V; Mon, 01 Sep 2025 09:00:24 +0000 Received: by outflank-mailman (input) for mailman id 1104196; Mon, 01 Sep 2025 09:00:23 +0000 Received: from se1-gles-flk1-in.inumbo.com ([94.247.172.50] helo=se1-gles-flk1.inumbo.com) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1ut0Ok-0003RS-Ux for xen-devel@lists.xenproject.org; Mon, 01 Sep 2025 09:00:22 +0000 Received: from mail-ej1-x62f.google.com (mail-ej1-x62f.google.com [2a00:1450:4864:20::62f]) by se1-gles-flk1.inumbo.com (Halon) with ESMTPS id 168aa82d-8712-11f0-8dd7-1b34d833f44b; Mon, 01 Sep 2025 11:00:20 +0200 (CEST) Received: by mail-ej1-x62f.google.com with SMTP id a640c23a62f3a-b03fa5c5a89so211439866b.2 for ; Mon, 01 Sep 2025 02:00:20 -0700 (PDT) Received: from [10.156.60.236] (ip-037-024-206-209.um08.pools.vodafone-ip.de. [37.24.206.209]) by smtp.gmail.com with ESMTPSA id a640c23a62f3a-b042fcae813sm157722266b.40.2025.09.01.02.00.19 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Mon, 01 Sep 2025 02:00:19 -0700 (PDT) X-Outflank-Mailman: Message body and most headers restored to incoming version X-BeenThere: xen-devel@lists.xenproject.org List-Id: Xen developer discussion List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Errors-To: xen-devel-bounces@lists.xenproject.org Precedence: list Sender: "Xen-devel" X-Inumbo-ID: 168aa82d-8712-11f0-8dd7-1b34d833f44b DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.com; s=google; t=1756717220; x=1757322020; darn=lists.xenproject.org; h=content-transfer-encoding:autocrypt:subject:from:cc:to :content-language:user-agent:mime-version:date:message-id:from:to:cc :subject:date:message-id:reply-to; bh=q2J8zmsIOb81RGVTk4ElRHWcQuRIoi5c75HY0w93Vhc=; b=S0oxBwSiQ43I3YvG35RXPCGmE94TOFip3nTPYy2bkRJE39lnh4E8EItPh4GiS7az2Y u0KgCPV/mVmxCeu/DIQ7N8wyg2aJSKnvoK8Xl4uuKRUpBzKIldTfey50FNeyMddU+gdF RQs7ex/yEraB2gc7Fo16zh7WZx/tdG8rCcRuNe+dwDllNr3vLQfBId5t5GApd04OsdV7 m5ARpaqXqB4OVLXlKPwxLuo4gHMzp/40L58nqhmJ8V9KuKouwdF+KJmI8gqsFkfoDmU4 t3zlyMspEnTPeug+Jei3jjiZaG8VRkWf7qYNOHb8s2yQdRPguRgAmF7j+WSbC37cKAxY 39wg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1756717220; x=1757322020; h=content-transfer-encoding:autocrypt:subject:from:cc:to :content-language:user-agent:mime-version:date:message-id :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=q2J8zmsIOb81RGVTk4ElRHWcQuRIoi5c75HY0w93Vhc=; b=EeJGbAnHrQ8K/aji0SZaftMlUDOWGlShp3NI9vqBv49qPCNGtpqS175vPa4Rj3fSJR WQUbmRACVFozgjgQhT3vFEhVGIuhNwTNUujOehblNy8OY2EeLrXmhEmWSAP7JyMtoYU4 voUxkNakJi42O2DMcw4y3Wd4z1EREMH1w6UlZ5m+h8HxnM7AEsexTxSXcyyiKZ9p3lfj cAXM/gbb5PbcSnYmXGUOQs+KE16kbkoHvHBhdqnb7l6EbStE3BxnjJEt0YgdZGQuRq/q FX75risWQAdZvBi4lawcegHElAdM1YMMep04UbBfAhTYnuoTpvjkf2hNAI47TA4Y61AY X6iQ== X-Gm-Message-State: AOJu0YzRn33WGjY3OiOiiaOy6V7HEcZQRM5i0chIFCUpuwNcgsp8yEoS p0P4guFhk7gbKIuMGRKpLCsuqHsu31ZQ8Ry0Y0g7JoFBkp14z7DMcndrP7dheaSaDEv9DxtYXep Oa/A= X-Gm-Gg: ASbGnctjSnDpEpISlxdgIjNelZFiD3KSvB0ODPTlloM66EFic6uX4xwnkLLePDQj+EH dYLsIG2tmlXFHSzgsk9mzyA8iZ+OiEVWUGEJyX+lUow8xgMcfgBfTGYpEhtZwi4PTPT4H+/PUdq 0I0peILtutyrXqghJNOh20zxCM/GJQkOJcwMmRXMTH+LUnGD/PnlHZx3hrEm+xhL9rjaazryUFo Qc62FJ7/+FCYZY+EUNrUwOx7HF9SqnQtk0JMzuV41rFbtQ9Tme6ZDXdwRXX3AX8btfGwg1dFIlk qJS7B7hbCAotPXCUBDB88gz1qhMYcGzIhYKLqDXJl6Xktjts7gxVEc4G8wvYGUfBBs9XD0NQn58 wq6Jqkz60wUV8OCpMbph5KHFZs0zGpHs4dyXVbiL29wUElzERz2DseWu7zdB4WW7XZsbMmeCbem /mvVOCgy4= X-Google-Smtp-Source: AGHT+IG1ObEOlVvLkfSbZfcw3G1Qcs2onSpzkaIW2ICoZ9H2F1fRpjVflyzR4WV7wehg/U0HV70KFg== X-Received: by 2002:a17:906:f59d:b0:afe:ae99:9d23 with SMTP id a640c23a62f3a-b01ec52d58dmr642708066b.61.1756717219977; Mon, 01 Sep 2025 02:00:19 -0700 (PDT) Message-ID: <92b2d76e-2434-4606-94b6-93774a74fc87@suse.com> Date: Mon, 1 Sep 2025 11:00:19 +0200 MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Content-Language: en-US To: "xen-devel@lists.xenproject.org" Cc: Andrew Cooper , Julien Grall , Stefano Stabellini , Anthony PERARD , Michal Orzel , =?UTF-8?Q?Roger_Pau_Monn=C3=A9?= From: Jan Beulich Subject: [PATCH] docs/sending-patches: document "Amends:" tag Autocrypt: addr=jbeulich@suse.com; keydata= xsDiBFk3nEQRBADAEaSw6zC/EJkiwGPXbWtPxl2xCdSoeepS07jW8UgcHNurfHvUzogEq5xk hu507c3BarVjyWCJOylMNR98Yd8VqD9UfmX0Hb8/BrA+Hl6/DB/eqGptrf4BSRwcZQM32aZK 7Pj2XbGWIUrZrd70x1eAP9QE3P79Y2oLrsCgbZJfEwCgvz9JjGmQqQkRiTVzlZVCJYcyGGsD /0tbFCzD2h20ahe8rC1gbb3K3qk+LpBtvjBu1RY9drYk0NymiGbJWZgab6t1jM7sk2vuf0Py O9Hf9XBmK0uE9IgMaiCpc32XV9oASz6UJebwkX+zF2jG5I1BfnO9g7KlotcA/v5ClMjgo6Gl MDY4HxoSRu3i1cqqSDtVlt+AOVBJBACrZcnHAUSuCXBPy0jOlBhxPqRWv6ND4c9PH1xjQ3NP nxJuMBS8rnNg22uyfAgmBKNLpLgAGVRMZGaGoJObGf72s6TeIqKJo/LtggAS9qAUiuKVnygo 3wjfkS9A3DRO+SpU7JqWdsveeIQyeyEJ/8PTowmSQLakF+3fote9ybzd880fSmFuIEJldWxp Y2ggPGpiZXVsaWNoQHN1c2UuY29tPsJgBBMRAgAgBQJZN5xEAhsDBgsJCAcDAgQVAggDBBYC AwECHgECF4AACgkQoDSui/t3IH4J+wCfQ5jHdEjCRHj23O/5ttg9r9OIruwAn3103WUITZee e7Sbg12UgcQ5lv7SzsFNBFk3nEQQCACCuTjCjFOUdi5Nm244F+78kLghRcin/awv+IrTcIWF hUpSs1Y91iQQ7KItirz5uwCPlwejSJDQJLIS+QtJHaXDXeV6NI0Uef1hP20+y8qydDiVkv6l IreXjTb7DvksRgJNvCkWtYnlS3mYvQ9NzS9PhyALWbXnH6sIJd2O9lKS1Mrfq+y0IXCP10eS FFGg+Av3IQeFatkJAyju0PPthyTqxSI4lZYuJVPknzgaeuJv/2NccrPvmeDg6Coe7ZIeQ8Yj t0ARxu2xytAkkLCel1Lz1WLmwLstV30g80nkgZf/wr+/BXJW/oIvRlonUkxv+IbBM3dX2OV8 AmRv1ySWPTP7AAMFB/9PQK/VtlNUJvg8GXj9ootzrteGfVZVVT4XBJkfwBcpC/XcPzldjv+3 HYudvpdNK3lLujXeA5fLOH+Z/G9WBc5pFVSMocI71I8bT8lIAzreg0WvkWg5V2WZsUMlnDL9 mpwIGFhlbM3gfDMs7MPMu8YQRFVdUvtSpaAs8OFfGQ0ia3LGZcjA6Ik2+xcqscEJzNH+qh8V m5jjp28yZgaqTaRbg3M/+MTbMpicpZuqF4rnB0AQD12/3BNWDR6bmh+EkYSMcEIpQmBM51qM EKYTQGybRCjpnKHGOxG0rfFY1085mBDZCH5Kx0cl0HVJuQKC+dV2ZY5AqjcKwAxpE75MLFkr wkkEGBECAAkFAlk3nEQCGwwACgkQoDSui/t3IH7nnwCfcJWUDUFKdCsBH/E5d+0ZnMQi+G0A nAuWpQkjM1ASeQwSHEeAWPgskBQL Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @suse.com) X-ZM-MESSAGEID: 1756717244909116600 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=C3=A9 Signed-off-by: Jan Beulich Acked-by: Michal Orzel --- a/docs/process/sending-patches.pandoc +++ b/docs/process/sending-patches.pandoc @@ -42,7 +42,7 @@ should be mentioned. =20 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: =20 Similar to commit 67d01cdb5518 ("x86: infrastructure to allow converti= ng @@ -106,6 +106,12 @@ If git was configured as explained earli ``git log --pretty=3Dfixes`` otherwise ``git log --abbrev=3D12 --oneline``= will give the proper tag and commit-id. =20 +### 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: =20 If your patch addresses an issue logged in a GitLab ticket, use the `Resol= ves:`