On Sat, 13 Nov 2010 15:19:33 +0900 Daniel Juyung Seo <seojuyu...@gmail.com>
said:

it actually should all be int he doxygen section - there are still comments in
the .h - but they dont go into doxygen. they are superflous at the moment.

as for where doxygen docs should live... that has also been debated here with
what i see as a stalemate. bout half want them in .c files, half want them
in .h files. and as any "change" to standardize on one or the other requires
someone to go and copy them all around from one place to another (depending on
lib/doc etc.) it' hasn't been done.

i'm on the side of "should be in .h" because as such - struct and enum docs
HAVE to be in the .h anyway - so some docs are in .c;s, some in .h's just due
to the way doxygen works. all of eet's docs are in the .h - some of eina's docs
are in .h, some in .c - etc. etc.

> Hello all,
> 
> I found that each elementary widget has different places to put its
> smart callback doxygen.
> - only Elementary.h.in
> - only elm_{widget}.c source code.
> - both Elementary.h.in and elm_{widget}.c source code.
> 
> I guess there must be a discussion about this.
> Any idea?
> 
> Thanks.
> Daniel Juyung Seo.
> 
> ------------------------------------------------------------------------------
> Centralized Desktop Delivery: Dell and VMware Reference Architecture
> Simplifying enterprise desktop deployment and management using
> Dell EqualLogic storage and VMware View: A highly scalable, end-to-end
> client virtualization framework. Read more!
> http://p.sf.net/sfu/dell-eql-dev2dev
> _______________________________________________
> 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


------------------------------------------------------------------------------
Centralized Desktop Delivery: Dell and VMware Reference Architecture
Simplifying enterprise desktop deployment and management using
Dell EqualLogic storage and VMware View: A highly scalable, end-to-end
client virtualization framework. Read more!
http://p.sf.net/sfu/dell-eql-dev2dev
_______________________________________________
enlightenment-devel mailing list
enlightenment-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/enlightenment-devel

Reply via email to