Ok, I'm going to make a proposal with one widget which is very easy. Put documents to 1 header. (Elementary.h)
Thanks. Daniel Juyung Seo (SeoZ) On Fri, Apr 29, 2011 at 2:51 PM, Carsten Haitzler <ras...@rasterman.com>wrote: > On Wed, 27 Apr 2011 22:24:48 +0900 Daniel Juyung Seo <seojuyu...@gmail.com > > > said: > > i'm in the "1 header to rule them all and in the darkness bind them" > camp... > but also in the "throw those docs in the header" camp and frankly.. we > already > have some there due to structs and enums being documented. :) > > > Any further discussion on this topic? > > I'm raising this topic again because I think it's time to refactor > > elementary doxygen. > > We agreed to move all doxygen to headers from c code. > > But there are duplicated dox in header and c in elementary. It's a mess. > > > > As we discussed so far there are a couple of options. > > 1. Separate headers by widget: list, genlist, gengrid, actionslider, > > ctxpopup, ... > > 2. Separate headers by widget groups: simple, list, map, ... > > 3. Leave one big header as is: Elementary.h > > > > How do you guys think? > > > > Daniel Juyung Seo (SeoZ) > > > > On Wed, Apr 13, 2011 at 8:45 AM, Carsten Haitzler <ras...@rasterman.com > >wrote: > > > > > On Tue, 12 Apr 2011 23:13:58 +0900 Daniel Juyung Seo < > seojuyu...@gmail.com > > > > > > > said: > > > > > > i say... leave it :) > > > > > > > Any further discussion on this issue? > > > > If there is no request and agreement, I'll drop this change. > > > > > > > > Thanks. > > > > Daniel Juyung Seo (SeoZ) > > > > > > > > On Mon, Apr 11, 2011 at 2:20 AM, Atton Jonathan > > > > <jonathan.at...@gmail.com>wrote: > > > > > > > > > Maybe we can split headers by type of widget: simple, list(genlist, > > > list, > > > > > gengrid), map (it is a big header) ... > > > > > > > > > > 2011/4/9 Daniel Juyung Seo <seojuyu...@gmail.com> > > > > > > > > > >> Hello all, > > > > >> I wanna raise a discussion of elementary header separation like > eina. > > > > >> > > > > >> Raster is moving dox into headers. > > > > >> I agree with him to put dox into headers because developers can > refer > > > > >> headers directly. > > > > >> (they could refer doxygen html as well.) > > > > >> > > > > >> But Elementary.h.in is already full and it will be mess if all > dox > > > come > > > > >> in. > > > > >> I suggest to separate elementary headers widget by widget. > > > > >> Just like eina. > > > > >> > > > > >> $PREFIX/include/eina-1/Eina.h > > > > >> $PREFIX/include/eina-1/eina/eina_list.h > > > > >> ... > > > > >> > > > > >> I have a prototype and it's working well. I'm ready to commit > that. > > > > >> This is a big change so I want to raise a discussion. > > > > >> > > > > >> Any ideas? > > > > >> > > > > >> Thanks. > > > > >> Daniel Juyung Seo (SeoZ) > > > > >> > > > > >> > > > > ------------------------------------------------------------------------------ > > > > >> Xperia(TM) PLAY > > > > >> It's a major breakthrough. An authentic gaming > > > > >> smartphone on the nation's most reliable network. > > > > >> And it wants your games. > > > > >> http://p.sf.net/sfu/verizon-sfdev > > > > >> _______________________________________________ > > > > >> enlightenment-devel mailing list > > > > >> enlightenment-devel@lists.sourceforge.net > > > > >> https://lists.sourceforge.net/lists/listinfo/enlightenment-devel > > > > >> > > > > > > > > > > > > > > > > > > > > -- > > > > > Regards. > > > > > > > > > > > > > ------------------------------------------------------------------------------ > > > > Forrester Wave Report - Recovery time is now measured in hours and > > > minutes > > > > not days. Key insights are discussed in the 2010 Forrester Wave > Report as > > > > part of an in-depth evaluation of disaster recovery service > providers. > > > > Forrester found the best-in-class provider in terms of services and > > > vision. > > > > Read this report now! http://p.sf.net/sfu/ibm-webcastpromo > > > > _______________________________________________ > > > > enlightenment-devel mailing list > > > > enlightenment-devel@lists.sourceforge.net > > > > https://lists.sourceforge.net/lists/listinfo/enlightenment-devel > > > > > > > > > > > > > -- > > > ------------- Codito, ergo sum - "I code, therefore I am" > -------------- > > > The Rasterman (Carsten Haitzler) ras...@rasterman.com > > > > > > > > > -- > ------------- Codito, ergo sum - "I code, therefore I am" -------------- > The Rasterman (Carsten Haitzler) ras...@rasterman.com > > ------------------------------------------------------------------------------ WhatsUp Gold - Download Free Network Management Software The most intuitive, comprehensive, and cost-effective network management toolset available today. Delivers lowest initial acquisition cost and overall TCO of any competing solution. http://p.sf.net/sfu/whatsupgold-sd _______________________________________________ enlightenment-devel mailing list enlightenment-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/enlightenment-devel
