On Mon, May 19, 2025 at 11:57:12AM +0800, Dongliang Mu wrote: > On Mon, May 19, 2025 at 11:35 AM Randy Dunlap <rdunlap@xxxxxxxxxxxxx> wrote: > > > > > > > > On 5/18/25 8:11 PM, Philip Li wrote: > > > On Mon, May 19, 2025 at 10:24:20AM +0800, Alex Shi wrote: > > >> Yanteng Si <si.yanteng@xxxxxxxxx> 于2025年5月16日周五 18:02写道： > > >>> > > >>> Hi robot, > > >>> > > >>> 在 5/16/25 7:04 AM, kernel test robot 写道: > > >>>> Warning: Documentation/translations/zh_CN/how-to.rst references a file that doesn't exist: Documentation/xxx/xxx.rst > > >>> > > >>> I didn't reproduce this warning locally. It seems to be a difference > > >>> > > >>> between different versions of Sphinx. > > >>> > > >>> Could you please provide your Sphinx version? > > >> > > >> > > >> I can't reproduce it too. My sphinx tools version is 7.2.6. > > >> And it looks like a incorrect warnning. > > > > > > Sorry for late response, the Sphinx version the bot use is 2.4.4, and it also enables > > > > JFYI, Documentation/Changes says that the minimal Sphinx version is 3.4.3. > > $ make htmldocs > ERROR: Sphinx version is 1.8.5. It should be >= 3.4.3 > Detected OS: Ubuntu 20.04.6 LTS. > Sphinx version: 1.8.5 > > To upgrade Sphinx, use: > > /usr/bin/python3 -m venv sphinx_latest > . sphinx_latest/bin/activate > pip install -r ./Documentation/sphinx/requirements.txt > > If you want to exit the virtualenv, you can use: > deactivate > > 2) As a package with: > > sudo apt-get install python3-sphinx > > Please note that Sphinx >= 3.0 will currently produce false-positive > warning when the same name is used for more than one type (functions, > structs, enums,...). This is known Sphinx bug. For more details, see: > https://github.com/sphinx-doc/sphinx/pull/8313 > > All optional dependencies are met. > Can't build as 1 mandatory dependency is missing at > ./scripts/sphinx-pre-install line 984. > > For older versions, you will encounter the above error. Got it, thanks for detail info, i will resolve the issue to upgrade the tool chain at bot side. > > > > > > > > kconfigs like CONFIG_COMPILE_TEST, CONFIG_WARN_MISSING_DOCUMENTS, CONFIG_WARN_ABI_ERRORS, > > > refer to [1] for detail. Hope this is useful. > > > > > > [1] https://download.01.org/0day-ci/archive/20250516/202505160627.WtzIIpL6-lkp@xxxxxxxxx/reproduce > > > > > >> > > >> Alex > > >> > > > > > > > -- > > ~Randy > > > >
