Re: [lwn:docs-next 37/72] htmldocs: Warning: Documentation/translations/zh_CN/how-to.rst references a file that doesn't exist: Documentation/xxx/xxx.rst

[Philip Li <philip.li@intel.com>]

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@infradead.org> 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@linux.dev> 于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@intel.com/reproduce
> > >
> > >>
> > >> Alex
> > >>
> > >
> >
> > --
> > ~Randy
> >
> >