odoo/documentation#21056

Created by JunaidAhamed-7777

Blocked

label
JunaidAhamed-7777:18.0-fix-sphinx-setuptools Runbot
head
430d129dee291cc9a347631e9bcbcfd376ce02a8
odoo/documentation
18.0 #21056 missing r+
19.0
saas-19.2
saas-19.3
saas-19.4
20.0
master

[FIX] docs: restore the Sphinx 4 build in fresh environments

A fresh 18.0 documentation install can select setuptools 82 or later. Sphinx 4.3.2 still imports pkg_resources, which setuptools removed in 82.0.0. That makes make fast fail before it reads any pages. Keep setuptools below 82 on this branch until Sphinx can be upgraded.

Verification: On Python 3.12.14, the unpatched requirements selected setuptools 84.2.1 and make fast failed with ModuleNotFoundError: No module named 'pkg_resources'. The patched requirements selected setuptools 81.0.0 and make fast WORKERS=2 built all 1,065 source documents, with one warning about the optional Odoo source checkout. This does not change Python version support.

The 18.0 CLA PR is open and has not been merged.