Albrecht Schlosser wrote:
>> So to solve this, I can either:
>>
>> 1) add variable names to the .H prototypes so they appear in the index
>>
>> - or -
>>
>> 2) Change the docs so the first line (or \brief) doesn't mention
>> variable names..
>
> I vote #1: Having argument names in the .H files makes reading and
> understanding them easier, it's not only the "Doxygen effect". So
> we can get both.
>
> And IIRC that's also a point that we decided to do when we started
> with doxygen: add names to prototypes (and use the same names as
> in the implementation).
OK, since that's the decided goal, I'll go forward with #1
just with Fl_Browser to see how that goes.
Will try to restrict myself to changing only the .H files,
as a I really don't want to change code in a doc pass.
So if 'l' appears as a varname in .cxx, I'll leave it as is..
but if it's just in .H where it's easy to fix, I'll change it.
_______________________________________________
fltk-dev mailing list
[email protected]
http://lists.easysw.com/mailman/listinfo/fltk-dev
