Position sort docs enhanced + warning fixed.

diff --git a/include/position_sort.h b/include/position_sort.h
index 64d3e50..9f9bbda 100644 (file)
--- a/include/position_sort.h
+++ b/include/position_sort.h
@@ -8,6 +8,28 @@
 /**
  * @brief Sort objects by position they appear on screen
  *
+ *  example:
+ *
+ *  ------------------------------
+ *  |                   _______  |
+ *  |  _______          |     |  |
+ *  |  |     |  ______  |     |  |
+ *  |  |  A  |  |    |  |     |  |
+ *  |  |_____|  | B  |  |  C  |  |
+ *  |           |    |  |     |  |
+ *  |           |____|  |     |  |
+ *  |   _____           |     |  |             line 0: A, B, C
+ *  |   |   |           |_____|  |             line 1: D
+ *  |   | D |                    |    ====>    line 2: F
+ *  |   |___| _____              |             line 3: G
+ *  |         |   |              |
+ *  |         | F | _____        |
+ *  |         |___| |   |        |
+ *  |               | G |        |
+ *  |               |___|        |
+ *  |                            |
+ *  ------------------------------
+ *
  * @ret list List of lists
  */
 Eina_List *position_sort(const Eina_List *obj);

diff --git a/src/position_sort.c b/src/position_sort.c
index 7dacd27..5525569 100644 (file)
--- a/src/position_sort.c
+++ b/src/position_sort.c
@@ -46,7 +46,8 @@ _sort_by_x_cb(const void *a, const void *b)
 static Eina_List*
 _get_zones(const Eina_List *objs)
 {
-   Eina_List *candidates = NULL, *l;
+   Eina_List *candidates = NULL;
+   const Eina_List *l;
    AtspiAccessible *obj;
    AtspiComponent *comp;
    const ObjectCache *oc;
@@ -81,7 +82,8 @@ _get_zones(const Eina_List *objs)
 static Eina_List*
 _get_lines(const Eina_List *objs)
 {
-   Eina_List *l, *line = NULL, *lines = NULL;
+   Eina_List *line = NULL, *lines = NULL;
+   const Eina_List *l;
    AtspiAccessible *obj;
    const ObjectCache *line_beg;