[PATCH libnetfilter_queue] build: doc: Warn user if html docs will be missing diagrams

[PATCH libnetfilter_queue] build: doc: Warn user if html docs will be missing diagrams

[Duncan Roe]

libnetfilter_queue is unique among the netfilter libraries in having a
module hierarchy.
If 'dot' is available, Doxygen will make an interactive diagram for a module
with a child or a parent, allowing users to conveniently move up and down the
hierarchy.
Update configure to output a warning if 'dot' is not installed and html was
requested.

Signed-off-by: Duncan Roe <duncan_roe@optusnet.com.au>
---
 configure.ac | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/configure.ac b/configure.ac
index 416d58b..f279bcf 100644
--- a/configure.ac
+++ b/configure.ac
@@ -64,6 +64,10 @@ AS_IF([test "x$DOXYGEN" = x], [
 		enable_html_doc=no
 		enable_man_pages=no
 	])
+], [
+	dnl Warn user if html docs will be missing diagrams
+	AS_IF([test "$enable_html_doc" = yes -a -z "$DOT"],
+		AC_MSG_WARN([Dot not found - install graphviz to get interactive diagrams in HTML]))
 ])
 
 dnl Output the makefiles
-- 
2.17.5

Re: [PATCH libnetfilter_queue] build: doc: Warn user if html docs will be missing diagrams

[Pablo Neira Ayuso]

On Wed, Dec 01, 2021 at 11:39:38AM +1100, Duncan Roe wrote:
> libnetfilter_queue is unique among the netfilter libraries in having a
> module hierarchy.
> If 'dot' is available, Doxygen will make an interactive diagram for a module
> with a child or a parent, allowing users to conveniently move up and down the
> hierarchy.
> Update configure to output a warning if 'dot' is not installed and html was
> requested.

Applied, thanks