On Wed, May 31, 2023 at 6:17 PM <jer...@marvell.com> wrote: > > From: Jerin Jacob <jer...@marvell.com> > > Since doxygen 1.9.7 version, HTML_TIMESTAMP configuration option > changed to TIMESTAMP [2]. Fixed the following warning[1] by providing > the correct configuration option based on doxygen version.
loongarch-compilation reported a build issue at http://mails.dpdk.org/archives/test-report/2023-May/402940.html https://mesonbuild.com/Reference-manual_returned_external_program.html#external_programversion introduced in 0.62 version, so not sure how we can do version check without that. Another option is to just remove HTIML_TIMESTAMP from config file. Since 1.8.9 doxgen version, it is disabled by default. Thoughts? commit 3f2e8a3067712b025623e4420e6eb161febfd42b Author: Dimitri van Heesch <dimi...@stack.nl> Date: Thu Mar 5 21:54:12 2015 +0100 Bug 745439 - PATCH: please consider making doxygen output byte for byte identical between individual runs by default diff --git a/src/config.xml b/src/config.xml index 747686031..3d81a21a2 100644 --- a/src/config.xml +++ b/src/config.xml @@ -1889,13 +1889,13 @@ hr.footer { ]]> </docs> </option> - <option type='bool' id='HTML_TIMESTAMP' defval='1' depends='GENERATE_HTML'> + <option type='bool' id='HTML_TIMESTAMP' defval='0' depends='GENERATE_HTML'> <docs> <![CDATA[ If the \c HTML_TIMESTAMP tag is set to \c YES then the footer of each generated HTML page will contain the date and time when the page - was generated. Setting this to \c NO can help when comparing the output of - multiple runs. + was generated. Setting this to \c YES can help to show when doxygen was last run + and thus if the documentation is up to date. ]]> </docs> </option> [(HEAD detached at Release_1_9_5)]dell[doxygen] $ git describe 3f2e8a3067712b025623e4420e6eb161febfd42b Release_1_8_9_1-64-g3f2e8a306 > > [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: sta...@dpdk.org > > Signed-off-by: Jerin Jacob <jer...@marvell.com> > --- > doc/api/doxy-api.conf.in | 2 +- > doc/api/meson.build | 6 ++++++ > 2 files changed, 7 insertions(+), 1 deletion(-) > > diff --git a/doc/api/doxy-api.conf.in b/doc/api/doxy-api.conf.in > index 7e68e43c64..f5da1f2291 100644 > --- a/doc/api/doxy-api.conf.in > +++ b/doc/api/doxy-api.conf.in > @@ -112,7 +112,7 @@ GENERATE_DEPRECATEDLIST = YES > VERBATIM_HEADERS = NO > ALPHABETICAL_INDEX = NO > > -HTML_TIMESTAMP = NO > +@TS_PREFIX@TIMESTAMP = NO > HTML_DYNAMIC_SECTIONS = YES > HTML_EXTRA_STYLESHEET = @TOPDIR@/doc/api/custom.css > SEARCHENGINE = YES > diff --git a/doc/api/meson.build b/doc/api/meson.build > index 2876a78a7e..7fc5b064cd 100644 > --- a/doc/api/meson.build > +++ b/doc/api/meson.build > @@ -41,6 +41,12 @@ if get_option('werror') > cdata.set('WARN_AS_ERROR', 'YES') > endif > > +if doxygen.version().version_compare('>=1.9.7') > + cdata.set('TS_PREFIX', '') > +else > + cdata.set('TS_PREFIX', 'HTML_') > +endif > + > doxy_conf = configure_file(input: 'doxy-api.conf.in', > output: 'doxy-api.conf', > configuration: cdata) > -- > 2.40.1 >
