[rtems-docs PATCH] sphinx/style: Fix building with the latest sphinx

[Chris Johns]

On 20/12/2023 8:12 am, Joel Sherrill wrote:
> I tried the patch on Rocky 9 with Python 3.9.14 and sphinx-build  5.3.0 from a
> pip local install.
> 
> (rtemsdocs) [joel at localhost rtems-docs]$ ./waf distclean
> Waf: The wscript in '/home/joel/rtems-work/rtems-docs' is unreadable
> Traceback (most recent call last):
>   File
> "/home/joel/rtems-work/rtems-docs/.waf3-2.0.25-767522112be77f8585812fcfaa08e805/waflib/Scripting.py", line 102, in waf_entry_point
>     set_main_module(wscript)
>   File
> "/home/joel/rtems-work/rtems-docs/.waf3-2.0.25-767522112be77f8585812fcfaa08e805/waflib/Scripting.py", line 142, in set_main_module
>     Context.g_module=Context.load_module(file_path)
>   File
> "/home/joel/rtems-work/rtems-docs/.waf3-2.0.25-767522112be77f8585812fcfaa08e805/waflib/Context.py", line 362, in load_module
>     exec(compile(code,path,'exec'),module.__dict__)
>   File "/home/joel/rtems-work/rtems-docs/wscript", line 17, in <module>
>     from common import waf as docs_waf
>   File "/home/joel/rtems-work/rtems-docs/common/waf.py", line 17, in <module>
>     import conf
>   File "/home/joel/rtems-work/rtems-docs/common/conf.py", line 87, in <module>
>     import sphinx_rtd_theme_rtems
>   File
> "/home/joel/rtems-work/rtems-docs/common/sphinx_rtd_theme_rtems/__init__.py",
> line 9, in <module>
>     import sphinx
> ModuleNotFoundError: No module named 'sphinx'
> 
> Any ideas what I might be missing?

This looks like a local set up issue.

My testing was with python 3.11, venv and pip in the virtual env.

> FWIW the patch didn't apply on my CentOS 7 VM with an even older Sphinx.

The patch is from git to the mailing list. It is now pushed to master so please
try there.

Chris