>> >> as for api docs i'd love to at least see every api func have a template >> "fill >> me in" doxygen doc comment. if we can - fill them in. > > I disagree here. Having no doc for a function make doxygen display a > warning in the terminal. Which means we *know* that there is a problem and > the doc must be fixed. Otherwise we would have to read all the doc to see > if we have filled correctly or not the doc. I prefer having an automated > way of warning me about that, instead of reading the whole doc. >
Agreed, nothing worse than undocumented stuff for someone learning how to use something. (*Shakes fists at SQL university unit with no Docs and only online videos*) And we can assume just about everyone will be learning this stuff once it goes final. ------------------------------------------------------------------------------ Beautiful is writing same markup. Internet Explorer 9 supports standards for HTML5, CSS3, SVG 1.1, ECMAScript5, and DOM L2 & L3. Spend less time writing and rewriting code and more time creating great experiences on the web. Be a part of the beta today. http://p.sf.net/sfu/beautyoftheweb _______________________________________________ enlightenment-devel mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/enlightenment-devel
