A quick Doxygen fix for @type

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:

1. In the Topics sidebar, select Project
2. Scroll down to ALIASES
3. Click the plus (+) icon to add a new alias
4. Type type=@param
5. Click the arrows-in-a-circle icon just to be sure it took

Here’s what all my aliases look like:

The post A quick Doxygen fix for @type appeared first on Zack Katz's Blog.