From patchwork Tue Mar 11 07:28:26 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Denis Mukhin X-Patchwork-Id: 14011229 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from lists.xenproject.org (lists.xenproject.org [192.237.175.120]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 51BD1C28B2E for ; Tue, 11 Mar 2025 07:28:56 +0000 (UTC) Received: from list by lists.xenproject.org with outflank-mailman.907253.1314509 (Exim 4.92) (envelope-from ) id 1tru2Y-0006UR-V2; Tue, 11 Mar 2025 07:28:38 +0000 X-Outflank-Mailman: Message body and most headers restored to incoming version Received: by outflank-mailman (output) from mailman id 907253.1314509; Tue, 11 Mar 2025 07:28:38 +0000 Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1tru2Y-0006UK-SY; Tue, 11 Mar 2025 07:28:38 +0000 Received: by outflank-mailman (input) for mailman id 907253; Tue, 11 Mar 2025 07:28:37 +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 1tru2X-0006UE-QS for xen-devel@lists.xenproject.org; Tue, 11 Mar 2025 07:28:37 +0000 Received: from mail-40131.protonmail.ch (mail-40131.protonmail.ch [185.70.40.131]) by se1-gles-flk1.inumbo.com (Halon) with ESMTPS id 6f84c9dc-fe4a-11ef-9898-31a8f345e629; Tue, 11 Mar 2025 08:28:32 +0100 (CET) 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: 6f84c9dc-fe4a-11ef-9898-31a8f345e629 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=proton.me; s=protonmail; t=1741678111; x=1741937311; bh=JmhzxO9rdDUsXnDJqFL064KibvhgPZWJo7yJkXf/GzI=; h=Date:To:From:Cc:Subject:Message-ID:Feedback-ID:From:To:Cc:Date: Subject:Reply-To:Feedback-ID:Message-ID:BIMI-Selector: List-Unsubscribe:List-Unsubscribe-Post; b=bUzMP04Y9D0p9kY8NfVr1uksrMaeCNScS1hGa7ikkDaLClYBFXgaBiSZL4bSKeG6h iJy71TsrgF5ibf4gg3FqeBom5ZKztx8C19zsoX2NYCtqnIcJuFwePXiHCgiwKOBxW3 m5RBC5KX4XaSfaEQlbWSk1y3zfdii+Z6vunboLvROoUurGd6y459ECpAfiAqblqgC/ VD9y37LmsqO/ZmwYNaZ4Z3HWWGlHDChovUv6XQ2Pp2EiT0tsz7pKhNWTS/FprblfV9 Su4zByNkWBRKPYu/o8ktKI4CBE3uqbXj2JOTVZiy1O6JC9Dgx0bPFRtGIAlcWrBdU9 Bs6idXsJ5hOUg== Date: Tue, 11 Mar 2025 07:28:26 +0000 To: xen-devel@lists.xenproject.org From: dmkhn@proton.me Cc: andrew.cooper3@citrix.com, anthony.perard@vates.tech, jbeulich@suse.com, julien@xen.org, michal.orzel@amd.com, roger.pau@citrix.com, sstabellini@kernel.org, dmukhin@ford.com Subject: [PATCH] docs: add explanation for 'Resolved:' Message-ID: <20250311072805.778362-1-dmkhn@proton.me> Feedback-ID: 123220910:user:proton X-Pm-Message-ID: 993e177be34fd94cf41db44dd87822b4dd895f63 MIME-Version: 1.0 From: Denis Mukhin 'Resolves:' tag may be used if the patch addresses one of the tickets logged via Gitlab to auto-close such ticket when the patch got merged. Add documentation for the tag. Signed-off-by: Denis Mukhin Reviewed-by: Jason Andryuk Acked-by: Stefano Stabellini --- docs/process/sending-patches.pandoc | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/docs/process/sending-patches.pandoc b/docs/process/sending-patches.pandoc index 2e74c3b57e..9fc3b407ff 100644 --- a/docs/process/sending-patches.pandoc +++ b/docs/process/sending-patches.pandoc @@ -106,6 +106,18 @@ 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. +### Resolves: + +If your patch addresses an issue logged in a GitLab ticket, use the `Resolves:` +tag followed by the issue link to automatically close the ticket when the patch +is merged. + + Resolves: + +E.g.: + + Resolves: https://gitlab.com/xen-project/xen/-/issues/185 + ### Backport: A backport tag is an optional tag in the commit message to request a