How do I give example code for a class with Doxygen?
===

I'm trying to document a class embedded within a namespace, and I would like to give example usage. I have the examples written and included, and they show up in the examples tab. However, they are not referenced in the class itself. For instance, from the code on [this page](http://www.stack.nl/~dimitri/doxygen/commands.html#cmdexample), their Doxygen command is written as:

    /** \example example_test.cpp
     * This is an example of how to use the Test class.
     * More details about this example.
     */
It seems that Doxygen parses the command and the file and recognizes that the `Test` class is referenced. That doesn't seem to be happening for me. This feature isn't very well documented, and is almost impossible to Google for. 

This is the general layout of my code:

    namespace exampleSpace
    {
      ///Doxygen documentation
    
      class exampleClass {};

      ///@example example1.cpp
      ///  example1 description
      ///@example example2.cpp
      ///  example2 description
    }

The example descriptions name the class, as does the one in the official documentation. However, Doxygen seems to recognize theirs and not mine.

My example code is complete and compiles/runs correctly.

So where is the correct place to put these commands so Doxygen knows that they are examples for this specific class?