From nobody Tue Feb 10 03:44:47 2026 Received: from ms.lwn.net (ms.lwn.net [45.79.88.28]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 5841D296BC4; Thu, 23 Oct 2025 16:10:54 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=45.79.88.28 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1761235856; cv=none; b=hxYtZONheVgfhht/Gt5UpEHAnlDccVKaPAAB/K6/0lTDpQ19+rdLR+PuIr9wt4W5mbAyfemVUam/aAuR23C5BuNT4BX9NQMKuzqauhH3FJ88ELBXUMluEGCB9+EUP+92EPGtrdIlmMJjYvz1hVcGUPPCP3hwVeJdY8KMQHxiSl0= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1761235856; c=relaxed/simple; bh=B3WMrEoBGqxwlKaiXZCd7ySlsfrFx7s1x23iMC5lcXM=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=KjCWZ9mhgKC6/7PWUvHIycu7VlYq+CPgOVBVanVNwzl0uInvHlpYWfzVB8ggpz92cBS5Hl1AWeu5PqIuiqhuL4BIw9nPDoR7HFUDr/z1N8c2iW6Gytzs5faP/wSx7I8q4RsUBxvR4hENU762UhWFaRyxLaNp0AZKnhAt1neyCYA= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=lwn.net; spf=pass smtp.mailfrom=lwn.net; dkim=pass (2048-bit key) header.d=lwn.net header.i=@lwn.net header.b=FzwL4OJs; arc=none smtp.client-ip=45.79.88.28 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=lwn.net Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=lwn.net Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=lwn.net header.i=@lwn.net header.b="FzwL4OJs" DKIM-Filter: OpenDKIM Filter v2.11.0 ms.lwn.net B717840B42 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lwn.net; s=20201203; t=1761235850; bh=RtbYJANxx8V4mpWmI9ykigw4M/n+z/0Lqbs+aZPz0xU=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=FzwL4OJsf+uQ95LmsdQ4xZ646p2uX0QtWprLEjVnpxihfA0s/sthFt4/+IRlbHwYW V6rLJX6av0ic7kMdT/GR3aFgUrngTQ5FZsFkCGcYoa5qO2VkKk+QF53Q7cPobMn/UW CFP0/EJQ7tFeK6UovWO0Avcy9BjKWfWuxYsXQtnmcNc29jUWH835zse47nPUMtPk6B QqYXzyVkqktzkCD3aercBe11ApJF4rcfeocpwDO/0ym3NX21pbWOKZs/500F33EY4t POZTuPSiigb6X5DAt9P8wAnEeg8at5MsnLC4Q1R/0UaYFamqM0Mu5Vx9jRzalFVnHh Fd8hANWYpS8xA== Received: from trenco.lwn.net (unknown [IPv6:2601:280:4600:2da9::1fe]) by ms.lwn.net (Postfix) with ESMTPA id B717840B42; Thu, 23 Oct 2025 16:10:49 +0000 (UTC) From: Jonathan Corbet To: linux-doc@vger.kernel.org Cc: linux-kernel@vger.kernel.org, Mauro Carvalho Chehab , Akira Yokosawa , Randy Dunlap , Jani Nikula , Jonathan Corbet Subject: [PATCH v2 09/10] docs: move find-unused-docs.sh to tools/docs Date: Thu, 23 Oct 2025 10:10:17 -0600 Message-ID: <20251023161027.697135-10-corbet@lwn.net> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20251023161027.697135-1-corbet@lwn.net> References: <20251023161027.697135-1-corbet@lwn.net> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable ...and update references accordingly. Signed-off-by: Jonathan Corbet --- Documentation/doc-guide/contributing.rst | 2 +- Documentation/translations/zh_CN/doc-guide/contributing.rst | 2 +- {scripts =3D> tools/docs}/find-unused-docs.sh | 6 +++--- 3 files changed, 5 insertions(+), 5 deletions(-) rename {scripts =3D> tools/docs}/find-unused-docs.sh (85%) diff --git a/Documentation/doc-guide/contributing.rst b/Documentation/doc-g= uide/contributing.rst index 662c7a840cd5..f8047e633113 100644 --- a/Documentation/doc-guide/contributing.rst +++ b/Documentation/doc-guide/contributing.rst @@ -152,7 +152,7 @@ generate links to that documentation. Adding ``kernel-= doc`` directives to the documentation to bring those comments in can help the community derive the full value of the work that has gone into creating them. =20 -The ``scripts/find-unused-docs.sh`` tool can be used to find these +The ``tools/docs/find-unused-docs.sh`` tool can be used to find these overlooked comments. =20 Note that the most value comes from pulling in the documentation for diff --git a/Documentation/translations/zh_CN/doc-guide/contributing.rst b/= Documentation/translations/zh_CN/doc-guide/contributing.rst index 394a13b438b0..b0c8ba782b16 100644 --- a/Documentation/translations/zh_CN/doc-guide/contributing.rst +++ b/Documentation/translations/zh_CN/doc-guide/contributing.rst @@ -124,7 +124,7 @@ C=E4=BB=A3=E7=A0=81=E7=BC=96=E8=AF=91=E5=99=A8=E5=8F=91= =E5=87=BA=E7=9A=84=E8=AD=A6=E5=91=8A=E5=B8=B8=E5=B8=B8=E4=BC=9A=E8=A2=AB=E8= =A7=86=E4=B8=BA=E8=AF=AF=E6=8A=A5=EF=BC=8C=E4=BB=8E=E8=80=8C=E5=AF=BC=E8=87= =B4=E5=87=BA=E7=8E=B0=E4=BA=86 =E8=BF=99=E4=BD=BF=E5=BE=97=E8=BF=99=E4=BA=9B=E4=BF=A1=E6=81=AF=E6=9B=B4= =E9=9A=BE=E6=89=BE=E5=88=B0=EF=BC=8C=E4=BE=8B=E5=A6=82=E4=BD=BFSphinx=E6=97= =A0=E6=B3=95=E7=94=9F=E6=88=90=E6=8C=87=E5=90=91=E8=AF=A5=E6=96=87=E6=A1=A3= =E7=9A=84=E9=93=BE=E6=8E=A5=E3=80=82=E5=B0=86 ``kernel-doc`` =E6=8C=87=E4=BB=A4=E6=B7=BB=E5=8A=A0=E5=88=B0=E6=96=87=E6=A1=A3=E4=B8=AD= =E4=BB=A5=E5=BC=95=E5=85=A5=E8=BF=99=E4=BA=9B=E6=B3=A8=E9=87=8A=E5=8F=AF=E4= =BB=A5=E5=B8=AE=E5=8A=A9=E7=A4=BE=E5=8C=BA=E8=8E=B7=E5=BE=97=E4=B8=BA=E7=BC= =96=E5=86=99=E6=B3=A8=E9=87=8A=E6=89=80=E5=81=9A=E5=B7=A5=E4=BD=9C=E7=9A=84= =E5=85=A8=E9=83=A8=E4=BB=B7=E5=80=BC=E3=80=82 =20 -``scripts/find-unused-docs.sh`` =E5=B7=A5=E5=85=B7=E5=8F=AF=E4=BB=A5=E7=94= =A8=E6=9D=A5=E6=89=BE=E5=88=B0=E8=BF=99=E4=BA=9B=E8=A2=AB=E5=BF=BD=E7=95=A5= =E7=9A=84=E8=AF=84=E8=AE=BA=E3=80=82 +``tools/docs/find-unused-docs.sh`` =E5=B7=A5=E5=85=B7=E5=8F=AF=E4=BB=A5=E7= =94=A8=E6=9D=A5=E6=89=BE=E5=88=B0=E8=BF=99=E4=BA=9B=E8=A2=AB=E5=BF=BD=E7=95= =A5=E7=9A=84=E8=AF=84=E8=AE=BA=E3=80=82 =20 =E8=AF=B7=E6=B3=A8=E6=84=8F=EF=BC=8C=E5=B0=86=E5=AF=BC=E5=87=BA=E7=9A=84= =E5=87=BD=E6=95=B0=E5=92=8C=E6=95=B0=E6=8D=AE=E7=BB=93=E6=9E=84=E5=BC=95=E5= =85=A5=E6=96=87=E6=A1=A3=E6=98=AF=E6=9C=80=E6=9C=89=E4=BB=B7=E5=80=BC=E7=9A= =84=E3=80=82=E8=AE=B8=E5=A4=9A=E5=AD=90=E7=B3=BB=E7=BB=9F=E8=BF=98=E5=85=B7= =E6=9C=89=E4=BE=9B=E5=86=85=E9=83=A8 =E4=BD=BF=E7=94=A8=E7=9A=84kernel-doc=E6=B3=A8=E9=87=8A=EF=BC=9B=E9=99=A4= =E9=9D=9E=E8=BF=99=E4=BA=9B=E6=B3=A8=E9=87=8A=E6=94=BE=E5=9C=A8=E4=B8=93=E9= =97=A8=E9=92=88=E5=AF=B9=E7=9B=B8=E5=85=B3=E5=AD=90=E7=B3=BB=E7=BB=9F=E5=BC= =80=E5=8F=91=E4=BA=BA=E5=91=98=E7=9A=84=E6=96=87=E6=A1=A3=E4=B8=AD=EF=BC=8C diff --git a/scripts/find-unused-docs.sh b/tools/docs/find-unused-docs.sh similarity index 85% rename from scripts/find-unused-docs.sh rename to tools/docs/find-unused-docs.sh index 1fb265a0ffd0..2f2195a77c60 100755 --- a/scripts/find-unused-docs.sh +++ b/tools/docs/find-unused-docs.sh @@ -5,10 +5,10 @@ # This script detects files with kernel-doc comments for exported functions # that are not included in documentation. # -# usage: Run 'scripts/find-unused-docs.sh directory' from top level of ker= nel +# usage: Run 'tools/docs/find-unused-docs.sh directory' from top level of = kernel # tree. # -# example: $scripts/find-unused-docs.sh drivers/scsi +# example: $tools/docs/find-unused-docs.sh drivers/scsi # # Licensed under the terms of the GNU GPL License =20 @@ -18,7 +18,7 @@ if ! [ -d "Documentation" ]; then fi =20 if [ "$#" -ne 1 ]; then - echo "Usage: scripts/find-unused-docs.sh directory" + echo "Usage: tools/docs/find-unused-docs.sh directory" exit 1 fi =20 --=20 2.51.0