Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

Is there an @inheritDoc equivalent in Doxygen?

I know Javadoc will compile {@inheritDoc}, but what's the Doxygen way to do this?

like image 627
Roberto Avatar asked Apr 04 '11 19:04

Roberto


2 Answers

With INHERIT_DOCS set to YES in your Doxygen configuration file (which is actually the default), just leave your overridden members completely uncommented and Doxygen will automatically insert the documentation from the base class.

@copydoc is useful for the case where you want to inherit base class comments, but then add some subclass-specific details.

like image 175
Conrad Poelman Avatar answered Oct 29 '22 15:10

Conrad Poelman


There's the explicit copydoc which I think is closest to an equivalent although with more flexibility it therefore requires you specify the original to copy so is a bit more awkward. It's designed to let you pull in documentation from anywhere so it needs a parameter specifying the source.

By default, the default is to inherit documentation from parent classes.

like image 45
Andy Dent Avatar answered Oct 29 '22 13:10

Andy Dent