[Doxygen-users] Internal doco still output when INTERNAL_DOCS is set to NO

[Yann, T. <TRE...@ca...>]

I have a source file that contains definitions that I would like to suppress
when generating user doco. It appears that I can mark the declarations with
\internal, and then use INTERNAL_DOCS to control the output.

I always see documentation entries, regardless of the setting of
INTERNAL_DOCS. I expected that with INTERNAL_DOCS set to YES, that I would
see the documentation, along with "For internal use only". With
INTERNAL_DOCS set to NO, I don't expect the item to be listed at all.

TIA,

Trevor


Example source code
-------------------

/** Number of PEM types that represent keys
 *  @internal
 */
#define NUM_KEY_TYPES   8

Output with INTERNAL_DOCS set to NO
-----------------------------------

#define NUM_KEY_TYPES  
 
   Number of PEM types that represent keys 

For internal use only. 
 
Output with INTERNAL_DOCS set to YES
------------------------------------
#define NUM_CERT_TYPES  
 
   Number of PEM types that represent certificates