Alvin wrote: > Fabien Costantini wrote: > >> fltk.development >> Ok, If we agree that we put the the api comments in the sources cxx files > > I apologise for butting in here, but I'm not sure if this has been > addressed. If the doxygen comments are in the source files, then a user > who installed FLTK via RPMs (e.g. fltk-1.3.0-6190, fltk-devel-1.3.0-6190) > cannot refer to the installed header files for documentation? Presumably, > this doesn't matter I guess since in this case, the rpm would have most > likely installed the documentation files (eg. html -> > /usr/share/doc/fltk.) as well. > > If this was discussed before, what was the reason for putting the doxygen > comments in the cxx files? I'm just curious as I tend to put them in the > headers files and I'm wondering if I should switch too. > > Thanks, >
One more note on this before I shutup :). If the doxygen comments are in the header file, then KDevelop (maybe other IDEs as well?) will display the comment as part of the code completion list. Someone correct me if I am wrong, but I don't think this will happen if the comment is solely in the implementation file (cxx)? -- Alvin _______________________________________________ fltk-dev mailing list [email protected] http://lists.easysw.com/mailman/listinfo/fltk-dev
