On 10/22/24 10:32 PM, Dongliang Mu wrote: > 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. > I (maybe too simply) thought that this could be a Makefile rule. <<< There are a few Makefiles in the Documentation tree. >> >>> 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. Looks like this has been rewritten. See Documentation/Makefile, target 'linkcheckdocs'. -- ~Randy
