From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-14.7 required=3.0 tests=HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_PATCH,MAILING_LIST_MULTI, MENTIONS_GIT_HOSTING,SIGNED_OFF_BY,SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED, USER_AGENT_GIT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 815D2CA9EB6 for ; Wed, 23 Oct 2019 11:56:16 +0000 (UTC) Received: from dpdk.org (dpdk.org [92.243.14.124]) by mail.kernel.org (Postfix) with ESMTP id 3895420650 for ; Wed, 23 Oct 2019 11:56:16 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 3895420650 Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=mellanox.com Authentication-Results: mail.kernel.org; spf=pass smtp.mailfrom=dev-bounces@dpdk.org Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 858B41C11E; Wed, 23 Oct 2019 13:56:15 +0200 (CEST) Received: from git-send-mailer.rdmz.labs.mlnx (unknown [37.142.13.130]) by dpdk.org (Postfix) with ESMTP id 76C801C10F for ; Wed, 23 Oct 2019 13:56:14 +0200 (CEST) From: Ali Alnubani To: dev@dpdk.org Date: Wed, 23 Oct 2019 14:56:09 +0300 Message-Id: <20191023115609.6684-1-alialnu@mellanox.com> X-Mailer: git-send-email 2.23.0 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Subject: [dpdk-dev] [PATCH v2] doc: disable doxygen's HAVE_DOT tag X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "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 --- 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