Re: [eigen] External contributions

[Benoit Jacob <jacob.benoit.1@xxxxxxxxx>]

2009/2/4 Gael Guennebaud <gael.guennebaud@xxxxxxxxx>:
> Hi,
>
> I mostly agree with you,
>
> about the doc, I'm not sure that's doable to easily change the visual
> hint of selected set for files, and I don't feel comfortable with
> mixing unsupported classes with the other one in the class list, etc.
> So I would propose to have two doxyfiles and nest the doc like this:
>
> build/doc/html/
>             /unsuported/html/
>
> and of course the main page would link to the contrib doc, and I think
> using ctags we can have cross references from the contrib doc to the
> main one. What do you think ?

Good idea!

>
> another related (and complementary) option is to put all the
> unsupported stuff  in an Eigen::unsupported namespace. I don't
> remember all the doxygen features but if that's doable to have the
> contrib classes prefixed with the unsupported:: namespace prefix, then
> that will be fine for me ! (I mean no need to have a separated doc)

Well I prefer the first option you mention above. Even with a
unsupported:: prefix these classes would still clutter the doc (and
then we would be reluctant to allow more stuff in unsupported/ which
would defeat its purpose).

> About the criteria, I would put the barrier as low as possible, but it:
>  - must rely on Eigen !
>  - must be math !
>  - should have some general purpose in the sense that it could
> potentially be included in a Eigen module (or become a new one)
>  - can be very preliminary though

100% agree.

> Another way to add contributions is via the demo/example. For instance
> if something is very too specific but shows an interesting way of
> using Eigen, then it can be a good demo.

I agree also.

Cheers,
Benoit