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

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

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <CAD-N9QUUHmuC=jT+_mVKhMDstrb+9_-g+2zSKD3a9hrCtYnk1Q@mail.gmail.com>
Date: Mon, 17 Nov 2025 13:54:00 +0800
From: Dongliang Mu <mudongliangabcd@...il.com>
To: Alex Shi <seakeel@...il.com>
Cc: Dongliang Mu <dzm91@...t.edu.cn>, Chenguang Zhao <zhaochenguang@...inos.cn>, 
	Alex Shi <alexs@...nel.org>, Yanteng Si <si.yanteng@...ux.dev>, 
	Jonathan Corbet <corbet@....net>, 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 Mon, Nov 17, 2025 at 1:32 PM Alex Shi <seakeel@...il.com> wrote:
>
> Applied, Thanks

Hi Alex,

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

>
> Dongliang Mu <dzm91@...t.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@...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
> > >   ------------------------------------
> >
>