|Re: [eigen] Patch to AlignedBox|
[ Thread Index |
| More lists.tuxfamily.org/eigen Archives
>> Is there some way to mark the old names as deprecated, beyond a comment in the code and note in the documentation?
> in the doc use \deprecated, and in the code there is a
> EIGEN_DEPRECATED macro, but it won't work for individual enum name, so
> we can only mark it in the doc.
I'm having a couple of problems with Doxygen.
1. The \deprecated command seems to just remove the following paragraph, it doesn't show up in the generated docs.
2. Doxygen doesn't seem to have a good mechanism for documenting groups within an enum. If you look at the current docs on the website, only the first member of each group (1D, 2D and 3D) is actually listed with a description.. You can get Doxygen to document each member by using groups and setting DISTRIBUTE_GROUP_DOC = YES in the Doxyfile, but this just repeats the group description for every member, which looks terrible!
There doesn't seem to be any way to get Doxygen to list all the enum members with a single description line, which is what I was trying to get. Does anyone with more experience of Doxygen know how to do this?