]> git.ipfire.org Git - thirdparty/kernel/linux.git/commit
tools/docs,scripts: sphinx-*: prevent sphinx-build crashes
authorMauro Carvalho Chehab <mchehab+huawei@kernel.org>
Thu, 18 Sep 2025 11:54:51 +0000 (13:54 +0200)
committerJonathan Corbet <corbet@lwn.net>
Thu, 18 Sep 2025 17:18:39 +0000 (11:18 -0600)
commit82c294d453c0f065133da064f92a121500cc5643
treeec7ca26fe0eb9145014b15d3c2ace32bf8e678ba
parent08e14bc17eca275352f00defb17506799b99626c
tools/docs,scripts: sphinx-*: prevent sphinx-build crashes

On a properly set system, LANG and LC_ALL is always defined.
However, some distros like Debian, Gentoo and their variants
start with those undefioned.

When Sphinx tries to set a locale with:

locale.setlocale(locale.LC_ALL, '')

It raises an exception, making Sphinx fail. This is more likely
to happen with test containers.

Add a logic to detect and workaround such issue by setting
locale to C.

Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Message-ID: <1d0afad8fe3d83182be3a08eb00dd71322e23e69.1758196090.git.mchehab+huawei@kernel.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
tools/docs/sphinx-build-wrapper
tools/docs/sphinx-pre-install