Doxygen: False positives for "multiple @param sections"

[FFroehlich]

The 1.8.15 update of doxygen (https://github.com/doxygen/doxygen/commit/d39cdf826f15470def2ca36bc636868a62c42bbf specifically) has introduced a check for the identification of multiple @param sections, but this seems to be producing false positives when a @param and a @retval instructions both use the same variable name:

double fun(double a, double b) {
 }
 /** @file "fun.cpp"
   * @brief  function.
   */
 /** @fn double fun(double a, double b)
   * @brief  brief.
   *
   *
   * @param a   bar
   * @param b   foo
   *
   * @retval a      foobar
   */

will produce the following error message:
.../fun.cpp:1: warning: argument 'a' from the argument list of fun has muliple @param documentation sections

[albert-github]

I've just pushed a proposed patch, pull request #6757

@doxygen
Maybe the entire call to checkArgumentName has to be omitted for @retval or the @retval values should be placed in a separate dictionary to overcome the fact that a @retval is documented twice.

[albert-github]

Code has been integrated in master on github.

[doxygen]

This issue was previously marked 'fixed but not released',
which means it should be fixed in doxygen version 1.8.16.
Please verify if this is indeed the case. Reopen the
issue if you think it is not fixed and please include any additional information
that you think can be relevant (preferably in the form of a self-contained example).

[igordesto]

I'm facing the same problem in version 1.8.17

/**-----------------------------------------------------------------------------
* \ingroup      MeasureStateMachine
* \brief        Measure state machine error handler
* \param[in]    eException Exception to be handled
* \param[in]    psMsrSttstc Pointer to the statistic structure
* \return       teException Updated exception.
*/
teException eMsrSttMchnErrHndlr(teException eException, tsMsrSttstc *psMsrSttstc)

will produce the following error message

warning: argument 'eException' from the argument list of eMsrSttMchnErrHndlr has multiple @param documentation sections

I performed tests changing the name of the variables and the result persists.

I appreciate any help.

[albert-github]

Based on the given example I'm not able to reproduce it.

Most likely cause is that you have documented eMsrSttMchnErrHndlr but that the documentation is different at the both places.

• Can you please attach a, small, self contained example (source+configuration file in a tar or zip) that allows us to reproduce the problem? Please don't add external links as they might not be persistent.

[igordesto]

albert-github, thanks for your comment. I was preparing the example you suggested and thinking about your comment about the routine eMsrSttMchnErrHndlrbeing documented in two places differently, I checked and found that there was a backup file of my source code that was visible by the doxygen project but was not visible by my compiler, and I ended up messing with it.

Conclusion, the cause of my problem was the same routine documented twice differently.

Thanks.