doxygen not listing functions in nested namespaces

Question

I'm documenting my code and can't make doxygen to pick up functions inside nested namespaces. Googling around i didn't see anyone facing this problem, sorry if a duplicate.

namespace n1 {
 /*! @addtogroup n1
 *@{
  */

 /**
  * n2 is...
  */
 namespace n2 {

    /**
     *  n3 is...
     */
    namespace n3 {

        /**
         * function does...
         */
         static inline
         int  
         find() { }
    }
}
 /*@}*/
}

In the resulting documentation (html) I see all namespaces (n1, n2, n3) but don't see any functions (e.g. find() ). The page corresponding to n3 namespace contains none.

I also tried EXTRACT_ALL build flag, does not seem to help.

p/s/ doxygen is generated using Doxygen GUI for OS-X.

According to the Doxyfile and the manual: If the EXTRACT_ALL tag is set to YES doxygen will assume all entities in documentation are documented, even if no documentation was available. Private class members and static file members will be hidden unless the EXTRACT_PRIVATE and EXTRACT_STATIC tags are set to YES — albert
– albert, Commented May 9, 2013 at 17:44
@albert as you see in the example above, these are not private. No idea why it does not document those — Denis
– Denis, Commented May 14, 2013 at 8:53
I just copied part of the manual here and maybe the word "and" between EXTRACT_PRIVATE and EXTRACT_STATIC is a bit confusing here, the word respectively might be better. — albert
– albert, Commented May 15, 2013 at 16:37

Timmie Smith · Accepted Answer · 2013-05-15 02:19:11Z

4

You need to set EXTRACT_STATIC = YES in your Doxyfile.

The comment on EXTRACT_ALL states, "Private class members and static file members will be hidden unless the EXTRACT_PRIVATE and EXTRACT_STATIC tags are set to YES"

I've tested with your example and setting EXTRACT_STATIC = YES and the find function is visible in the resulting documentation.

answered May 15, 2013 at 2:19

Timmie Smith

4432 silver badges10 bronze badges

Sign up to request clarification or add additional context in comments.

Collectives™ on Stack Overflow

doxygen not listing functions in nested namespaces

1 Answer 1

Comments

Your Answer

Hot Network Questions

Collectives™ on Stack Overflow

1 Answer 1

Comments

Your Answer

Sign up or log in

Post as a guest

Related