Re: [Doxygen-users] Warning of mismatched arguments

[<mic...@th...>]

Could it be that the @param shows type "SlipDatum&" while the @fn shows type of that arg as "const SlipDatum&", so the type doesn't match up?   Just guessing, but...

From: Arthur Schwarz [mailto:asc...@at...]
Sent: Sunday, September 22, 2013 2:05 PM
To: dox...@li...
Subject: [Doxygen-users] Warning of mismatched arguments

I can't figure out what is wrong with the following:

 /**
 * @fn virtual SlipDatum& SlipOp::copy(const SlipDatum& X) const
 * @copydoc SlipDatum::copy()
 * @see SlipDatum::copy()
 * @param[in] X (SlipDatum&) cell to be copied
 */

and

      virtual SlipDatum& copy(const SlipDatum& X) const;

The code compiles and executes, so the code is ok. The message is:

SlipOp.h:707: warning: argument 'SlipDatum' of command @param is not found in the argument list of SlipOp::copy(const SlipDatum &X) const

The error cascades to all functions which override the virtual function. The @copydoc object has no argument and a @param statement is supplied here to account for the added argument. However most of the methods in this class have the same issue, the @copydoc object has one fewer argument than the implementation in this class, but there is no diagnostic message issued.

Have I done something wrong?

This email was sent to you by Thomson Reuters, the global news and information company. Any views expressed in this message are those of the individual sender, except where the sender specifically states them to be the views of Thomson Reuters.