On 21 Jul 2014, at 19:14 , MK <m...@cognitivedissonance.ca> wrote:

> On Mon, 21 Jul 2014 14:46:06 +0000
> "Ferro, Alasdair" <alasdair_fe...@mentor.com> wrote:
> 
>> Make sure your "std::" prefixes match - Doxygen is far less forgiving
>> that the C++ compiler on this!
> 
> If that's the issue, it's not a matter of "being less forgiving",
> it's a matter of being wrong, I think, since the .cpp files use
> namespace std whereas the .hpp ones don't.   All of the other methods
> are the same in this regard and they come out okay.

No, it is a matter of giving doxygen incomplete input. Unlike the
compiler which reads the <vector> include file and stops with an error if
it cannot find it, doxygen doesn't parse this file (unless you make it part 
of the INPUT) and as a result it doesn't know about the existence of a
namespace 'std' with a class 'vector' in it. So it cannot assume the
arguments match if there are multiple candidate definitions to choose from.

Since std::vector is such a common use-case, I've added the option
BUILTIN_STL_SUPPORT, which you can enable to make the most common STL
classes known to doxygen.

> 
> BUT: Adding the full namespace to the params in the .cpp works to get
> the documentation out.    I'm okay with that, even if it does look a
> little inconsistent.   Life is not perfect ;)

I hope it is a little more perfect with the info above ;-)

Regards,
  Dimitri

------------------------------------------------------------------------------
Want fast and easy access to all the code in your enterprise? Index and
search up to 200,000 lines of code with a free copy of Black Duck
Code Sight - the same software that powers the world's largest code
search on Ohloh, the Black Duck Open Hub! Try it now.
http://p.sf.net/sfu/bds
_______________________________________________
Doxygen-users mailing list
Doxygen-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-users

Reply via email to