[PATCH] doc: avoid using deprecated sphinx function

[Heinrich Schuchardt]

On 11/14/23 16:46, Tom Rini wrote:
> On Tue, Nov 14, 2023 at 03:18:02PM +0000, Caleb Connolly wrote:
>
>> The execfile_() function in sphinx has been removed after being
>> deprecated for some time. Follow what sphinx upstream does in [1] to
>> avoid using this function. This fixes "make htmldocs" on at least Arch
>> Linux but likely other distros too.

Hello Caleb,

Did you set up an environment as described in
https://docs.u-boot.org/en/latest/build/documentation.html?

Or did you try to build with other versions of packages than those
described in doc/sphinx/requirements.txt?

It would well make sense to rework our requirements as the Sphinx 3.4.3
we are using is getting dated.

Best regards

Heinrich

>>
>> [1]: https://github.com/sphinx-doc/sphinx/commit/9ced1e355ad6baecd4e755a598a54877dc0aad44
>>
>> Signed-off-by: Caleb Connolly <caleb.connolly at linaro.org>
>> ---
>> base-commit: 92b27528d777ce85362af45e7d2974a6c856219b
>
> I think we should cherry-pick:
> commit 0283189e8f3d0917e2ac399688df85211f48447b
> Author: Jonathan Corbet <corbet at lwn.net>
> Date:   Wed Jan 4 10:47:39 2023 -0700
>
>      docs: Fix the docs build with Sphinx 6.0
>
> from the kernel, to keep the file in-sync. That's the only commit to
> load_config.py since I believe we synced last, but there might be other
> changes in Documentation/sphinx/ to grab as well.
>