On a Friday in 2020, Daniel P. Berrangé wrote:
On Fri, Sep 25, 2020 at 11:23:57AM +0200, Andrea Bolognani wrote:
> On Fri, 2020-09-25 at 10:16 +0100, Daniel P. Berrangé wrote:
> > On Fri, Sep 25, 2020 at 05:03:24PM +0800, Wei Wang wrote:
> > > /usr/local/bin/rst2html5 --stylesheet= --strict docs/manpages/virsh.rst
> > > docs/manpages/virsh.rst:41: (ERROR/3) Error in "code-block"
directive:
> > > 1 argument(s) required, 0 supplied.
> > >
> > > .. code-block::
> > >
> > > virsh [OPTION]... <command> <domain> [ARG]...
> >
> > This is a sign of having a bad version of "rst2html5" installed.
> >
> > We expect to be using rst2html5 that comes with python docutils
> > package.
>
> Yeah, the python3-docutils Debian package will contain a working
> rst2html5 binary.
>
> > There is a completely different rst2html5 that people might get
> > from "pip" if you did "pip install rst2html5". This version
is
> > broken and unusable and so needs to be removed.
>
> Can we do something to get that package off PyPi? It's not the first
> time the overlap has caused trouble for our users, and it certainly
> won't be the last...
Well it is not really our place to demand its removal. It isn't violating
any rules of PyPi and AFAICT, it existed before docutils provided the
same binary name.
The only good course of action is probably to submit a patch to actually
make it work.
I'll see whether we can somehow detect the correct version earlier.
Jano