From: glima <glima@7cbeb6ba-43b4-40fd-8cce-4c39aea84d33>
Date: Wed, 10 Aug 2011 21:24:50 +0000 (+0000)
Subject: [elementary] More on cursors.
X-Git-Tag: REL_F_I9500_20120323_1~17^2~1960
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=5c8a1c0bae1eff9184cebc3f7ef5ae7807e41268;p=framework%2Fuifw%2Felementary.git

[elementary] More on cursors.



git-svn-id: svn+ssh://svn.enlightenment.org/var/svn/e/trunk/elementary@62316 7cbeb6ba-43b4-40fd-8cce-4c39aea84d33
---

diff --git a/src/lib/Elementary.h.in b/src/lib/Elementary.h.in
index 3fbc1d1..093990a 100644
--- a/src/lib/Elementary.h.in
+++ b/src/lib/Elementary.h.in
@@ -13837,10 +13837,19 @@ extern "C" {
    /**
     * @defgroup Cursors Cursors
     *
-    * The Cursor is an internal smart object used to customize the
-    * cursor displayed over objects (or widgets).
-    * It can use default X cursors (if using X), or cursors from a
-    * theme.
+    * The Elementary cursor is an internal smart object used to
+    * customize the mouse cursor displayed over objects (or
+    * widgets). In the most common scenario, the cursor decoration
+    * comes from the graphical @b engine Elementary is running
+    * on. Those engines may provide different decorations for cursors,
+    * and Elementary provides functions to choose them (think of X11
+    * cursors, as an example).
+    *
+    * There's also the possibility of, besides using engine provided
+    * cursors, also use ones coming from Edje theming files. Both
+    * globally and per widget, Elementary makes it possible for one to
+    * make the cursors lookup to be held on engines only or on
+    * Elementary's theme file, too.
     *
     * @{
     */