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" <ras...@rasterman.com> wrote: > On Tue, 6 Dec 2011 00:57:41 -0500 Michael Blumenkrantz > <michael.blumenkra...@gmail.com> said: > > > On Tue, 6 Dec 2011 06:53:48 +0100 > > Vincent Torri <vincent.to...@gmail.com> wrote: > > > > > On Tue, Dec 6, 2011 at 6:51 AM, Michael Blumenkrantz < > > > michael.blumenkra...@gmail.com> wrote: > > > > > > > On Tue, 6 Dec 2011 06:48:19 +0100 > > > > Vincent Torri <vincent.to...@gmail.com> wrote: > > > > > > > > > On Tue, Dec 6, 2011 at 6:39 AM, Michael Blumenkrantz < > > > > > michael.blumenkra...@gmail.com> wrote: > > > > > > > > > > > On Tue, 6 Dec 2011 06:37:13 +0100 > > > > > > Vincent Torri <vincent.to...@gmail.com> wrote: > > > > > > > > > > > > > On Tue, Dec 6, 2011 at 4:32 AM, Enlightenment SVN < > > > > > > > no-re...@enlightenment.org> 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) ras...@rasterman.com > > > > ------------------------------------------------------------------------------ > 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 > enlightenment-devel@lists.sourceforge.net > https://lists.sourceforge.net/lists/listinfo/enlightenment-devel > ------------------------------------------------------------------------------ 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 enlightenment-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/enlightenment-devel
