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.
>
>
> > 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
>
>
