Doxygen doesn’t recognize the @type docblock tag. That’s a problem, since at GravityView, we try to replicate WordPress core’s usage of the @type docblock tags to define nested values in associative arrays.
The fix? Add an ALIAS in Doxygen where @type is treated as @param. Here’s how:
type=@param
Now, Doxygen will recognize your @type tags as it does @alias tags.
Where to find this setting in the Doxygen app
I use the Doxygen app rather than the command-line interface. Here’s where to find the setting:
- In the Topics sidebar, select Project
- Scroll down to
ALIASES - Click the plus (+) icon to add a new alias
- Type
type=@param - Click the arrows-in-a-circle icon just to be sure it took
Here’s what all my aliases look like: