On Wed, Oct 23, 2024 at 1:17 PM Randy Dunlap <rdunlap@xxxxxxxxxxxxx> wrote: > > [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) If no one write code to collect this graph, our hust openatom club could help contribute this script. > > > 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... I asked this question because I did not find this tool or script in the mainline tree. This script seems useful. It could help prune old/invalid link and prevent invalid links into documentation tree. Dongliang Mu > > > -- > ~Randy >
