From nobody Mon Feb 9 21:37:26 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 C022127BF80; Thu, 23 Oct 2025 16:10:51 +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=1761235853; cv=none; b=eMUN6dqhoOX+RRYIYrLty3plHcoBnr6BFV7H8nwdwVbU3RXcsm6wreB1giJnd9g+HNtGUuAtf13OdPFoIdK7LbfOySex8ObTDlthJD2W+lmRnaRvmlKjp+KuUVXlOP8IYj3eQ/bbE3T2TnuC0fUDKS+CJox+oX7YQNeFrRqz/zs= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1761235853; c=relaxed/simple; bh=1DeAt+miaf7OBthY5pdWlHKaoZyqCaTCoxx2d2ZGGEw=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=XY87AqHBa2lmx8iwX8GVYO/01QNAT2c6O35lBHX5JibKB520TyVJKlJGWNyW9J7XyCh4jXKRMysree1Zy15bMspJOnJYI1yeFKDqMN4oKpGLmzgQNbqP9b18v4qaLZZaGWryM0kQexfj21TcDZzkK7qQkQPxK8/6F4/SZG9n7sQ= 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=f4VUpO5D; 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="f4VUpO5D" DKIM-Filter: OpenDKIM Filter v2.11.0 ms.lwn.net 6221C40B38 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lwn.net; s=20201203; t=1761235845; bh=9rMXRjXbCdAJHtM1bzSH9NAyKdbEgLHTKEMBp8A8CXg=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=f4VUpO5Dje4PP4FS9Fd8LAgWYAIlsn+6QwPbhL7/u5j+s/AgYlSSE4w1aYESYf8+c Pa4p8naJVQ70azLynaJMQa6Ssmcs88O2h1kM7Gk7pVt0PulAPlpfGkPt3JVIZpp7qb VhI1LmtOP+jkimWIXqML+GJN3DQ7r5NVpQlO0G05fQRB+mQqMcxC7Hhhw00bUKp7V+ 2P78ijB8r17A7tPGTCH1/dbCo4Mx4x4nvL61CcyY6tnj4JQPYlsJAz+2UCgEHXI4Zd GMgS/XDApHdW1h/r54Q6qqoxWhS7zdb4RTbtiPPczKoJG8c+fxnRBqKOGaPLPumnNH 6W4Mdvjs4zFVQ== Received: from trenco.lwn.net (unknown [IPv6:2601:280:4600:2da9::1fe]) by ms.lwn.net (Postfix) with ESMTPA id 6221C40B38; Thu, 23 Oct 2025 16:10:44 +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 , Alex Shi , Yanteng Si , Dongliang Mu Subject: [PATCH v2 02/10] docs: move checktransupdate.py to tools/docs Date: Thu, 23 Oct 2025 10:10:10 -0600 Message-ID: <20251023161027.697135-3-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 The checktranslate.py tool currently languishes in scripts/; move it to tools/docs and update references accordingly. Cc: Alex Shi Cc: Yanteng Si Cc: Dongliang Mu Signed-off-by: Jonathan Corbet Reviewed-by: Dongliang Mu --- Documentation/doc-guide/checktransupdate.rst | 6 +++--- .../translations/zh_CN/doc-guide/checktransupdate.rst | 6 +++--- Documentation/translations/zh_CN/how-to.rst | 2 +- MAINTAINERS | 2 +- {scripts =3D> tools/docs}/checktransupdate.py | 8 ++++---- 5 files changed, 12 insertions(+), 12 deletions(-) rename {scripts =3D> tools/docs}/checktransupdate.py (97%) diff --git a/Documentation/doc-guide/checktransupdate.rst b/Documentation/d= oc-guide/checktransupdate.rst index dfaf9d373747..7b25375cc6d9 100644 --- a/Documentation/doc-guide/checktransupdate.rst +++ b/Documentation/doc-guide/checktransupdate.rst @@ -27,15 +27,15 @@ Usage =20 :: =20 - ./scripts/checktransupdate.py --help + tools/docs/checktransupdate.py --help =20 Please refer to the output of argument parser for usage details. =20 Samples =20 -- ``./scripts/checktransupdate.py -l zh_CN`` +- ``tools/docs/checktransupdate.py -l zh_CN`` This will print all the files that need to be updated in the zh_CN loca= le. -- ``./scripts/checktransupdate.py Documentation/translations/zh_CN/dev-to= ols/testing-overview.rst`` +- ``tools/docs/checktransupdate.py Documentation/translations/zh_CN/dev-t= ools/testing-overview.rst`` This will only print the status of the specified file. =20 Then the output is something like: diff --git a/Documentation/translations/zh_CN/doc-guide/checktransupdate.rs= t b/Documentation/translations/zh_CN/doc-guide/checktransupdate.rst index d20b4ce66b9f..dbfd65398077 100644 --- a/Documentation/translations/zh_CN/doc-guide/checktransupdate.rst +++ b/Documentation/translations/zh_CN/doc-guide/checktransupdate.rst @@ -28,15 +28,15 @@ =20 :: =20 - ./scripts/checktransupdate.py --help + tools/docs/checktransupdate.py --help =20 =E5=85=B7=E4=BD=93=E7=94=A8=E6=B3=95=E8=AF=B7=E5=8F=82=E8=80=83=E5=8F=82= =E6=95=B0=E8=A7=A3=E6=9E=90=E5=99=A8=E7=9A=84=E8=BE=93=E5=87=BA =20 =E7=A4=BA=E4=BE=8B =20 -- ``./scripts/checktransupdate.py -l zh_CN`` +- ``tools/docs/checktransupdate.py -l zh_CN`` =E8=BF=99=E5=B0=86=E6=89=93=E5=8D=B0 zh_CN =E8=AF=AD=E8=A8=80=E4=B8=AD= =E9=9C=80=E8=A6=81=E6=9B=B4=E6=96=B0=E7=9A=84=E6=89=80=E6=9C=89=E6=96=87=E4= =BB=B6=E3=80=82 -- ``./scripts/checktransupdate.py Documentation/translations/zh_CN/dev-to= ols/testing-overview.rst`` +- ``tools/docs/checktransupdate.py Documentation/translations/zh_CN/dev-t= ools/testing-overview.rst`` =E8=BF=99=E5=B0=86=E5=8F=AA=E6=89=93=E5=8D=B0=E6=8C=87=E5=AE=9A=E6=96= =87=E4=BB=B6=E7=9A=84=E7=8A=B6=E6=80=81=E3=80=82 =20 =E7=84=B6=E5=90=8E=E8=BE=93=E5=87=BA=E7=B1=BB=E4=BC=BC=E5=A6=82=E4=B8=8B= =E7=9A=84=E5=86=85=E5=AE=B9=EF=BC=9A diff --git a/Documentation/translations/zh_CN/how-to.rst b/Documentation/tr= anslations/zh_CN/how-to.rst index ddd99c0f9b4d..0d51bdf72e95 100644 --- a/Documentation/translations/zh_CN/how-to.rst +++ b/Documentation/translations/zh_CN/how-to.rst @@ -437,7 +437,7 @@ git email =E9=BB=98=E8=AE=A4=E4=BC=9A=E6=8A=84=E9=80=81= =E7=BB=99=E6=82=A8=E4=B8=80=E4=BB=BD=EF=BC=8C=E6=89=80=E4=BB=A5=E6=82=A8=E5= =8F=AF=E4=BB=A5=E5=88=87=E6=8D=A2=E4=B8=BA=E5=AE=A1=E9=98=85=E8=80=85=E7=9A= =84=E8=A7=92 =E5=AF=B9=E4=BA=8E=E9=A6=96=E6=AC=A1=E5=8F=82=E4=B8=8E Linux =E5=86=85=E6= =A0=B8=E4=B8=AD=E6=96=87=E6=96=87=E6=A1=A3=E7=BF=BB=E8=AF=91=E7=9A=84=E6=96= =B0=E6=89=8B=EF=BC=8C=E5=BB=BA=E8=AE=AE=E6=82=A8=E5=9C=A8 linux =E7=9B=AE= =E5=BD=95=E4=B8=AD=E8=BF=90=E8=A1=8C=E4=BB=A5=E4=B8=8B=E5=91=BD=E4=BB=A4=EF= =BC=9A :: =20 - ./script/checktransupdate.py -l zh_CN`` + tools/docs/checktransupdate.py -l zh_CN`` =20 =E8=AF=A5=E5=91=BD=E4=BB=A4=E4=BC=9A=E5=88=97=E5=87=BA=E9=9C=80=E8=A6=81= =E7=BF=BB=E8=AF=91=E6=88=96=E6=9B=B4=E6=96=B0=E7=9A=84=E8=8B=B1=E6=96=87=E6= =96=87=E6=A1=A3=EF=BC=8C=E7=BB=93=E6=9E=9C=E5=90=8C=E6=97=B6=E4=BF=9D=E5=AD= =98=E5=9C=A8 checktransupdate.log =E4=B8=AD=E3=80=82 =20 diff --git a/MAINTAINERS b/MAINTAINERS index dafc11712544..1b5413e779f4 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -7301,8 +7301,8 @@ S: Maintained P: Documentation/doc-guide/maintainer-profile.rst T: git git://git.lwn.net/linux.git docs-next F: Documentation/ +F: tools/docs/ F: scripts/check-variable-fonts.sh -F: scripts/checktransupdate.py F: scripts/documentation-file-ref-check F: scripts/get_abi.py F: scripts/kernel-doc* diff --git a/scripts/checktransupdate.py b/tools/docs/checktransupdate.py similarity index 97% rename from scripts/checktransupdate.py rename to tools/docs/checktransupdate.py index e39529e46c3d..e894652369a5 100755 --- a/scripts/checktransupdate.py +++ b/tools/docs/checktransupdate.py @@ -9,9 +9,9 @@ commit to find the latest english commit from the translati= on commit differences occur, report the file and commits that need to be updated. =20 The usage is as follows: -- ./scripts/checktransupdate.py -l zh_CN +- tools/docs/checktransupdate.py -l zh_CN This will print all the files that need to be updated or translated in the= zh_CN locale. -- ./scripts/checktransupdate.py Documentation/translations/zh_CN/dev-tools= /testing-overview.rst +- tools/docs/checktransupdate.py Documentation/translations/zh_CN/dev-tool= s/testing-overview.rst This will only print the status of the specified file. =20 The output is something like: @@ -168,7 +168,7 @@ def check_per_file(file_path): def valid_locales(locale): """Check if the locale is valid or not""" script_path =3D os.path.dirname(os.path.abspath(__file__)) - linux_path =3D os.path.join(script_path, "..") + linux_path =3D os.path.join(script_path, "../..") if not os.path.isdir(f"{linux_path}/Documentation/translations/{locale= }"): raise ArgumentTypeError("Invalid locale: {locale}") return locale @@ -232,7 +232,7 @@ def config_logging(log_level, log_file=3D"checktransupd= ate.log"): def main(): """Main function of the script""" script_path =3D os.path.dirname(os.path.abspath(__file__)) - linux_path =3D os.path.join(script_path, "..") + linux_path =3D os.path.join(script_path, "../..") =20 parser =3D ArgumentParser(description=3D"Check the translation update") parser.add_argument( --=20 2.51.0