From patchwork Fri Mar 24 18:52:45 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Matthieu Baerts X-Patchwork-Id: 7170 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:b0ea:0:b0:3b6:4342:cba0 with SMTP id b10csp845692vqo; Fri, 24 Mar 2023 11:56:41 -0700 (PDT) X-Google-Smtp-Source: AK7set+7rb04sPUXiiUG+HpBPJRZKJS2++PashlStCf4TzYkkLkeaWnzlj5g3mQu+VNdz4niYikV X-Received: by 2002:a62:1a0d:0:b0:625:80f5:96ea with SMTP id a13-20020a621a0d000000b0062580f596eamr3497632pfa.28.1679684200817; Fri, 24 Mar 2023 11:56:40 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1679684200; cv=none; d=google.com; s=arc-20160816; b=ATT+SWI73Xik6KKFqkge1Q2upiOkTTuPZ/acAFSsfvpVWKo4FQqnFcZs3xZLO821EM iSnV/HD6YFmWFvwITpXkRtztrbles2Kt0HOd3chEOswbguQ7iwn9RnhtatwBGzTLDzQz WzjST9GapcFOtis2tErnG5GXrw5VDnI2ew543ttHAJz6ruM1O3LBnt2edoMhBZA9ZCnl 521PJeCq1sQtNHEUPz3ofQeKKvPBJCYijuu3iZw04Z6oSAyseykEFxYqiE9qyavPTp0Q p2ibpy9tTndepUD1pBGHFQOLyR2pGEijZfVTOd1hu0YtUWHvEz9viLSYGPrtuTMipkA9 S2qA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:cc:to:content-transfer-encoding:mime-version :message-id:date:subject:from:dkim-signature; bh=AvFmi2Kslfzz8p7RlnVaanV9PDS7ezg9eJoTmpzeqLU=; b=JpUaVFCFOo7sPHr/ZwfhS+TM3lqq7ZRYIGBTyWxFsDp0TuXF4G7+hl+zG0a50u520F 5qn/ikFT28KamScx7OGR2fQH6VsHBJ5vpO3tlwtVlyVs8O12psmNilmf/azYc1C2QeBs rM6UvQikWoSjd7c278S/bPAi857NjIRGjbEJAbnKrm39+VH0y9rG71Rg1MHu/ALqQSD4 BcFWMkujcLs74Hk9cm63aL0M0Aat8nN3ix2L9Ak5CcE1Qab34tfln1AnYET0o8dSx+Wy dW7bKxnsh7VqPv+PzGmO3x8E2mDXYccpRLMa/5XL+Dopf6x7fF2ufaSylyNYmQlsjAyA DQOQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@tessares.net header.s=google header.b=c07BLeBX; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=tessares.net Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id e23-20020a63db17000000b00502f48d80b6si21293652pgg.645.2023.03.24.11.56.27; Fri, 24 Mar 2023 11:56:40 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@tessares.net header.s=google header.b=c07BLeBX; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=tessares.net Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S231580AbjCXSxM (ORCPT + 99 others); Fri, 24 Mar 2023 14:53:12 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:40940 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229830AbjCXSxK (ORCPT ); Fri, 24 Mar 2023 14:53:10 -0400 Received: from mail-wr1-x42e.google.com (mail-wr1-x42e.google.com [IPv6:2a00:1450:4864:20::42e]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 428E761B1 for ; Fri, 24 Mar 2023 11:53:05 -0700 (PDT) Received: by mail-wr1-x42e.google.com with SMTP id r29so2745685wra.13 for ; Fri, 24 Mar 2023 11:53:05 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=tessares.net; s=google; t=1679683983; h=cc:to:content-transfer-encoding:mime-version:message-id:date :subject:from:from:to:cc:subject:date:message-id:reply-to; bh=AvFmi2Kslfzz8p7RlnVaanV9PDS7ezg9eJoTmpzeqLU=; b=c07BLeBXy4v+Jc465zDUVlUJBuC5ZwPChTA8jtt0ZZeABDsPCZpd5nBIS4OCup4Yjf UwUpftJYbvFl1pRFjZGVkBkX6LvzVRxEM1ElKLtrW9wR26l1H/CeqrjcLbozOCqODl3u TVIMf2uGghQQZbslcE/eUNKTlwqpTciEiQK48ujsPEmb4gUpbWFW9Le7O5ITX2FsOZIO hM8x7cUpML8bew+QgZUnRgXKLkR6woc7c0mdA0syeR+HTHGeq0svX9ozha0YHVCbsqqz c68DWjMH0gyew9uW+GaIyr/0+nZQHp9MWxGgB28kaQGGDXgL0rzETXCKgW1Seqn+8apg gc6g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; t=1679683983; h=cc:to:content-transfer-encoding:mime-version:message-id:date :subject:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=AvFmi2Kslfzz8p7RlnVaanV9PDS7ezg9eJoTmpzeqLU=; b=lI+uFsThmPL2Pl95hshlg2llUDnZauTmhPoa89KqYrh9agKqiz+SBqHxaZzxE43nu4 mPnGPK034wVP0o+qalaeqMox78/9/NmVyUIdH5vPt6eytRkifmIhZkM0er5PmsPMqhi5 klFVmE2ZnRkKWtbKZpsLPrucX2Y9Wvp7R3s77bOX2R8N2d1aUaLyUhw1F/Cx6gVtfc7K on0RviRXcuVLn3isas52Od9Wey2sd1R1QVv/A3pPeMgcMbYv90Jg425o5NOgyWDuNu24 OJBb9GcqtWZdxTAwCpaBXJt6JFz+pJ5jRjD61rbfCa+BXiBqDmDWYEfeVABYA5OHzBWE 7C+w== X-Gm-Message-State: AAQBX9c/5hPBVw4zg/qbIRh7523ZYPKbJeFeiTKrH6g9ziS71oAH0gWG PsEjhfk4CLPGmaU/3mNkrvT1tg== X-Received: by 2002:a5d:4d51:0:b0:2d2:20ed:b572 with SMTP id a17-20020a5d4d51000000b002d220edb572mr2900719wru.69.1679683983636; Fri, 24 Mar 2023 11:53:03 -0700 (PDT) Received: from vdi08.nix.tessares.net (static.219.156.76.144.clients.your-server.de. [144.76.156.219]) by smtp.gmail.com with ESMTPSA id n1-20020a5d67c1000000b002cfe685bfd6sm18948878wrw.108.2023.03.24.11.53.02 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 24 Mar 2023 11:53:03 -0700 (PDT) From: Matthieu Baerts Subject: [PATCH v2 0/2] docs & checkpatch: allow Closes tags with links Date: Fri, 24 Mar 2023 19:52:45 +0100 Message-Id: <20230314-doc-checkpatch-closes-tag-v2-0-f4a417861f6d@tessares.net> MIME-Version: 1.0 X-B4-Tracking: v=1; b=H4sIAH3xHWQC/42OTQ6CMBCFr2K6drQFEXHlPQyLaRlpI7akU4mGc HcLJ3D5vZf3Mwum6IjFdTeLSJNjF3yGYr8TxqLvCVyXWRSyKGWpTtAFA8aSeY6YjAUzBCaGhD2 oulS6qqvqrJXIeY1MoCN6Y9eGwfk3H1/IieJqj5Ee7rNN39vM1nEK8bs9mdSq/jM6KZCg9KWUd UENNnhLxIyR+OApiXZZlh/fVtDi5AAAAA== To: Jonathan Corbet , Andy Whitcroft , Joe Perches , Dwaipayan Ray , Lukas Bulwahn , =?utf-8?q?Kai_Wasserb=C3=A4ch?= , Thorsten Leemhuis , Andrew Morton , David Airlie , Daniel Vetter , Konstantin Ryabitsev , Bagas Sanjaya , Linus Torvalds Cc: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, dri-devel@lists.freedesktop.org, mptcp@lists.linux.dev, Matthieu Baerts X-Mailer: b4 0.12.2 X-Developer-Signature: v=1; a=openpgp-sha256; l=2585; i=matthieu.baerts@tessares.net; h=from:subject:message-id; bh=hBQXRTLnt2/M7PhMUp0rgb64b++zS9LaDQGwBm4DXUk=; b=owEBbQKS/ZANAwAIAfa3gk9CaaBzAcsmYgBkHfGOqPllO3g+/LlSkRIxkaEoUAWKI/DGZTOyA OG7ny0LP+CJAjMEAAEIAB0WIQToy4X3aHcFem4n93r2t4JPQmmgcwUCZB3xjgAKCRD2t4JPQmmg c6pEEADBh4OrKeURadfB2zkHoNq4wee35N1D+2057a2iHhcB1hiM3S2kApDgLJT7hynAlg/oAP9 KlAnaKcqrAaVAHJ2/bDkMurl/i5AHzwEv5XJxjNlat3DHM6oUir4ZC+bhN2sJEgxxztkNz7z8Ep E5JyHXxZYBDRYCmC5JbTdyH2x2C7fJ28gq1rX8qDj8aCz1Mu8SD02XchIvh0pSudoHrdxOToSdF 1Wll+rDDjZgWfuynGhfEm4MJVb/Y4dDVkYpd02k/lBjN0x5E++eJIWTyikPaSUnCa0uo6btxuqP 98UATAXCIroa4QZD6YBI/T2fimEsR9cMkoEpohyyk3fMN3cY5Xy7gpvY9rtgO8B7liueMS9xSiW FhobWVD+ZmE1QBpf8TgeaUEvbeP151YtoqMYckOu5n/QugOlD5Y+0qDj0xJUFGsbeJlg4VmVyw4 XeB7Cjw5LxLcMT2uk2ceesqaSNri9W3KZyYmsIYCV1smTTMbiEgXTCJbf+wjvWZQfQJiAY8D9u2 ewRwaSW54k3pjbr/DQtcM4TLwzHBtQi54gIREfOOSHHZKOBVRtwA+jKGNM82i/sTb3amiQqViwi Cay1VAHjyqQHDSVhe9lM06Pp2brytPsAb8osq8mBknAIW10PfZwJcThF9512YMiFK4dK07bcmRv QVIriidmpXtGF/w== X-Developer-Key: i=matthieu.baerts@tessares.net; a=openpgp; fpr=E8CB85F76877057A6E27F77AF6B7824F4269A073 X-Spam-Status: No, score=-0.2 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_NONE,SPF_HELO_NONE,SPF_PASS autolearn=unavailable autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1761276540562347802?= X-GMAIL-MSGID: =?utf-8?q?1761276540562347802?= Since v6.3, checkpatch.pl now complains about the use of "Closes:" tags followed by a link [1]. It also complains if a "Reported-by:" tag is followed by a "Closes:" one [2]. As detailed in the first patch, this "Closes:" tag is used for a bit of time, mainly by DRM and MPTCP subsystems. It is used by some bug trackers to automate the closure of issues when a patch is accepted. It is even planned to use this tag with bugzilla.kernel.org [3]. The first patch updates the documentation to explain what is this "Closes:" tag and how/when to use it. The second patch modifies checkpatch.pl to stop complaining about it. The DRM maintainers and their mailing list have been added in Cc as they are probably interested by these two patches as well. [1] https://lore.kernel.org/all/3b036087d80b8c0e07a46a1dbaaf4ad0d018f8d5.1674217480.git.linux@leemhuis.info/ [2] https://lore.kernel.org/all/bb5dfd55ea2026303ab2296f4a6df3da7dd64006.1674217480.git.linux@leemhuis.info/ [3] https://lore.kernel.org/linux-doc/20230315181205.f3av7h6owqzzw64p@meerkat.local/ Signed-off-by: Matthieu Baerts --- Note: After having re-read the comments from the v1, it is still unclear to me if this "Closes:" can be accepted or not. But because it seems that the future Bugzilla bot for kernel.org is going to use it, I'm sending here a v2. I'm sorry if I misunderstood the comments from v1. Please ignore this v2 if I did. Changes in v2: - Patch 1/2: - Add Konstantin's Acked-by: even if the patch has changed a bit, the concept is still the same, I hope that's OK. - Mention "public" in "5.Posting.rst" file as well. (Jonathan Corbet) - Re-phrase the new text from "5.Posting.rst". (Bagas Sanjaya & Thorsten Leemhuis) - Clearly mention that private bug trackers and invalid URLs are forbidden (Linus Torvalds). - Rebased on top of Linus' repo. - Link to v1: https://lore.kernel.org/r/20230314-doc-checkpatch-closes-tag-v1-0-1b83072e9a9a@tessares.net --- Matthieu Baerts (2): docs: process: allow Closes tags with links checkpatch: allow Closes tags with links Documentation/process/5.Posting.rst | 9 +++++++++ Documentation/process/submitting-patches.rst | 9 +++++++++ scripts/checkpatch.pl | 16 ++++++++-------- 3 files changed, 26 insertions(+), 8 deletions(-) --- base-commit: cb7f5b41f8341148050fe63e27cf52aa4f1519ad change-id: 20230314-doc-checkpatch-closes-tag-1731b57556b1 Best regards,