[Doxygen-users] Documenting IDL

[Dale O. <Dal...@tr...>]

Hi,

Does anyone know how to get an identifier to be an alias for another
identifier in doxygen? Basically, I want two identifiers "IRecord" and
"IRecordPtr" both to index the same documented COM interface.

We are using doxygen to document our Microsoft IDL. This produces wonderful
documentation for our COM interfaces, and we have integrated the resulting
compiled HTML into our MS Visual studio help so that when we press F1 on one
of our interface definitions we see the docs for our interface!

All good, but we also use microsoft smart pointer wrappers for our
interfaces. These wrapper classes can be treated exactly like the interfaces
they wrap, and they have a number of advantages which mean that we tend to
use them almost exclusively. Instead of writing raw code like:

IRecord* pRecord = NULL;
...
pRecord->Doit();

We tend to use the smart pointer wrappers and write:

IRecordPtr pRecord;
...
pRecord->Doit();

Now to our problem. If we press F1 on IRecordPtr we want the help to jump to
the IRecord topic!

Does anyone know how to get doxygen to treat IRecordPtr as an alias for
IRecord???

thanks

Dale