| lists.openwall.net | lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC | |
|
Open Source and information security mailing list archives
| ||
|
Message-ID: <7e6096ab-18bd-4438-8fbb-3f530ee9e69f@hust.edu.cn>
Date: Fri, 7 Nov 2025 00:33:07 +0800
From: Dongliang Mu <dzm91@...t.edu.cn>
To: Chenguang Zhao <zhaochenguang@...inos.cn>, Alex Shi <alexs@...nel.org>,
Yanteng Si <si.yanteng@...ux.dev>, Jonathan Corbet <corbet@....net>
Cc: linux-doc@...r.kernel.org, linux-kernel@...r.kernel.org,
HUST OS Kernel Contribution <hust-os-kernel-patches@...glegroups.com>
Subject: Re: [PATCH v2] docs/zh_CN: Add kbuild timestamp Chinese translation
On 11/6/25 9:51 AM, Chenguang Zhao wrote:
> Sync the translation of changes in kbuild/kbuild.rst about
> KBUILD_BUILD_TIMESTAMP.
>
> Update the translation through commit 5cbfb4da7e06
> ("kbuild: doc: improve KBUILD_BUILD_TIMESTAMP documentation")
Hi, I know where the problem is.
If you want to improve or revise the kernel documentation, please
directly submit the changes to the original English document. Our
Chinese translation for now is just the translation of the English
documentation.
And this commit id should be the commit of the corresponding English
documents.
Take kbuild/kbuild.rst as an example, the latest commit of Chinese
translation shows:
-----------------------------------------------------------------------------------------------------------
docs/zh_CN: add the translation of kbuild/kbuild.rst
Finish the translation of kbuild/kbuild.rst and move kbuild
from TODO to the main body.
Update to commit 2eb5d7f24299 ("kbuild: doc: describe the -C
option precisely for external module builds")
Signed-off-by: Dongliang Mu <dzm91@...t.edu.cn>
Reviewed-by: Alex Shi <alexs@...nel.org>
Signed-off-by: Jonathan Corbet <corbet@....net>
Link: https://lore.kernel.org/r/20241016131710.2619567-1-dzm91@hust.edu.cn
-----------------------------------------------------------------------------------------------------------
However, the commit history of English documentation goes further:
2025-01-15 kbuild: rust: add PROCMACROLDFLAGS
2024-11-28 kbuild: support building external modules in a separate
build directory
2024-09-24 kbuild: doc: describe the -C option precisely for external
module builds
2024-09-20 kbuild: generate offset range data for builtin modules
We need to update the new translations of doc changes in ("kbuild: rust:
add PROCMACROLDFLAGS") and ("kbuild: support building external modules
in a separate build directory")
>
> Signed-off-by: Chenguang Zhao <zhaochenguang@...inos.cn>
> ---
> v2:
> - modify the commit message as suggested by Dongliang and add
> a corresponding commit info for the English documentation.
> ---
> Documentation/translations/zh_CN/kbuild/kbuild.rst | 9 +++++++--
> 1 file changed, 7 insertions(+), 2 deletions(-)
>
> diff --git a/Documentation/translations/zh_CN/kbuild/kbuild.rst b/Documentation/translations/zh_CN/kbuild/kbuild.rst
> index e5e2aebe1ebc..ad3e84eabbbf 100644
> --- a/Documentation/translations/zh_CN/kbuild/kbuild.rst
> +++ b/Documentation/translations/zh_CN/kbuild/kbuild.rst
> @@ -290,8 +290,13 @@ IGNORE_DIRS
> KBUILD_BUILD_TIMESTAMP
> ----------------------
> 将该环境变量设置为日期字符串，可以覆盖在 UTS_VERSION 定义中使用的时间戳
> -（运行内核时的 uname -v）。该值必须是一个可以传递给 date -d 的字符串。默认值是
> -内核构建某个时刻的 date 命令输出。
> +（运行内核时的 uname -v）。该值必须是一个可以传递给 date -d 的字符串。例如::
> +
> + $ KBUILD_BUILD_TIMESTAMP="Mon Oct 13 00:00:00 UTC 2025" make
> +
> +默认值是内核构建某个时刻的date命令输出。如果提供该时戳，它还用于任何initramfs
> +归档文件中的mtime字段。Initramfs mtimes是32位的，因此早于Unix纪元1970年，或
> +晚于协调世界时 (UTC)2106年2月7日6时28分15秒的日期是无效的。
>
> KBUILD_BUILD_USER, KBUILD_BUILD_HOST
> ------------------------------------
Powered by blists - more mailing lists