[LTP] [PATCH] doc: fix documentation build with latest setuptools

Petr Vorel pvorel@suse.cz
Thu Feb 12 10:32:57 CET 2026


> On Thu Feb 12, 2026 at 9:48 AM CET, Petr Vorel wrote:
> > Hi Andrea,

> > > Hi!
> > > > Force setuptools to version 81.0.0, which is the last one where linuxdoc
> > > > still can be installed. Also, from python 3.12 setuptools is not
> > > > available anymore when creating a new virtualenv, so we need to force
> > > > its installation to ensure that documentation will be built.

> > Reviewed-by: Petr Vorel <pvorel@suse.cz>

> > +1, higher setuptools version is probably better as it's still working on the
> > oldest distros (than 68 version I added in my patchset). IMHO it'd be good to
> > add (before merge) a comment to requirements.txt that it's just a temporary
> > workaround (once linuxdoc is released I'd upgrade it and remove the dependency).

> > Kind regards,
> > Petr

> It's not a workaround, we need it because python 3.12 removed it from
> virtualenv. It explained in the git commit message in my patch.

It is a workaround in a sense because new linuxdoc master thanks to my fix [1]
will not need setuptools any more (which I explained in my patch). Normally we
would update, but upstream does not have time to release.

Also, new release will use hatch, we'll need to use pyproject.toml instead of
requirements.txt.

Kind regards,
Petr

[1] https://github.com/return42/linuxdoc/commit/19f5e5cbe8fec100d9135cfb7d3f183fa9dc0642
[2] https://hatch.pypa.io/latest/


More information about the ltp mailing list