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

Reply via email to