Suricata 7.0 compilation problem: Warning treated as Error in "table" directive

Developers
1

Greetings,

At the end of a compilation run on RHEL 8.8 the following was produced, these are the options used, I have not tried to run Suricata as of yet and I assume this is only an issue for documentation and not the actual functioning of Suricata itself.

/configure --prefix=/opt/suricata --with-libhs-includes=/usr/include/hs --with-libhs-libraries=/usr/local/lib64 --enable-af-packet=yes

make[2]: Entering directory ‘/root/installers/suricata-7.0.0/doc/userguide’
sysconfdir=/opt/suricata/etc
localstatedir=/opt/suricata/var
version=7.0.0
sphinx-build -q -W -b man -d _build/doctrees
…/…/doc/userguide _build/man

Warning, treated as error:
/REDACTED/installers/suricata-7.0.0/doc/userguide/support-status.rst:92:Error in “table” directive:
unknown option: “width”.

… table::
:widths: 20 15 15 10 40
:width: 100%

±-----------------±------------±---------±------±-------------------------------+
|Distribution |Version |Support |QA |Notes |
+==================+=============+==========+=======+================================+
|RHEL/CentOS |7 |OISF | | |
±-----------------±------------±---------±------±-------------------------------+
|RHEL/Alma/Rocky |8 |OISF | | |
±-----------------±------------±---------±------±-------------------------------+
|RHEL/Alma/Rocky |9 |OISF | | |
±-----------------±------------±---------±------±-------------------------------+
|Ubuntu |20.04 |OISF | | |
±-----------------±------------±---------±------±-------------------------------+
|Ubuntu |22.04 |OISF | | |
±-----------------±------------±---------±------±-------------------------------+
|Debian |10 (Buster) |OISF | | |
±-----------------±------------±---------±------±-------------------------------+
|Debian |11 (Bullseye)|OISF | |Foundation of SELKS |
±-----------------±------------±---------±------±-------------------------------+
|Debian |12 (Bookworm)|OISF | | |
±-----------------±------------±---------±------±-------------------------------+
|FreeBSD |12 |OISF | |Foundation of OPNsense, pfSense |
±-----------------±------------±---------±------±-------------------------------+
|FreeBSD |13 |OISF | |Foundation of OPNSense |
±-----------------±------------±---------±------±-------------------------------+
make[2]: *** [Makefile:643: _build/man] Error 2
make[2]: Leaving directory ‘/REDACTED/installers/suricata-7.0.0/doc/userguide’
make[1]: *** [Makefile:499: all-recursive] Error 1
make[1]: Leaving directory ‘/REDACTED/installers/suricata-7.0.0/doc’
make: *** [Makefile:494: all-recursive] Error 1

2

Our documentation now requires a newer version of Sphinx than what is found in RHEL 8. We’ll be adding a ./configure soon so that this doesn’t happen. For now you have the following options:

  • remove the python3-sphinx package so ./configure does not find it. The documentation will not be build then
  • ignore this error, perhaps using make -k COMMAND to ignore it

Sorry about this error.

Ticket: Bug #6297: configure/docs: check for a supported version of sphinx-build - Suricata - Open Information Security Foundation

3

Ok great thanks, it was just an FYI - what I did to solve the issue was
remove all instances of width from the file and that fixed it, not too
concerned with the documentation written to the system since the
Suricata project has all the docs you need online.

Greg