[adding Nick D. as author]
On 10/17/24 10:32 PM, Dongliang Mu wrote:
> Hi guys,
>
> when I translate kbuild/llvm.rst, I find this document seems depends
> on the reproducible-build.html. The depenency means, A will refer to
builds
> B, like the following contents.
>
> ``ccache`` 可以与 ``clang`` 一起使用，以改善后续构建（尽管在不同构建之间
> KBUILD_BUILD_TIMESTAMP_ 应设置为同一确定值，以避免 100% 的缓存未命中，
> 详见 Reproducible_builds_ 获取更多信息）::
>
> KBUILD_BUILD_TIMESTAMP='' make LLVM=1 CC="ccache clang"
>
> .. _KBUILD_BUILD_TIMESTAMP: kbuild.html#kbuild-build-timestamp
> .. _Reproducible_builds: reproducible-builds.html#timestamps
>
> I have several questions in mind:
>
> 1. Should we show this dependency graph for translators? This may help
> improve translation. Otherwise, it may occur that A has been
> translated, but it depends on B. And B needs translated so that the
> translation of A can be merged.
>
Yes. (IMHO)
> 2. Would there exist the loop? A depends on B and B depends on A
> directly or indirectly.
>
> If we only need to keep the documents in the mainline ready for
> reading, it seems not a problem.
>
> P.S., it seems current docs building cannot detect invalid URL in the
> documentation tree.
Hm, I thought that there was a script in scripts/ for that but I don't see it...
--
~Randy
