Remove Sphinx as a required dependency by phlax · Pull Request #11 · sphinx-doc/sphinxcontrib-devhelp (original) (raw)

The approach taken here (and perhaps since commit 448fbf6 ("Support Python 3.9 and later")) makes it unnecessarily difficult to install or use Sphinx versions prior to 5. Sphinx since very early versions depends on sphinxcontrib-applehelp and sphinxcontrib-devhelp etc. without versions. Installing Sphinx < 5 pulls in latest sphinxcontrib-applehelp and sphinxcontrib-devhelp etc., because they satisfy the requirements. Then when you try to sphinx-build, you hit The sphinxcontrib.devhelp extension used by this project needs at least Sphinx v5.0; it therefore cannot be built with this version.

The only way to use Sphinx < 5 now is to figure out the versions of sphinxcontrib-applehelp and sphinxcontrib-devhelp and sphinxcontrib.htmlhelp (and maybe more, still in progress) that do not depend on Sphinx >= 5, and specify them explicitly like sphinxcontrib-devhelp==1.0.2 etc.