[dpdk-dev] Error building documentation

2 messages, 2 authors, 2021-02-15 · open the first message on its own page

[dpdk-dev] Error building documentation

From: Murrell, Brian <hidden>
Date: 2021-02-08 13:44:45

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?

Cheers,
b.

Re: [dpdk-dev] Error building documentation

From: David Marchand <hidden>
Date: 2021-02-15 08:27:19

On Mon, Feb 8, 2021 at 2:44 PM Murrell, Brian [off-list ref] 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
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help