Re: [eigen] Patch to AlignedBox

[ Thread Index | Date Index | More Archives ]

sorry for taking so long to respond.

On Mon, Oct 15, 2012 at 10:53 AM, Wood, Tobias <tobias.wood@xxxxxxxxx> wrote:
>>> 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.

strange, they should still appear in the doc.

> 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!

I think this is still better than the current situation!! So I'd go for it.


> 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?
> Thanks,
> Toby

Mail converted by MHonArc 2.6.19+