Duncan Gibson wrote:
>>> SORT_BRIEF_DOCS = NO
>
>> Looks like this is what we want to set to YES. I did a short test,
>> and IMHO it looks good. Any reasons not to do this?
>
> I can only assume that this was originally left as NO because all of
> the doxygen comments were going to go into the header files, and it
> made sense to keep groups of declarations together. Once we decided
> to put the doxygen comments with the implementation, doxygen no longer
> maintains these implicit groups together and it makes sense to change.
>
> +1 from me (and I think that is my first vote as a "developer" :-)
+1 from me.. I think it's hard to find things out of order.
I was wondering about alphabetic sorting myself, and figured
it was off because commands could be grouped together.
If we do this, we should probably put careful attention to
providing \see to link like-kind methods together.
eg. in Fl_Browser, insert/add/delete/clear should all refer
to each other, as should topline()/middleline()/bottomline(),
and show()/hide(), first()/next()/prev()/last(), etc.
Or maybe there's a better way to group these.. not sure.
_______________________________________________
fltk mailing list
[email protected]
http://lists.easysw.com/mailman/listinfo/fltk
