On Mon, 6 Jun 2011 17:49:52 -0300 Gustavo Sverzut Barbieri <barbi...@profusion.mobi> wrote:
> Hi all, > > ProFUSION is proud to be back to work on EFL, thanks Samsung ;-) > > Our current work is to improve documentation of core EFL so we can > match competitors like Android and iPhone, it should not just improve > parts of API, but lots of examples, diagrams and things that lead > third party application developers to use our libraries properly. > > Rasterman requested us to cover few goals: > - examples should be external files that can be compiled and > checked, avoiding bogus examples ;-) > - all doc should be in doxygen > - example files should be installable > - all examples/docs in the package itself (see below for some shortcomings) > - big picture should be provided to introduce users to concepts and > ways of doing things, with diagrams and screenshots whenever possible. > Screenshots should be auto-generated to match theme changes with ease. > > Shortcomings: EFL is well split into independent modules, Evas does > not depend on Ecore, for instance. But to make actual useful examples, > we rather focus on the important bits and instead of creating our own > implementation to keep modules independent, we'll depend on these > external libraries FOR THE EXAMPLES. > That means that if you --enable-build-examples it will pull in > ecore-evas so we have ecore_evas_new() and ecore_main_loop_begin(). > This will require examples to have 2 phase builds. > An alternative we could do is to create a new "sub project" inside > examples/, with it's own "autogen.sh", "configure.ac" and > "Makefile.am" that can even be installed into > /usr/share/$PACKAGE/examples/. We can link the main project to have > "make examples" to enter examples and run the build on it. I like > this idea more, but let's see what others think. > > We're currently starting with Eina, Eet, Evas and Elementary. Please > try to avoid endless commits changing whitespaces, okay? (/me looks at > Seoz and Hermet). > there are some examples already in ecore/examples, you may want to copy those out as well (please don't delete from ecore/ yet, they expose a blocker bug for ecore 1.1) -- Mike Blumenkrantz Zentific: NULL pointer dereferences now 50% off! ------------------------------------------------------------------------------ EditLive Enterprise is the world's most technically advanced content authoring tool. Experience the power of Track Changes, Inline Image Editing and ensure content is compliant with Accessibility Checking. http://p.sf.net/sfu/ephox-dev2dev _______________________________________________ enlightenment-devel mailing list enlightenment-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/enlightenment-devel