[dpdk-dev] [PATCH v3] doc: remove warning with doxygen 1.9.7

jerinj at marvell.com jerinj at marvell.com
Fri Jun 2 13:06:59 CEST 2023


From: Jerin Jacob <jerinj at marvell.com>

Since doxygen 1.9.7 version, HTML_TIMESTAMP configuration option
changed to TIMESTAMP [2]. Fixed the following warning[1] by
removing TIMESTAMP options all together as all new versions(since 1.8.9)
of doxygen this option is disabled by default. Another option was
considered to have this configuration option based on version check, which
may not be worth having it, especially, external_program.version()
API introduced in 0.62.0 version of meson.

[1]
Warning: Tag 'HTML_TIMESTAMP' at line 115 of file 'doc/api/doxy-api.conf'
has become obsolete.

[2]
https://www.doxygen.nl/manual/config.html#cfg_timestamp

Cc: stable at dpdk.org

Signed-off-by: Jerin Jacob <jerinj at marvell.com>
---
v3:
- Based on Bruce's feedback, just removed the option all together to
  avoid special handling.
v2:
- use run_command() as
  https://mesonbuild.com/Reference-manual_returned_external_program.html#external_programversion
  introduced in 0.62 version and DPDK min meson version is 0.53.2.

 doc/api/doxy-api.conf.in | 1 -
 1 file changed, 1 deletion(-)

diff --git a/doc/api/doxy-api.conf.in b/doc/api/doxy-api.conf.in
index d230a19e1f..deea7b747d 100644
--- a/doc/api/doxy-api.conf.in
+++ b/doc/api/doxy-api.conf.in
@@ -111,7 +111,6 @@ GENERATE_DEPRECATEDLIST = YES
 VERBATIM_HEADERS        = NO
 ALPHABETICAL_INDEX      = NO
 
-HTML_TIMESTAMP          = NO
 HTML_DYNAMIC_SECTIONS   = YES
 HTML_EXTRA_STYLESHEET   = @TOPDIR@/doc/api/custom.css
 SEARCHENGINE            = YES
-- 
2.40.1



More information about the stable mailing list