docs/zh_CN: Add kbuild timestamp Chinese translation

[PATCH v2] docs/zh_CN: Add kbuild timestamp Chinese translation

Posted by Chenguang Zhao 1 month, 1 week ago

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")

Signed-off-by: Chenguang Zhao <zhaochenguang@kylinos.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
 ------------------------------------
-- 
2.25.1

Re: [PATCH v2] docs/zh_CN: Add kbuild timestamp Chinese translation

Posted by Dongliang Mu 1 month, 1 week ago

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@hust.edu.cn>
Reviewed-by: Alex Shi <alexs@kernel.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.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@kylinos.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
>   ------------------------------------

Re: [PATCH v2] docs/zh_CN: Add kbuild timestamp Chinese translation

Posted by Alex Shi 1 month ago

Applied, Thanks

Dongliang Mu <dzm91@hust.edu.cn> 于2025年11月7日周五 00:34写道：
>
>
> 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@hust.edu.cn>
> Reviewed-by: Alex Shi <alexs@kernel.org>
> Signed-off-by: Jonathan Corbet <corbet@lwn.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@kylinos.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
> >   ------------------------------------
>

Re: [PATCH v2] docs/zh_CN: Add kbuild timestamp Chinese translation

Posted by Dongliang Mu 1 month ago

On Mon, Nov 17, 2025 at 1:32 PM Alex Shi <seakeel@gmail.com> wrote:
>
> Applied, Thanks

Hi Alex,

Please revert this patch since I do not give my reviewed-by tag

>
> Dongliang Mu <dzm91@hust.edu.cn> 于2025年11月7日周五 00:34写道：
> >
> >
> > 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@hust.edu.cn>
> > Reviewed-by: Alex Shi <alexs@kernel.org>
> > Signed-off-by: Jonathan Corbet <corbet@lwn.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@kylinos.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
> > >   ------------------------------------
> >
>

Re: [PATCH v2] docs/zh_CN: Add kbuild timestamp Chinese translation

Posted by Alex Shi 1 month ago

Dongliang Mu <mudongliangabcd@gmail.com> 于2025年11月17日周一 13:54写道：
>
> On Mon, Nov 17, 2025 at 1:32 PM Alex Shi <seakeel@gmail.com> wrote:
> >
> > Applied, Thanks
>
> Hi Alex,
>
> Please revert this patch since I do not give my reviewed-by tag

Oops, Sorry. the patch reverted.

Thanks!