raster pushed a commit to branch master.


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 
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)
+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);
+== See Also ==
+<code c>
diff --git a/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 @@


Reply via email to