We all clearly agree on making prototype and implementation match variable names, good. Now concerning the variable name ; I don't mind if they are long, I like them to be self uderstanding so I'll second matt on that, but please try to avoid capitals for functions parameters, except for single char variable names. If you have/want to use some capitals, please don't use them on the first char for parameters because it will interfere with type names.
Fabien > > 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
