compile libvirt error

When I compile it, I report the following error

GEN manpages/virt-admin.html.in :29: (ERROR/3) Error in "code-block" directive: 1 argument(s) required, 0 supplied.

.. code-block::

virt-admin [OPTION]... [ARG].

Someone already complained about this here: https://www.redhat.com/archives/libvirt-users/2020-April/msg00088.html

If you look here: https://gitlab.com/libvirt/libvirt/-/pipelines/158898402, our pipelines are green across all platforms but one (mips crossbuild debian which is irrelevant here). So, can you share what version of python3 docutils you use? Our Ubuntu-1804 uses the distro-provided python3-docutils-0.14 which works well.

I install python3-docutils-0.14, ubuntu 18.04 server

Are you positive you don't have a conflicting version of docutils installed through pip as the user that runs the libvirt build, IOW does invoking "pip list --user | grep docutils" return an empty list? You can also verify the same think by editing the docs/Makefile.am by adding "$(RST2MAN) --version; " and checking the output whether the rst2man taken by libvirt build is indeed the one installed from python3-docutils. In any case, since the build clearly passes in our pipelines, the problem is outside of libvirt.

Are you positive you don't have a conflicting version of docutils installed through pip as the user that runs the libvirt build, IOW does invoking "pip list --user | grep docutils" return an empty list?

Actually, ^this won't help at all, even if you had a conflicting package installed, libvirt would still take it from /usr/bin, the only case where that would apply would be if you'd created a symlink in /usr/bin pointing to the user installed pip version of rst2man, which I expect is not the case. You can further investigate with our CI containers, by running make -C ci ci-shell@ubuntu-1804 and looking around what is installed and in what version and compare to your system.

I'll try it

I don't wanna open the request. Just leaving a comment for anyone who faces the same issue in the future.

You will get the code-block:: error if you have rst2html5 installed via pip3 pip3 install rst2html5.

The ci build installs rst2html via python3-docutils apt install python3-docutils.

Uninstalling rst2html5 package from pip3, should make it run without error.

Closing since there's been no update and we know it works with distro provided packages

closed

mentioned in commit cf0c9e18