>sure. Look at Evas and its doxy stubs. Evas has existed for something like 
>10 years. Did someone fix them ? No. Did they leave the user clueless ? 
>Yes.


Okay, now look at ecore con and its full doxy that I was able to write because
the stubs were the ONLY thing that gave me clues about how some of the
functions worked.
The fact is that our doxy is not going to get better any time soon because
either most people aren't building all their packages with doxygen enabled (or
reading the messages from it if they do) or they have the same view that you
seem to: we haven't released, we don't need to document.
As I said in my big documentation email before, the only way stuff like evas
doxy stubs will be fixed is if we start spending a little time each day
filling in the blanks.  Picking a random page on docs.enlightenment.org every
week and fixing it up as I do would be a huge help.

-- 
Mike Blumenkrantz
Zentific: Our boolean values are huge.

------------------------------------------------------------------------------
The Palm PDK Hot Apps Program offers developers who use the
Plug-In Development Kit to bring their C/C++ apps to Palm for a share
of $1 Million in cash or HP Products. Visit us here for more details:
http://p.sf.net/sfu/dev2dev-palm
_______________________________________________
enlightenment-devel mailing list
enlightenment-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/enlightenment-devel

Reply via email to