Duncan wrote:
> > -WARN_IF_UNDOCUMENTED   = YES
> > +WARN_IF_UNDOCUMENTED   = NO
>
>
> Aha! I didn't notice that change in the middle of all of the others.
>
I switched the undoc off because I believe all important files to document are 
done. Also, we should now focus more on other warnings and on the overall 
structure of the documentation.

In particular,
I'd like to get your opinion on the high number of html source files generated 
by doxygen as for now.

I think it is time to think about how to release a maintainable doxygen doc but 
IMHO, we have far too many html files to add to svn for now.
One solution to reduce/limit that amount of files would be to remove the c++ 
header source files generated, I'll vote +1 for that.

Also, I'm not satisfied with the prefixes generated for HTML files related to 
classes, functions, enums and other aspects.
They are too long and I prefer the fltk2 documentation HTML files naming.
This said, it seems to me that the naming of HTML files changed in the 'new' 
doxygen releases, older doxygen tools were not adding these ugly prefixes AFAIR.

I believe we can't afford to let to the user the task of generating  the 
documentation, as he may not have doxygen, but I may be wrong.
But in the case we should not worry about this, we could neglect the important 
amount of generated files.

Comments are welcome :-)

Fabien

_______________________________________________
fltk-dev mailing list
[email protected]
http://lists.easysw.com/mailman/listinfo/fltk-dev

Reply via email to