On Tue, 6 Dec 2011 09:49:27 -0500 Michael Blumenkrantz <[email protected]> said:
> 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. i don't remember there being a second vote. either way. the decision was made. we canm't keep changing where we put docs every few months because of a poll. > 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 > -- ------------- Codito, ergo sum - "I code, therefore I am" -------------- The Rasterman (Carsten Haitzler) [email protected] ------------------------------------------------------------------------------ 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
