Doxygen and typedefs inside namespaces

Question

Can someone tell me what is wrong with this code, so doxygen can't handle it?

/*! \file Enumerator.h \brief Implements an Enumerator pointer for accessing linked list elements. */ #pragma once #ifndef __MSCL_ENUMERATOR_H__ #define __MSCL_ENUMERATOR_H__ namespace MSCL { /*! \typedef Enumerator Pointer to linked list data structure. \sa ArrayList::GetEnumerator, \sa List::GetEnumerator */ typedef void* Enumerator; }; #endif 

I need an Enumerator that is used by many methods as an argument type for

1) Visible in the help index.

2) Correctly linked to this documentation page.

The format of the target documentation is chm.

This is absolutely confusing because there is no mistake, no warning, nothing.

Once, after playing with various doxygen configuration settings, I managed to reach # 1 - the type was in the index, but I have no idea which switch did this, and I could not repeat it.

Answer 1

If I add a doxygen comment to describe the MSCL namespace, then the documentation for MSCL :: Enumerator will be generated properly.