Re: [Doxygen-users] Ignoring namespaces used for forward declarations

[Robert D. <rcd...@gm...>]

Thanks Dimitri.

I elected to go with EXCLUDE_SYMBOLS, however I'd like to see easier
ways to do this in the future, such as:

- An @exclude tag, which is effectively the same as @cond .. @endcond
but only for the single entity the documentation block applies to
- "Smart" parsing that determines if there is any "meaningful" content
in a namespace before parsing it out.

Great work!

On Tue, Apr 8, 2014 at 1:53 PM, Dimitri van Heesch <do...@gm...> wrote:
>
> On 08 Apr 2014, at 15:33 , Robert Dailey <rcd...@gm...> wrote:
>
>> In my code I have a couple of forward declarations of classes in other
>> distant, unrelated namespaces:
>>
>> namespace foo
>> {
>>    class bar;
>> }
>>
>> These get parsed out by Doxygen (v1.8.6) and appear empty in the HTML
>> output. Is there a way that Doxygen can be "smart" enough to ignore a
>> namespace if there isn't anything tangible inside of it? It would have
>> to know to ignore them if they are empty or only contain forward
>> declarations.
>
> You can:
> - not document the namespace and set EXTRACT_ALL to NO
> - use EXCLUDE_SYMBOLS = foo
> - surround the namespace with /// @cond ... /// @endcond
> - surround the namespace with #ifndef DOXYGEN_SKIP ... #endif and set PREDEFINED = DOXYGEN_SKIP
>
> Regards,
>   Dimitri