On Tue, 6 Dec 2011 18:49:22 +0900 Daniel Juyung Seo <[email protected]> wrote:
> Yeah I remember we concluded to put the docs in header file. > The vote was like 50/50. > > Daniel Juyung Seo (SeoZ) > On Dec 6, 2011 3:02 PM, "Carsten Haitzler" <[email protected]> wrote: > > > On Tue, 6 Dec 2011 00:57:41 -0500 Michael Blumenkrantz > > <[email protected]> said: > > > > > On Tue, 6 Dec 2011 06:53:48 +0100 > > > Vincent Torri <[email protected]> wrote: > > > > > > > On Tue, Dec 6, 2011 at 6:51 AM, Michael Blumenkrantz < > > > > [email protected]> wrote: > > > > > > > > > On Tue, 6 Dec 2011 06:48:19 +0100 > > > > > Vincent Torri <[email protected]> wrote: > > > > > > > > > > > On Tue, Dec 6, 2011 at 6:39 AM, Michael Blumenkrantz < > > > > > > [email protected]> wrote: > > > > > > > > > > > > > On Tue, 6 Dec 2011 06:37:13 +0100 > > > > > > > Vincent Torri <[email protected]> wrote: > > > > > > > > > > > > > > > On Tue, Dec 6, 2011 at 4:32 AM, Enlightenment SVN < > > > > > > > > [email protected]> wrote: > > > > > > > > > > > > > > > > > Log: > > > > > > > > > > > > > > > > > > +EAPI Ecore_Con_Socks *ecore_con_socks4_remote_add(const > > char *ip, > > > > > int > > > > > > > > > port, const char *username); > > > > > > > > > +EAPI void > > ecore_con_socks4_lookup_set(Ecore_Con_Socks > > > > > > > *ecs, > > > > > > > > > Eina_Bool enable); > > > > > > > > > +EAPI Eina_Bool > > ecore_con_socks4_lookup_get(Ecore_Con_Socks > > > > > > > *ecs); > > > > > > > > > +EAPI Eina_Bool ecore_con_socks4_remote_exists(const > > char > > > > > *ip, > > > > > > > int > > > > > > > > > port, const char *username); > > > > > > > > > +EAPI void ecore_con_socks4_remote_del(const > > char *ip, > > > > > int > > > > > > > > > port, const char *username); > > > > > > > > > +EAPI void > > ecore_con_socks_bind_set(Ecore_Con_Socks > > > > > *ecs, > > > > > > > > > Eina_Bool is_bind); > > > > > > > > > +EAPI Eina_Bool > > ecore_con_socks_bind_get(Ecore_Con_Socks > > > > > *ecs); > > > > > > > > > +EAPI unsigned int > > ecore_con_socks_version_get(Ecore_Con_Socks > > > > > > > *ecs); > > > > > > > > > +EAPI void > > ecore_con_socks_remote_del(Ecore_Con_Socks > > > > > > > *ecs); > > > > > > > > > +EAPI void > > ecore_con_socks_apply_once(Ecore_Con_Socks > > > > > > > *ecs); > > > > > > > > > +EAPI void ecore_con_socks_apply_always > > > > > > > > > (Ecore_Con_Socks > > > > > > > *ecs); > > > > > > > > > > > > > > > > > > > > > > > > > if you don't add doc to those function with @since, we will > > forget > > > > > that > > > > > > > > they have been added. So add the doc now > > > > > > > > > > > > > > > > Vincent > > > > > > > they already have full docs > > > > > > > > > > > > > > > > > > > 1) the doc is not in the header file > > > > > and it won't be > > > > > > > > > > > > > why ? It has been decided to put doc in header files. > > > > > > > > Vincent > > > > > > > > > > > > > > 2) ecore_con_socks_version_get() has no doc > > > > > because it doesn't do anything currently > > > > > > > > > > > > Vincent > > > > > > > > actually you may recall a recent poll where people overwhelmingly voted > > to > > > keep them in the .c files. in related facts, there's still tons of docs > > in > > > the .c files. continuing on with related facts, I'm the maintainer of > > > ecore-con and it's much easier for me to keep developing it and > > maintaining > > > it by keeping the docs where I code. > > > > actually the opinion was split pretty much 50/50 - and so i cast my > > deciding > > vote to put them in the headers. for better or worse thats where we put > > them > > now because u can NEVER totally remove them from the headers - since that > > is > > the 1 location that at least SOME docs must be, put them all there. > > > > -- > > ------------- Codito, ergo sum - "I code, therefore I am" -------------- > > The Rasterman (Carsten Haitzler) [email protected] > > > > > > It's funny how time changes things. In April, people were overwhelmingly for the "all docs in one header" option. By August, when the most recent poll was done, it was completely the opposite. There was one (1) vote to put docs in a single header file. Regardless, even if we vote again and people decide to flip flop and go with putting docs into headers this time, I'm not moving anything until I finish working on it. As I said, this makes my "job" considerably easier since I have the code to directly reference. Anyone who disagrees can, frankly, finish this entire api and functionality themselves. ------------------------------------------------------------------------------ Cloud Services Checklist: Pricing and Packaging Optimization This white paper is intended to serve as a reference, checklist and point of discussion for anyone considering optimizing the pricing and packaging model of a cloud services business. Read Now! http://www.accelacomm.com/jaw/sfnl/114/51491232/ _______________________________________________ enlightenment-devel mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/enlightenment-devel
