[PATCH v2] lib: remove empty return types from doxygen comments

Thomas Monjalon thomas at monjalon.net
Wed Oct 26 17:52:25 CEST 2022


25/10/2022 18:00, Stephen Hemminger:
> On Tue, 25 Oct 2022 16:32:38 +0300
> Ali Alnubani <alialnu at nvidia.com> wrote:
> 
> > Recent versions of doxygen (1.9.4 and newer) complain about
> > documented return types for functions that don't return anything.
> > 
> > This patch removes these return types to fix build errors similar
> > to this one:
> > [..]
> > Generating doc/api/doxygen with a custom command
> > FAILED: doc/api/html
> > /usr/bin/python3 /path/to/doc/api/generate_doxygen.py doc/api/html
> >   /usr/bin/doxygen doc/api/doxy-api.conf
> > /root/dpdk/lib/eal/include/rte_bitmap.h:324: error: found documented
> >   return type for rte_bitmap_prefetch0 that does not return anything
> >   (warning treated as error, aborting now)
> > [..]
> > 
> > Tested with doxygen versions: 1.8.13, 1.8.17, 1.9.1, and 1.9.4.
> > 
> > Signed-off-by: Ali Alnubani <alialnu at nvidia.com>
> 
> Acked-by: Stephen Hemminger <stephen at networkplumber.org>

Applied, thanks.




More information about the dev mailing list