Re: [Doxygen-users] doxygen message I don't understand

[Jakob v. B. <jak...@gm...>]

Hej,

AFAIU Doxygen uses its entirely own parser - my guess is that this parser simply doesn’t support decltype() yet - the way to fix this, is to create a patch for Doxygen, and send it, so it finds its way to the next official release. For the time being though, I’d guess you can use the PREDEFINED option to ‘trick’ Doxygen into recognizing this as some type, see http://www.stack.nl/~dimitri/doxygen/manual/preprocessing.html <http://www.stack.nl/~dimitri/doxygen/manual/preprocessing.html>

Something straightforward like “decltype(expr)=AutoType” should expand to ‘AutoType’, getting rid of the error message. For the sake of not getting any errors, declaring an empty ‘AutoType’ somewhere should then to the trick. Not ideal, but pragmatic. (and not the worst trick I have ever seen to help out Doxygen a bit)

Sincerely,
Jakob


> On 19 Apr 2018, at 16:19, D. R. Evans <doc...@gm...> wrote:
> 
> Fabian Cenedese wrote on 04/19/2018 12:19 AM:
>> 
>>> /home/n7dr/projects/drlog/src/drlog_context.cpp:1615: warning: documented
>>> symbol `decltype' was not declared or defined.
>>> ----
>>> /*! \brief      Get names and values of sent exchange fields for a particular mode
>>>   \param  m   target mode
>>>   \return     the names and values of all the fields in the sent exchange
>>> when the mode is <i>m</i>
>>> */
>>> const decltype(drlog_context::_sent_exchange)
>>> drlog_context::sent_exchange(const MODE m)
>>> ----
>>> I don't understand what doxygen is complaining about. It looks fine to me, and
>>> there is no problem compiling. So how do I get rid of the message from doxygen?
>> 
>> It's probably thinking that decltype is a function as the line
>> looks like a function declaration. If it is a macro then you
>> should give doxygen the macro definition or maybe enable
>> the macro expansion in the config file.
> 
> I am afraid that I don't understand what point you are trying to make. The
> line *is* a function declaration; the return type for the function is:
>  const decltype(drlog_context::_sent_exchange)
> which seems to be what doxygen is complaining about for some reason, even
> though it's a perfectly legitimate return type (and the compiler accepts it,
> as it should).
> 
> There are no macros involved at all.
> 
>  Doc
> 
> -- 
> Web:  http://enginehousebooks.com/drevans <http://enginehousebooks.com/drevans>
> 
> ------------------------------------------------------------------------------
> Check out the vibrant tech community on one of the world's most
> engaging tech sites, Slashdot.org! http://sdm.link/slashdot_______________________________________________
> Doxygen-users mailing list
> Dox...@li...
> https://lists.sourceforge.net/lists/listinfo/doxygen-users