efl/legacy/eina/src/lib
Gustavo Sverzut Barbieri b0ee5696a6 eina gets lots of gcc attributes to its api.
this should help with optimizations and code correctness, please see
"info gcc" for detailed explanation on these.

if you experience some functions not working as expected, please
double check if they're not marked with EINA_PURE or EINA_CONST, maybe
I misused them. Remove the macro and try again.

brief explanation:

 * EINA_WARN_UNUSED_RESULT: if you forgot to use the return of some
   function, it will emit a warning (and -Werror will make it an
   error). This way it will be harder to miss the attribution
   "l = eina_list_append(l, v)".

 * EINA_ARG_NONNULL(index, index...): if you give it an explicit NULL
   argument, or some tool (ie: clang) finds it could get a NULL but
   this is not accepted by API, then a warning will be emitted.  This
   will help those that still use eina_hash_add() as if it is
   evas_hash_add().

 * EINA_MALLOC: any non-NULL pointer it returns cannot alias any other
   pointer valid when function returns.

 * EINA_PURE: function have no effects other than the return and this
   return just depend on parameters and/or globals. You might call
   this function in a loop a thousand times and it will return the
   same value, thus you may move this function outside the loop and
   remove it.

 * EINA_CONST: stricter version of EINA_PURE, it will not check for
   global parameters, that is, you cannot consider pointer
   arguments. Use it for math things like "int sqrt(int)".

 * EINA_PRINTF(fmt, arg): will check format parameter specified in
   position "fmt" and passed arguments starting at position "arg", it
   will check for things like giving integers where short or strings
   were expected.

 * EINA_SCANF(fmt, arg): similar to eina_printf().

 * EINA_FORMAT(fmt): for use with things like dgettext(), it will get
   a printf-like format string and modifies it.

Please review and test it with your software, make sure you make clean
before you install the new version so it has any effect.

If you find some functions are missing EINA_WARN_UNUSED_RESULT and
EINA_ARG_NONNULL or others, please add them.



SVN revision: 38323
2008-12-26 13:17:51 +00:00
..
.cvsignore Don't display gcov file. 2008-08-01 12:24:53 +00:00
Makefile.am Add dladdr and env code for eina_module from Vincent Torri. 2008-11-01 15:39:53 +00:00
eina_accessor.c remove dead stores and reduce some variable scope. 2008-12-23 19:17:55 +00:00
eina_array.c Let valgrind help with EINA_MAGIC. 2008-12-06 06:53:14 +00:00
eina_benchmark.c Remove now uneeded header. 2008-12-23 13:23:10 +00:00
eina_convert.c Zero is a correct value. 2008-10-20 13:21:52 +00:00
eina_counter.c Add include to remove warning. 2008-12-16 16:49:00 +00:00
eina_error.c Make code understandable by Visual Studio. 2008-12-23 10:04:46 +00:00
eina_file.c Make it compile on Solaris. 2008-12-23 13:33:11 +00:00
eina_hash.c eina gets lots of gcc attributes to its api. 2008-12-26 13:17:51 +00:00
eina_inlist.c Fix couple of issues with MAGIC handling. 2008-12-06 06:17:11 +00:00
eina_iterator.c Manipulating NULL iterator should be concidered as a defined behaviour as it 2008-12-11 13:54:59 +00:00
eina_lalloc.c add main doc for eina_convert 2008-09-23 15:57:57 +00:00
eina_list.c Let valgrind help with EINA_MAGIC. 2008-12-06 06:53:14 +00:00
eina_magic.c Rename EINA_INLIST_ITER_NEXT/EINA_INLIST_ITER_LAST to EINA_INLIST_FOREACH/ 2008-10-21 12:19:57 +00:00
eina_main.c Add Eina_Rectangle_Pool support. Typically help for font handling in OpenGL or 2008-10-27 20:24:12 +00:00
eina_mempool.c Add dladdr and env code for eina_module from Vincent Torri. 2008-11-01 15:39:53 +00:00
eina_module.c Remove PATH_MAX use. 2008-12-23 13:12:06 +00:00
eina_rbtree.c remove dead stores and reduce some variable scope. 2008-12-23 19:17:55 +00:00
eina_rectangle.c remove dead stores and reduce some variable scope. 2008-12-23 19:17:55 +00:00
eina_stringshare.c fix possible errors with pointer/offset calculation. 2008-12-23 20:05:44 +00:00
eina_value.c * move standard header files from eina_private.h to source files 2008-08-28 07:46:42 +00:00