Ecore_X: Add some doxy for newly added functions (to keep Tom happy),

and fix some horrid formatting.

git-svn-id: http://svn.enlightenment.org/svn/e/trunk/ecore@61562 7cbeb6ba-43b4-40fd-8cce-4c39aea84d33

diff --git a/src/lib/ecore_x/xlib/ecore_x.c b/src/lib/ecore_x/xlib/ecore_x.c
index 94d304d..fa427ab 100644 (file)
--- a/src/lib/ecore_x/xlib/ecore_x.c
+++ b/src/lib/ecore_x/xlib/ecore_x.c
@@ -1823,10 +1823,10 @@ EAPI void
 ecore_x_pointer_last_xy_get(int *x, int *y)
 {
    if (x)
-      *x = _ecore_x_event_last_root_x;
+     *x = _ecore_x_event_last_root_x;
 
    if (y)
-      *y = _ecore_x_event_last_root_y;
+     *y = _ecore_x_event_last_root_y;
 } /* ecore_x_pointer_last_xy_get */
 
 EAPI void
@@ -1837,25 +1837,23 @@ ecore_x_pointer_xy_get(Ecore_X_Window win, int *x, int *y)
    unsigned int mask;
 
    LOGFN(__FILE__, __LINE__, __FUNCTION__);
-   ret = XQueryPointer(_ecore_x_disp,
-                       win,
-                       &rwin,
-                       &cwin,
-                       &rx,
-                       &ry,
-                       &wx,
-                       &wy,
-                       &mask);
+   ret = XQueryPointer(_ecore_x_disp, win, &rwin, &cwin, 
+                       &rx, &ry, &wx, &wy, &mask);
    if (!ret)
-      wx = wy = -1;
+     wx = wy = -1;
 
-   if (x)
-      *x = wx;
-
-   if (y)
-      *y = wy;
+   if (x) *x = wx;
+   if (y) *y = wy;
 } /* ecore_x_pointer_xy_get */
 
+/**
+ * Retrieve the Visual ID from a given Visual.
+ *
+ * @param visual  The Visual to get the ID for.
+ *
+ * @return The visual id.
+ * @since 1.1.0
+ */
 EAPI unsigned int 
 ecore_x_visual_id_get(Ecore_X_Visual visual) 
 {

diff --git a/src/lib/ecore_x/xlib/ecore_x_selection.c b/src/lib/ecore_x/xlib/ecore_x_selection.c
index eb9cbd1..8cc8d14 100644 (file)
--- a/src/lib/ecore_x/xlib/ecore_x_selection.c
+++ b/src/lib/ecore_x/xlib/ecore_x_selection.c
@@ -716,12 +716,27 @@ ecore_x_selection_parser_del(const char *target)
      }
 } /* ecore_x_selection_parser_del */
 
+/**
+ * Change the owner and last-change time for the specified selection.
+ * @param win The owner of the specified atom.
+ * @param atom The selection atom
+ * @param time Specifies the time
+ * @since 1.1.0
+ */
 EAPI void 
 ecore_x_selection_owner_set(Ecore_X_Window win, Ecore_X_Atom atom, Ecore_X_Time time) 
 {
    XSetSelectionOwner(_ecore_x_disp, atom, win, time);
 }
 
+/**
+ * Return the window that currently owns the specified selection.
+ * 
+ * @param atom The specified selection atom.
+ * 
+ * @return The window that currently owns the specified selection.
+ * @since 1.1.0
+ */
 EAPI Ecore_X_Window 
 ecore_x_selection_owner_get(Ecore_X_Atom atom) 
 {