On Thu, Jan 12, 2012 at 1:25 AM, Michael Blumenkrantz <[email protected]> wrote: > On Wed, 11 Jan 2012 19:21:52 -0800 > "Enlightenment SVN" <[email protected]> wrote: > >> Log: >> fix docs for first half of eina_value: the second half caused me to start >> drinking heavily >> >> Author: discomfitor >> Date: 2012-01-11 19:21:52 -0800 (Wed, 11 Jan 2012) >> New Revision: 67112 >> Trac: http://trac.enlightenment.org/e/changeset/67112 >> >> Modified: >> trunk/eina/src/include/eina_value.h >>
First, thank you for taking the time to review and fix the docs! Most were generated with copy & paste, and I'm no native english speaker --- highly appreciate your help! > there's a lot of places where it says something like > > "The value is returned in the variable argument parameter, the actual value is > type-dependent, but usually it will be what is stored inside the object." > > this is confusing. am I to understand that eina_value_get() may decide to > return random values? Yes, the type may implement his own get() function, then he may agree on a different protocol. Of course it is recommended to stay within the rules :-) And the part "type-dependent" is because you should give it an "int*" for EINA_VALUE_TYPE_INT as it will write sizeof(int) to it. For EINA_VALUE_TYPE_CHAR, it will write sizeof(char), for EINA_VALUE_TYPE_ARRAY it will write sizeof(Eina_Value_Array)... clear now? -- Gustavo Sverzut Barbieri http://profusion.mobi embedded systems -------------------------------------- MSN: [email protected] Skype: gsbarbieri Mobile: +55 (19) 9225-2202 ------------------------------------------------------------------------------ RSA(R) Conference 2012 Mar 27 - Feb 2 Save $400 by Jan. 27 Register now! http://p.sf.net/sfu/rsa-sfdev2dev2 _______________________________________________ enlightenment-devel mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/enlightenment-devel
