On Mon, 6 Jun 2011, Steven Le Roux wrote:
Hi,
at the last EFL meeting in france with #e.fr , yoz suggested few,
bloody simple example which could be run by simple copy/paste/compile
I think it's a good idea too because doxygen and API (documentation)
works great with devs, but it's maybe not sexy enough to convert a web
dev/sysadmin/whatever into a C developper...
in the eina doc, i added tutorials that could be copy/pasted. I even added
how to compile them, iirc
Vincent
On Mon, Jun 6, 2011 at 8:49 PM, 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).
--
Gustavo Sverzut Barbieri
http://profusion.mobi embedded systems
--------------------------------------
MSN: barbi...@gmail.com
Skype: gsbarbieri
Mobile: +55 (19) 9225-2202
------------------------------------------------------------------------------
Simplify data backup and recovery for your virtual environment with vRanger.
Installation's a snap, and flexible recovery options mean your data is safe,
secure and there when you need it. Discover what all the cheering's about.
Get your free trial download today.
http://p.sf.net/sfu/quest-dev2dev2
_______________________________________________
enlightenment-devel mailing list
enlightenment-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/enlightenment-devel
--
Steven Le Roux
Jabber-ID : ste...@jabber.fr
0x39494CCB <ste...@le-roux.info>
2FF7 226B 552E 4709 03F0 6281 72D7 A010 3949 4CCB
------------------------------------------------------------------------------
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
------------------------------------------------------------------------------
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
