DPDK-dev Archive on lore.kernel.org
 help / color / Atom feed
* [dpdk-dev] [PATCH v2] doc: disable doxygen's HAVE_DOT tag
@ 2019-10-23 11:56 Ali Alnubani
  2019-10-29 13:31 ` Mcnamara, John
  0 siblings, 1 reply; 3+ messages in thread
From: Ali Alnubani @ 2019-10-23 11:56 UTC (permalink / raw)
  To: dev

Ubuntu ships with a patched version of doxygen that enables
HAVE_DOT (disabled by default). Enabling this option causes the warning:
"""
warning: Included by graph for 'rte_common.h' not generated,
too many nodes. Consider increasing DOT_GRAPH_MAX_NODES
"""
This reproduces with doxygen version 1.8.13 and
dot - graphviz version 2.40.1 on Ubuntu 18.04.

This will force doxygen not to assume that dot (part of Graphviz)
is installed, and will result in dot not being used for visualization.

If someone still needs to generate the graphs, the following can
be considered:
- Increase DOT_GRAPH_MAX_NODES to a large value.
- Set HAVE_DOT for more powerful graphs.
- Set DOT_IMAGE_FORMAT=svg to generate svg images.
- Set INTERACTIVE_SVG=YES to allow zooming and panning.

See:
- http://changelogs.ubuntu.com/changelogs/pool/main/d/doxygen/doxygen_1.8.13-10/changelog
- http://www.doxygen.nl/manual/config.html#cfg_have_dot
- https://github.com/doxygen/doxygen/issues/7345

Signed-off-by: Ali Alnubani <alialnu@mellanox.com>
---
 doc/api/doxy-api.conf.in | 2 ++
 1 file changed, 2 insertions(+)

Changes in v2:
- Updated commit's body.

diff --git a/doc/api/doxy-api.conf.in b/doc/api/doxy-api.conf.in
index 908cee8f7..8e6cff79a 100644
--- a/doc/api/doxy-api.conf.in
+++ b/doc/api/doxy-api.conf.in
@@ -98,3 +98,5 @@ GENERATE_HTML           = YES
 HTML_OUTPUT             = @HTML_OUTPUT@
 GENERATE_LATEX          = NO
 GENERATE_MAN            = NO
+
+HAVE_DOT                = NO
-- 
2.23.0


^ permalink raw reply	[flat|nested] 3+ messages in thread

* Re: [dpdk-dev] [PATCH v2] doc: disable doxygen's HAVE_DOT tag
  2019-10-23 11:56 [dpdk-dev] [PATCH v2] doc: disable doxygen's HAVE_DOT tag Ali Alnubani
@ 2019-10-29 13:31 ` Mcnamara, John
  2019-11-08 15:17   ` Thomas Monjalon
  0 siblings, 1 reply; 3+ messages in thread
From: Mcnamara, John @ 2019-10-29 13:31 UTC (permalink / raw)
  To: Ali Alnubani, dev; +Cc: Thomas Monjalon



> -----Original Message-----
> From: dev <dev-bounces@dpdk.org> On Behalf Of Ali Alnubani
> Sent: Wednesday, October 23, 2019 12:56 PM
> To: dev@dpdk.org
> Subject: [dpdk-dev] [PATCH v2] doc: disable doxygen's HAVE_DOT tag
> 
> Ubuntu ships with a patched version of doxygen that enables HAVE_DOT
> (disabled by default). Enabling this option causes the warning:


We have also started seeing this on some recent build systems as well.
Thanks for the fix. I think this should be merged soon in case it break
doc builds for other people.


Acked-by: John McNamara <john.mcnamara@intel.com>


^ permalink raw reply	[flat|nested] 3+ messages in thread

* Re: [dpdk-dev] [PATCH v2] doc: disable doxygen's HAVE_DOT tag
  2019-10-29 13:31 ` Mcnamara, John
@ 2019-11-08 15:17   ` Thomas Monjalon
  0 siblings, 0 replies; 3+ messages in thread
From: Thomas Monjalon @ 2019-11-08 15:17 UTC (permalink / raw)
  To: Ali Alnubani; +Cc: dev, Mcnamara, John

> > Ubuntu ships with a patched version of doxygen that enables HAVE_DOT
> > (disabled by default). Enabling this option causes the warning:
> 
> 
> We have also started seeing this on some recent build systems as well.
> Thanks for the fix. I think this should be merged soon in case it break
> doc builds for other people.
> 
> 
> Acked-by: John McNamara <john.mcnamara@intel.com>

Applied, thanks




^ permalink raw reply	[flat|nested] 3+ messages in thread

end of thread, back to index

Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2019-10-23 11:56 [dpdk-dev] [PATCH v2] doc: disable doxygen's HAVE_DOT tag Ali Alnubani
2019-10-29 13:31 ` Mcnamara, John
2019-11-08 15:17   ` Thomas Monjalon

DPDK-dev Archive on lore.kernel.org

Archives are clonable:
	git clone --mirror https://lore.kernel.org/dpdk-dev/0 dpdk-dev/git/0.git

	# If you have public-inbox 1.1+ installed, you may
	# initialize and index your mirror using the following commands:
	public-inbox-init -V2 dpdk-dev dpdk-dev/ https://lore.kernel.org/dpdk-dev \
		dev@dpdk.org
	public-inbox-index dpdk-dev

Example config snippet for mirrors

Newsgroup available over NNTP:
	nntp://nntp.lore.kernel.org/org.dpdk.dev


AGPL code for this site: git clone https://public-inbox.org/public-inbox.git