On 07/11/14 01:15, Carsten Haitzler (The Rasterman) wrote: > On Thu, 6 Nov 2014 20:38:34 -0200 Felipe Magno de Almeida > <felipe.m.alme...@gmail.com> said: > >> On Thu, Nov 6, 2014 at 5:09 AM, Carsten Haitzler <ras...@rasterman.com> >> wrote: >>> i thought i'd start this here for a wide audience. >>> >>> documentation for efl. it's rather horrible. and yesterday it dawned on >>> me... >> Hello raster, >> >>> this is a start - what do people have to add/say? >>> >>> do you have something ... better? can you improve the above? >> I'm going to say what I think is plausible solution to the >> documentation problem we have today in EFL and Elementary. I don't >> think it is better, but I think it is doable and is going to help the >> project get users sooner rather than later. >> >> First of all, documentation was already problematic, but Eolian surely >> made it much worse. It made it worse because it made EFL more usable >> in contexts where it was not, but neither documentation nor tools >> accompanied this widening of the EFL's horizont. >> >> I think we can still leverage on the current tools to create at least >> good enough documentation, which we're still far away. If we can make >> people *wink* *wink* work on Eolian to allow documentation from >> multiple languages, by, e.g., tagging paragraphs per programming >> language, we can generate doxygen, jsdoc, for each language. > have you run "make doc" on efl lately? it takes longer than efl does to > compile. a full "from scratch" compile. (actually it segfaults on arch - i > can't > build docs at all .. after 30seconds). Doygen 1.8.8 problem. 1.8.7 is fine https://phab.enlightenment.org/T1669
regards Stefan Schmidt ------------------------------------------------------------------------------ _______________________________________________ enlightenment-devel mailing list enlightenment-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/enlightenment-devel
