[dpdk-dev] Error building documentation

[David Marchand]

On Mon, Feb 8, 2021 at 2:44 PM Murrell, Brian <brian.murrell at intel.com> wrote:
>
> When I add "-Denable_docs=true" to my DPDK 20.11 build commandline I
> get a build error:
>
> FAILED: doc/guides/html
> /usr/bin/python3.6 ../buildtools/call-sphinx-build.py /bin/sphinx-build
> 20.11.0 /home/brian/daos/rpm/dpdk/_topdir/BUILD/dpdk-20.11/doc/guides
> /home/brian/daos/rpm/dpdk/_topdir/BUILD/dpdk-20.11/build/doc/guides
> Traceback (most recent call last):
>   File "../buildtools/call-sphinx-build.py", line 22, in <module>
>     if StrictVersion(ver) >= StrictVersion('1.7'):
>   File "/usr/lib64/python3.6/distutils/version.py", line 40, in
> __init__
>     self.parse(vstring)
>   File "/usr/lib64/python3.6/distutils/version.py", line 137, in parse
>     raise ValueError("invalid version number '%s'" % vstring)
> ValueError: invalid version number 'these.'
>
> Is this a known issue?

I guess you use an old sphinx version, like maybe sphinx on RHEL7 ?

Example on my rhel7:

$ sphinx-build --version
Sphinx v1.1.3
[...]
* with -a, write all files.
* with filenames, write these.

Afaics, we require sphinx >= 1.7 for building the documentation.


-- 
David Marchand