On 9/23/15 1:38 AM, sai mrithyunjaya wrote:
>
> Hi,
>
> We are facing an issue with the below code i.e doxygen warning.
>
> /**
>
> * Check combo box selections by user.
>
> * *@param* cmb javafx.scene.control.ComboBox
>
> * *@param* failMsg Error message
>
> * *@param* <T> This is the type parameter
>
> * *@return* Returns True javafx.scene.control.ComboBox is Valid
> one otherwise False
>
> */
>
> *private* *static*<T> Boolean checkComboSelection(*final* ComboBox<T>
> cmb, *final* String failMsg) {
>
> }
>
> 1) In the line * *@param* <T> This is the type parameter a doxygen
> warning is thrown “*warning: argument 'T' of command @param is not
> found in the argument list of com.abc.xyz::checkComboSelection(final
> **ComboBox**< T > **cmb**, final String **failMsg**)”*
>
> 2) But when we replace <T> with *checkComboSelection *then we are
> getting a *checkStyle* warning* “Unused @param tag for
> 'checkComboSelection'.”*
>
> * *@**param* *checkComboSelection***This is the type parameter
>
> **In case "1" it is a doxygen warning and
> In case "2" it is a check style warning.
>
> Is there another way to write doxygen comment for that parameter?
>
> Could anyone please help us fix this issue.
>
>
> Thank you
> Sai
>
The issue is that <T> is not a parameter of the function, so @param is
complaining. I think you want @tparam instead.
--
Richard Damon
------------------------------------------------------------------------------
Monitor Your Dynamic Infrastructure at Any Scale With Datadog!
Get real-time metrics from all of your servers, apps and tools
in one place.
SourceForge users - Click here to start your Free Trial of Datadog now!
http://pubads.g.doubleclick.net/gampad/clk?id=241902991&iu=/4140
_______________________________________________
Doxygen-users mailing list
Doxygen-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-users
