]> Gentwo Git Trees - linux/.git/commitdiff
docs: move find-unused-docs.sh to tools/docs
authorJonathan Corbet <corbet@lwn.net>
Wed, 13 Aug 2025 19:03:08 +0000 (13:03 -0600)
committerJonathan Corbet <corbet@lwn.net>
Tue, 28 Oct 2025 22:01:27 +0000 (16:01 -0600)
...and update references accordingly.

Reviewed-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Acked-by: Jani Nikula <jani.nikula@intel.com>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Documentation/doc-guide/contributing.rst
Documentation/translations/zh_CN/doc-guide/contributing.rst
tools/docs/find-unused-docs.sh [moved from scripts/find-unused-docs.sh with 85% similarity]

index 662c7a840cd5a491ad5525dd0000387ab656a519..f8047e63311378d60c1d29d9db9cd4fba82cc6c8 100644 (file)
@@ -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.
 
-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.
 
 Note that the most value comes from pulling in the documentation for
index 394a13b438b0f907f0d1a4c6f293f2295bae51a4..b0c8ba782b166597c2018be0052647b2383d7335 100644 (file)
@@ -124,7 +124,7 @@ C代码编译器发出的警告常常会被视为误报,从而导致出现了
 这使得这些信息更难找到,例如使Sphinx无法生成指向该文档的链接。将 ``kernel-doc``
 指令添加到文档中以引入这些注释可以帮助社区获得为编写注释所做工作的全部价值。
 
-``scripts/find-unused-docs.sh`` 工具可以用来找到这些被忽略的评论。
+``tools/docs/find-unused-docs.sh`` 工具可以用来找到这些被忽略的评论。
 
 请注意,将导出的函数和数据结构引入文档是最有价值的。许多子系统还具有供内部
 使用的kernel-doc注释;除非这些注释放在专门针对相关子系统开发人员的文档中,
similarity index 85%
rename from scripts/find-unused-docs.sh
rename to tools/docs/find-unused-docs.sh
index d6d397fbf91718627399895cfe18ab8a1ecf70bd..05552dbda5bcb2f20ca9ad18c3d38038d663fad6 100755 (executable)
@@ -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 kernel
+# 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
 
@@ -18,7 +18,7 @@ if ! [ -d "Documentation" ]; then
 fi
 
 if [ "$#" -ne 1 ]; then
-       echo "Usage: scripts/find-unused-docs.sh directory"
+       echo "Usage: tools/docs/find-unused-docs.sh directory"
        exit 1
 fi