raster pushed a commit to branch master. http://git.enlightenment.org/website/www-content.git/commit/?id=e54b1b70d4469143234e920ba9f3ad5c51bd6db7
commit e54b1b70d4469143234e920ba9f3ad5c51bd6db7 Author: Carsten Haitzler (Rasterman) <ras...@rasterman.com> Date: Tue Apr 14 17:11:10 2015 +0900 add another example for a symbol so links work --- .../docs/ref/lib/efl/gen/c/key/evas_object_ref.txt | 37 ++++++++++++++++++++++ pages/docs/ref/lib/efl/gen/c/keyword-list.txt | 2 ++ 2 files changed, 39 insertions(+) diff --git a/pages/docs/ref/lib/efl/gen/c/key/evas_object_ref.txt b/pages/docs/ref/lib/efl/gen/c/key/evas_object_ref.txt new file mode 100644 index 0000000..149fea3 --- /dev/null +++ b/pages/docs/ref/lib/efl/gen/c/key/evas_object_ref.txt @@ -0,0 +1,37 @@ +~~Title: evas_object_ref()~~ +<code c> +void evas_object_ref(Evas_Object *obj) +</code> + +This increments the reference count of the object ''obj'', which, if greater +than 0, will defer deletion by ''evas_object_del()'' until all references +are released back (counter back to 0). References cannot go below 0 and +unreferencing past that will result in the reference count being limited to +0. References are limited to //(2^32) -1// for an object. Referencing it +more than this will result in it being limited to this value. + +This is a **very simple** reference counting mechanism! For +instance, Evas is not ready to check for pending references on a +canvas deletion, or things like that. This is useful in scenarios +where, inside a code block, callbacks exist which would possibly +delete an object we are operating on afterwards. Then, one would +''evas_object_ref()'' it at the beginning of the block and +''evas_object_unref()'' it at the end. It would then be deleted at +this point, if it should be. + +== Example == +<code c> + evas_object_ref(obj); + // action here... + evas_object_smart_callback_call(obj, SIG_SELECTED, NULL); + // more action here... + evas_object_unref(obj); +</code> + +---- +== See Also == +<code c> +evas_object_del() +evas_object_unref() +Evas_Object +</code> diff --git a/pages/docs/ref/lib/efl/gen/c/keyword-list.txt b/pages/docs/ref/lib/efl/gen/c/keyword-list.txt index cef2363..a71df91 100644 --- a/pages/docs/ref/lib/efl/gen/c/keyword-list.txt +++ b/pages/docs/ref/lib/efl/gen/c/keyword-list.txt @@ -1,2 +1,4 @@ evas_object_del +evas_object_ref + --