Enlightenment CVS committal

Author  : dj2
Project : e17
Module  : libs/ewl

Dir     : e17/libs/ewl/src/lib


Modified Files:
        ewl_entry.c ewl_filedialog.c ewl_filelist.c ewl_floater.c 
        ewl_freebox.c ewl_grid.c ewl_icon.c ewl_iconbox.c ewl_image.c 
        ewl_imenu.c ewl_media.c ewl_menu.c 


Log Message:
doxy ++

===================================================================
RCS file: /cvs/e/e17/libs/ewl/src/lib/ewl_entry.c,v
retrieving revision 1.54
retrieving revision 1.55
diff -u -3 -r1.54 -r1.55
--- ewl_entry.c 25 May 2006 18:27:18 -0000      1.54
+++ ewl_entry.c 26 May 2006 17:25:59 -0000      1.55
@@ -228,6 +228,15 @@
 /*
  * internal stuff
  */
+
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev: UNUSED
+ * @param data: UNUSED
+ * @return Returns no value
+ * @brief The configure callback
+ */
 void
 ewl_entry_cb_configure(Ewl_Widget *w, void *ev __UNUSED__, 
                                        void *data __UNUSED__)
@@ -268,6 +277,14 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev: UNUSED
+ * @param data: UNUSED
+ * @return Returns no value
+ * @brief The focus in callback
+ */
 void 
 ewl_entry_cb_focus_in(Ewl_Widget *w, void *ev __UNUSED__, 
                                        void *data __UNUSED__)
@@ -285,6 +302,14 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev: UNUSED
+ * @param data: UNUSED
+ * @return Returns no value
+ * @brief The focus out callback
+ */
 void 
 ewl_entry_cb_focus_out(Ewl_Widget *w, void *ev __UNUSED__, 
                                        void *data __UNUSED__)
@@ -302,6 +327,14 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev: The Ewl_Event_Key_Down data
+ * @param data: UNUSED
+ * @return Returns no value
+ * @brief The key down callback
+ */
 void
 ewl_entry_cb_key_down(Ewl_Widget *w, void *ev, void *data __UNUSED__)
 {
@@ -394,6 +427,14 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev: The Ewl_Event_Mouse_Down data
+ * @param data: UNUSED
+ * @return Returns no value
+ * @brief The mouse down callback
+ */
 void
 ewl_entry_cb_mouse_down(Ewl_Widget *w, void *ev, void *data __UNUSED__)
 {
@@ -419,6 +460,14 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev: UNUSED
+ * @param data: UNUSED
+ * @return Returns no value
+ * @brief The mouse up callback
+ */
 void
 ewl_entry_cb_mouse_up(Ewl_Widget *w, void *ev __UNUSED__, 
                                        void *data __UNUSED__)
@@ -437,6 +486,14 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev: UNUSED
+ * @param data: UNUSED
+ * @return Returns no value
+ * @brief The disable callback
+ */
 void
 ewl_entry_cb_disable(Ewl_Widget *w, void *ev __UNUSED__, void *data __UNUSED__)
 {
@@ -449,6 +506,14 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev: UNUSED
+ * @param data: UNUSED
+ * @return Returns no value
+ * @brief The enable callback
+ */
 void
 ewl_entry_cb_enable(Ewl_Widget *w, void *ev __UNUSED__, void *data __UNUSED__)
 {
@@ -461,6 +526,14 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev: UNUSED
+ * @param data: UNUSED
+ * @return Returns no value
+ * @brief The mouse move callback
+ */
 void
 ewl_entry_cb_mouse_move(Ewl_Widget *w, void *ev __UNUSED__, 
                                        void *data __UNUSED__)
===================================================================
RCS file: /cvs/e/e17/libs/ewl/src/lib/ewl_filedialog.c,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -3 -r1.25 -r1.26
--- ewl_filedialog.c    23 May 2006 20:17:01 -0000      1.25
+++ ewl_filedialog.c    26 May 2006 17:25:59 -0000      1.26
@@ -413,6 +413,15 @@
 /*
  * Internally used callback, override at your own risk.
  */
+
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev_data: UNUSED
+ * @param data: UNUSED
+ * @return Returns no value
+ * @brief Callback to handle deleting of the filedialog window
+ */
 void
 ewl_filedialog_cb_delete_window(Ewl_Widget *w, void *ev_data __UNUSED__, 
                                                        void *data __UNUSED__)
===================================================================
RCS file: /cvs/e/e17/libs/ewl/src/lib/ewl_filelist.c,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -3 -r1.16 -r1.17
--- ewl_filelist.c      25 May 2006 18:27:18 -0000      1.16
+++ ewl_filelist.c      26 May 2006 17:25:59 -0000      1.17
@@ -990,6 +990,14 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev: UNUSED
+ * @param data: UNUSED
+ * @return Returns no value
+ * @brief The destroy callback
+ */
 void
 ewl_filelist_cb_destroy(Ewl_Widget *w, void *ev __UNUSED__, 
                                        void *data __UNUSED__)
===================================================================
RCS file: /cvs/e/e17/libs/ewl/src/lib/ewl_floater.c,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -3 -r1.10 -r1.11
--- ewl_floater.c       17 Feb 2006 02:19:26 -0000      1.10
+++ ewl_floater.c       26 May 2006 17:25:59 -0000      1.11
@@ -184,8 +184,14 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
-/*
- * Use this to ensure the floater gets configured when the parent/window is.
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev_data: UNUSED
+ * @param user_data: UNUSED
+ * @return Returns no value
+ * @brief Use this to ensure the floater gets configured when the
+ * parent/window gets configured.
  */
 void
 ewl_floater_follow_configure_cb(Ewl_Widget *w, void *ev_data __UNUSED__,
@@ -246,6 +252,14 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev_data: UNUSED
+ * @param user_data: UNUSED
+ * @return Returns no value
+ * @brief Callback when the followed widget is destroyed
+ */
 void
 ewl_floater_follow_destroy_cb(Ewl_Widget *w, void *ev_data __UNUSED__,
                                                void *user_data __UNUSED__)
===================================================================
RCS file: /cvs/e/e17/libs/ewl/src/lib/ewl_freebox.c,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -3 -r1.10 -r1.11
--- ewl_freebox.c       11 Apr 2006 16:15:56 -0000      1.10
+++ ewl_freebox.c       26 May 2006 17:25:59 -0000      1.11
@@ -248,6 +248,14 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev: UNUSED
+ * @param data: UNUSED
+ * @return Returns no value
+ * @brief The configure callback
+ */
 void
 ewl_freebox_cb_configure(Ewl_Widget *w, void *ev __UNUSED__, 
                                        void *data __UNUSED__)
@@ -271,6 +279,13 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param c: The container
+ * @param w: The widget to work with
+ * @return Returns no value
+ * @brief Callback for when a child is added
+ */
 void
 ewl_freebox_cb_child_add(Ewl_Container *c, Ewl_Widget *w)
 {
@@ -293,6 +308,13 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param c: The container
+ * @param w: The widget to work with
+ * @return Returns no value
+ * @brief Callback for when a child is shown
+ */
 void
 ewl_freebox_cb_child_show(Ewl_Container *c, Ewl_Widget *w)
 {
===================================================================
RCS file: /cvs/e/e17/libs/ewl/src/lib/ewl_grid.c,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -3 -r1.15 -r1.16
--- ewl_grid.c  27 Feb 2006 19:51:35 -0000      1.15
+++ ewl_grid.c  26 May 2006 17:25:59 -0000      1.16
@@ -427,6 +427,14 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev_data: UNUSED
+ * @param user_data: UNUSED
+ * @return Returns no value
+ * @brief The realize callback
+ */
 void
 ewl_grid_realize_cb(Ewl_Widget *w, void *ev_data __UNUSED__,
                                        void *user_data __UNUSED__)
@@ -457,6 +465,14 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev_data: UNUSED
+ * @param user_data: UNUSED
+ * @return Returns no value
+ * @brief The configure callback
+ */
 void
 ewl_grid_configure_cb(Ewl_Widget *w, void *ev_data __UNUSED__,
                                        void *user_data __UNUSED__)
@@ -513,9 +529,17 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev_data: UNUSED
+ * @param user_data: UNUSED
+ * @return Returns no value
+ * @brief The destroy callback
+ */
 void
 ewl_grid_destroy_cb(Ewl_Widget *w, void *ev_data __UNUSED__,
-               void *user_data __UNUSED__)
+                               void *user_data __UNUSED__)
 {
        Ewl_Grid *g;
 
@@ -533,9 +557,17 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev_data: UNUSED
+ * @param user_data: User data
+ * @return Returns no value
+ * @brief The child destroy callback
+ */
 void
 ewl_grid_child_destroy_cb(Ewl_Widget *w, void *ev_data __UNUSED__,
-               void *user_data)
+                                               void *user_data)
 {
        Ewl_Widget *child;
 
@@ -634,8 +666,12 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
-/*
- * Notify the grid that a child has been added.
+/**
+ * @internal
+ * @param p: The container to work with
+ * @param c: The widget to work with
+ * @return Returns no value
+ * @brief Notify the grid that a child has been added.
  */
 void
 ewl_grid_child_show_cb(Ewl_Container *p, Ewl_Widget *c)
@@ -758,8 +794,14 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
-/*
- * Catch notification of child resizes.
+/**
+ * @internal
+ * @param p: The container to work with
+ * @param child: The widget to work with
+ * @param size: The new child size
+ * @param o: The orientation
+ * @return Returns no value
+ * @brief Catch notification of child resizes.
  */
 void
 ewl_grid_child_resize_cb(Ewl_Container *p, Ewl_Widget *child, int size,
===================================================================
RCS file: /cvs/e/e17/libs/ewl/src/lib/ewl_icon.c,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -3 -r1.14 -r1.15
--- ewl_icon.c  23 May 2006 04:50:32 -0000      1.14
+++ ewl_icon.c  26 May 2006 17:25:59 -0000      1.15
@@ -442,6 +442,14 @@
        DRETURN_INT(icon->compress_label, DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev: UNUSED
+ * @param data: UNUSED
+ * @return Returns no value
+ * @brief The destroy callback
+ */
 void
 ewl_icon_cb_destroy(Ewl_Widget *w, void *ev __UNUSED__, void *data __UNUSED__)
 {
===================================================================
RCS file: /cvs/e/e17/libs/ewl/src/lib/ewl_iconbox.c,v
retrieving revision 1.117
retrieving revision 1.118
diff -u -3 -r1.117 -r1.118
--- ewl_iconbox.c       26 May 2006 15:35:02 -0000      1.117
+++ ewl_iconbox.c       26 May 2006 17:25:59 -0000      1.118
@@ -141,7 +141,6 @@
 
 /**
  * @return Returns a new Ewl_Iconbox_Icon, NULL on failure
- *
  */
 Ewl_Widget *
 ewl_iconbox_icon_new(void)
@@ -484,6 +483,11 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @param ib: The iconbox
+ * @return Returns the list of selected widgets
+ * @brief Retrieves the the current selected icons from the list
+ */
 Ecore_List *
 ewl_iconbox_get_selection(Ewl_Iconbox *ib) 
 {
@@ -512,7 +516,11 @@
        DRETURN_PTR(selected, DLEVEL_STABLE);
 }
 
-/* Move to the root of the scrollpame */
+/**
+ * @param ib: The iconbox
+ * @return Returns no value
+ * @brief Move to the root of the scrollpame 
+ */
 void
 ewl_iconbox_scrollpane_goto_root(Ewl_Iconbox *ib) 
 {
@@ -526,6 +534,12 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @param ib: The iconbox to work with
+ * @param file: The background file to set
+ * @return Returns no value
+ * @brief Sets the given background into the iconbox
+ */
 void
 ewl_iconbox_background_set(Ewl_Iconbox *ib, const char *file)
 {
@@ -680,6 +694,12 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @param ib: The iconbox
+ * @param edit: The editable setting 
+ * @return Returns no value
+ * @brief Sets the editable flag of the iconbox
+ */
 void
 ewl_iconbox_editable_set(Ewl_Iconbox *ib, int edit)
 {
@@ -693,6 +713,11 @@
 }
 
 
+/**
+ * @param ib: The iconbox to work with
+ * @return Returns no value
+ * @brief Recalculate the scrollpane
+ */
 void
 ewl_iconbox_scrollpane_recalculate(Ewl_Iconbox *ib)
 {
@@ -712,6 +737,11 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @param ib: The iconbox
+ * @return Returns no value
+ * @brief Arrange the icons
+ */
 void
 ewl_iconbox_icon_arrange(Ewl_Iconbox *ib)
 {
@@ -885,6 +915,11 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @param ib: The iconbox
+ * @return Returns no value
+ * @brief Deselects all items in the iconbox 
+ */
 void
 ewl_iconbox_deselect_all(Ewl_Iconbox *ib)
 {
@@ -902,6 +937,12 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @param ib: The iconbox to work with
+ * @param icon: The icon to remove
+ * @return Returns no value
+ * @brief Removes the given icon from the iconbox
+ */
 void
 ewl_iconbox_icon_remove(Ewl_Iconbox *ib, Ewl_Iconbox_Icon *icon) 
 {
@@ -946,6 +987,13 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @param iconbox: The iconbox to work with
+ * @param name: The icon name
+ * @param icon_file: The icon image file
+ * @return Returns the new Ewl_Iconbox_Icon file
+ * @brief Creates and adds a new icon to the iconbox
+ */
 Ewl_Iconbox_Icon * 
 ewl_iconbox_icon_add(Ewl_Iconbox *iconbox, const char *name, const char 
*icon_file)
 {
@@ -1032,6 +1080,12 @@
        DRETURN_PTR(EWL_ICONBOX_ICON(ib), DLEVEL_STABLE);
 }
 
+/**
+ * @param icon: The icon to set the image on
+ * @param filename: The image file name
+ * @return Returns no value
+ * @brief Sets the given image into the icon
+ */
 void
 ewl_iconbox_icon_image_set(Ewl_Iconbox_Icon *icon, const char *filename)
 {
@@ -1047,6 +1101,11 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @param ib: The iconbox to work with
+ * @return Returns no value
+ * @brief Clears the iconbox 
+ */
 void
 ewl_iconbox_clear(Ewl_Iconbox *ib)
 {
@@ -1076,6 +1135,14 @@
 }
 
 /* Callbacks */
+/**
+ * @internal
+ * @param item: UNUSED
+ * @param ev_data: The Ewl_Event_Dnd_Drop data
+ * @param user_data: The iconbox 
+ * @return Returns no value
+ * @brief The drag and drop drop callback
+ */
 void
 ewl_iconbox_dnd_drop_cb(Ewl_Widget *item __UNUSED__, 
                        void *ev_data, void *user_data) 
@@ -1121,6 +1188,14 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param item: UNUSED
+ * @param ev_data: UNUSED
+ * @param user_data: The iconbox
+ * @return Returns no value
+ * @brief The drag and drop position callback
+ */
 void
 ewl_iconbox_dnd_position_cb(Ewl_Widget *item __UNUSED__, 
                void *ev_data __UNUSED__, void *user_data) 
@@ -1157,6 +1232,14 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE); 
 }
 
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev_data: UNUSED
+ * @param user_data: UNUSED
+ * @return Returns no value
+ * @brief The destroy callback
+ */
 void
 ewl_iconbox_destroy_cb(Ewl_Widget *w, void *ev_data __UNUSED__, void 
*user_data __UNUSED__)
 {
@@ -1173,6 +1256,14 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev_data: UNUSED
+ * @param user_data: UNUSED
+ * @return Returns no value
+ * @brief The realize callback
+ */
 void ewl_iconbox_icon_destroy_cb(Ewl_Widget *w, void *ev_data __UNUSED__,
                                        void *user_data __UNUSED__)
 {
@@ -1190,6 +1281,14 @@
 }
 
 /* ----------- */
+/**
+ * @internal
+ * @param w: UNUSED
+ * @param ev_data: UNUSED
+ * @param user_data: The iconbox
+ * @return Returns no value
+ * @brief The arrange callback
+ */
 void
 ewl_iconbox_arrange_cb(Ewl_Widget *w __UNUSED__, void *ev_data __UNUSED__, 
void *user_data)
 {
@@ -1205,6 +1304,14 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: UNUSED
+ * @param ev_data: The Ewl_Event_Mouse_Move data
+ * @param user_data: The iconbox 
+ * @return Returns no value
+ * @brief The mouse move callback
+ */
 void
 ewl_iconbox_mouse_move_cb(Ewl_Widget *w __UNUSED__, void *ev_data, void 
*user_data)
 {
@@ -1328,6 +1435,14 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: UNUSED
+ * @param ev_data: The Ewl_Event_Mouse_Down data
+ * @param user_data: The iconbox
+ * @return Returns no value
+ * @brief The pane mouse down callback
+ */
 void
 ewl_iconbox_pane_mouse_down_cb(Ewl_Widget *w __UNUSED__, void *ev_data, void 
*user_data)
 {
@@ -1384,6 +1499,14 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: UNUSED
+ * @param ev_data: Ewl_Event_Mouse_Down data
+ * @param user_data: The iconbox icon
+ * @return Returns no value
+ * @brief The icon mouse down callback
+ */
 void
 ewl_iconbox_icon_mouse_down_cb(Ewl_Widget *w __UNUSED__, void *ev_data, void 
*user_data)
 {
@@ -1437,6 +1560,14 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: UNUSED
+ * @param ev_data: The Ewl_Event_Mouse_Down data
+ * @param user_data: The Iconbox icon
+ * @return Returns no value
+ * @brief The icon mouse up callback
+ */
 void
 ewl_iconbox_icon_mouse_up_cb(Ewl_Widget *w __UNUSED__, void *ev_data , void 
*user_data)
 {
@@ -1465,6 +1596,14 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: UNUSED
+ * @param ev_data: The Ewl_Event_Mouse_Up data
+ * @param user_data: The Iconbox
+ * @return Returns no value
+ * @brief The mouse up callback
+ */
 void
 ewl_iconbox_mouse_up_cb(Ewl_Widget *w __UNUSED__, void *ev_data, void 
*user_data)
 {
@@ -1491,6 +1630,14 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: UNUSED
+ * @param ev_data: UNUSED
+ * @param user_data: The iconbox icon
+ * @return Returns no value
+ * @brief The icon label mouse down callback
+ */
 void
 ewl_iconbox_icon_label_mouse_down_cb(Ewl_Widget *w __UNUSED__, void *ev_data 
__UNUSED__, void *user_data)
 {
@@ -1508,10 +1655,13 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
-/*
- * @param ib: The iconbox
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev_data: UNUSED
+ * @param user_data: UNUSED
  * @return Returns no value
- * @brief Initialize the icon box
+ * @brief The configure callback
  */
 void
 ewl_iconbox_configure_cb(Ewl_Widget *w, void *ev_data __UNUSED__, void 
*user_data __UNUSED__)
@@ -1548,6 +1698,12 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @param i1: The first icon
+ * @param i2: The second icon
+ * @return Returns the distance between the icons
+ * @brief Retrieves the distance between the two icons
+ */
 double
 ewl_iconbox_icon_distance(Ewl_Iconbox_Icon *i1, Ewl_Iconbox_Icon *i2) 
 {
@@ -1561,8 +1717,16 @@
                                + pow(CURRENT_Y(i1) - CURRENT_Y(i2), 2)), 
DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: UNUSED
+ * @param ev_data: The Ewl_Event_Key_Down data
+ * @param user_data: The iconbox
+ * @return Returns no value
+ * @brief The key press callback
+ */
 void
-ewl_iconbox_key_press_cb (Ewl_Widget *w __UNUSED__, void *ev_data __UNUSED__, 
void *user_data) 
+ewl_iconbox_key_press_cb (Ewl_Widget *w __UNUSED__, void *ev_data, void 
*user_data) 
 {
        Ewl_Event_Key_Down *event;
        Ewl_Iconbox *ib;
@@ -1690,6 +1854,13 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @param ib: The iconbox
+ * @param cb: The callback to set for the key event
+ * @param data: User data to pass to the key event
+ * @return Returns no value
+ * @brief The realize callback
+ */
 void
 ewl_iconbox_controlled_key_callback_register(Ewl_Iconbox *ib, void 
(*cb)(Ewl_Iconbox *, void *, char *), void *data) 
 {
===================================================================
RCS file: /cvs/e/e17/libs/ewl/src/lib/ewl_image.c,v
retrieving revision 1.41
retrieving revision 1.42
diff -u -3 -r1.41 -r1.42
--- ewl_image.c 23 May 2006 05:13:04 -0000      1.41
+++ ewl_image.c 26 May 2006 17:25:59 -0000      1.42
@@ -617,6 +617,14 @@
 }
 #endif
 
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev_data: UNUSED
+ * @param user_data: UNUSED
+ * @return Returns no value
+ * @brief The reveal callback
+ */
 void
 ewl_image_reveal_cb(Ewl_Widget *w, void *ev_data __UNUSED__,
                                        void *user_data __UNUSED__)
@@ -712,6 +720,14 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev_data: UNUSED
+ * @param user_data: UNUSED
+ * @return Returns no value
+ * @brief The obscure callback
+ */
 void
 ewl_image_obscure_cb(Ewl_Widget *w, void *ev_data __UNUSED__,
                                                void *user_data __UNUSED__)
@@ -734,6 +750,14 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev_data: UNUSED
+ * @param user_data: UNUSED
+ * @return Returns no value
+ * @brief The destroy callback
+ */
 void
 ewl_image_destroy_cb(Ewl_Widget *w, void *ev_data __UNUSED__,
                                          void *user_data __UNUSED__)
@@ -752,6 +776,14 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev_data: UNUSED
+ * @param user_data: UNUSED
+ * @return Returns no value
+ * @brief The reparent callback
+ */
 void
 ewl_image_reparent_cb(Ewl_Widget *w, void *ev_data __UNUSED__,
                                                void *user_data __UNUSED__)
@@ -769,6 +801,14 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev_data: UNUSED
+ * @param user_data: UNUSED
+ * @return Returns no value
+ * @brief The configure callback
+ */
 void
 ewl_image_configure_cb(Ewl_Widget *w, void *ev_data __UNUSED__,
                                                void *user_data __UNUSED__)
@@ -871,6 +911,14 @@
        DRETURN_INT(EWL_IMAGE_TYPE_NORMAL, DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev_data: The Ewl_Event_Mouse_Down data
+ * @param user_data: UNUSED
+ * @return Returns no value
+ * @brief The mouse down callback
+ */
 void
 ewl_image_mouse_down_cb(Ewl_Widget *w, void *ev_data,
                                        void *user_data __UNUSED__)
@@ -896,6 +944,14 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev_data: The Ewl_Event_Mouse_Up data
+ * @param user_data: UNUSED
+ * @return Returns no value
+ * @brief The mouse up callback
+ */
 void
 ewl_image_mouse_up_cb(Ewl_Widget *w, void *ev_data,
                                        void *user_data __UNUSED__)
@@ -921,6 +977,14 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev_data: The Ewl_Event_Mouse_Move data
+ * @param user_data: UNUSED
+ * @return Returns no value
+ * @brief The mouse move callback
+ */
 void
 ewl_image_mouse_move_cb(Ewl_Widget *w, void *ev_data,
                                        void *user_data __UNUSED__)
===================================================================
RCS file: /cvs/e/e17/libs/ewl/src/lib/ewl_imenu.c,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -3 -r1.11 -r1.12
--- ewl_imenu.c 25 May 2006 04:38:18 -0000      1.11
+++ ewl_imenu.c 26 May 2006 17:25:59 -0000      1.12
@@ -73,6 +73,14 @@
        DRETURN_INT(TRUE, DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev_data: UNUSED
+ * @param user_data: UNUSED
+ * @return Returns no value
+ * @brief The configure callback
+ */
 void
 ewl_imenu_configure_cb(Ewl_Widget *w, void *ev_data __UNUSED__,
                                        void *user_data __UNUSED__)
@@ -99,6 +107,14 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev_data: UNUSED
+ * @param user_data: UNUSED
+ * @return Returns no value
+ * @brief The expand callback
+ */
 void
 ewl_imenu_expand_cb(Ewl_Widget *w, void *ev_data __UNUSED__,
                                        void *user_data __UNUSED__)
@@ -121,6 +137,14 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: UNUSED
+ * @param ev: UNUSED
+ * @param data: The Ewl_Imenu
+ * @return Returns no value
+ * @brief The popup destroy callback
+ */
 void
 ewl_imenu_popup_destroy_cb(Ewl_Widget *w __UNUSED__, void *ev __UNUSED__,
                                void *data)
@@ -136,6 +160,14 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev: UNUSED
+ * @param data: UNUSED
+ * @return Returns no value
+ * @brief The destroy callback
+ */
 void
 ewl_imenu_destroy_cb(Ewl_Widget *w, void *ev __UNUSED__, void *data __UNUSED__)
 {
===================================================================
RCS file: /cvs/e/e17/libs/ewl/src/lib/ewl_media.c,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -3 -r1.18 -r1.19
--- ewl_media.c 21 May 2006 03:51:41 -0000      1.18
+++ ewl_media.c 26 May 2006 17:25:59 -0000      1.19
@@ -460,9 +460,17 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev_data: UNUSED
+ * @param user_data: UNUSED
+ * @return Returns no value
+ * @brief The realize callback
+ */
 void
 ewl_media_realize_cb(Ewl_Widget *w, void *ev_data __UNUSED__,
-               void *user_data __UNUSED__)
+                               void *user_data __UNUSED__)
 {
        Ewl_Media *m;
        Ewl_Embed *emb;
@@ -503,9 +511,17 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev_data: UNUSED
+ * @param user_data: UNUSED
+ * @return Returns no value
+ * @brief The unrealize callback
+ */
 void
 ewl_media_unrealize_cb(Ewl_Widget *w, void *ev_data __UNUSED__,
-               void *user_data __UNUSED__)
+                               void *user_data __UNUSED__)
 {
        Ewl_Media *m;
 
@@ -521,6 +537,14 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev_data: UNUSED
+ * @param user_data: UNUSED
+ * @return Returns no value
+ * @brief The configure callback
+ */
 void
 ewl_media_configure_cb(Ewl_Widget *w, void *ev_data __UNUSED__,
                void *user_data __UNUSED__)
===================================================================
RCS file: /cvs/e/e17/libs/ewl/src/lib/ewl_menu.c,v
retrieving revision 1.31
retrieving revision 1.32
diff -u -3 -r1.31 -r1.32
--- ewl_menu.c  25 May 2006 04:38:18 -0000      1.31
+++ ewl_menu.c  26 May 2006 17:25:59 -0000      1.32
@@ -87,6 +87,14 @@
        DRETURN_INT(TRUE, DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev_data: UNUSED
+ * @param user_data: UNUSED
+ * @return Returns no value
+ * @brief The realize callback
+ */
 void
 ewl_menu_realize_cb(Ewl_Widget *w, void *ev_data __UNUSED__,
                                        void *user_data __UNUSED__)
@@ -111,6 +119,14 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev_data: UNUSED
+ * @param user_data: UNUSED
+ * @return Returns no value
+ * @brief The configure callback
+ */
 void
 ewl_menu_configure_cb(Ewl_Widget *w, void *ev_data __UNUSED__,
                                        void *user_data __UNUSED__)
@@ -135,6 +151,14 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev_data: UNUSED
+ * @param user_data: UNUSED
+ * @return Returns no value
+ * @brief The expand mouse move callback
+ */
 void
 ewl_menu_expand_mouse_move_cb(Ewl_Widget *w, void *ev_data __UNUSED__,
                                        void *user_data __UNUSED__) 
@@ -173,6 +197,14 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev_data: UNUSED
+ * @param user_data: UNUSED
+ * @return Returns no value
+ * @brief The expand callback
+ */
 void
 ewl_menu_expand_cb(Ewl_Widget *w, void *ev_data __UNUSED__,
                                        void *user_data __UNUSED__)
@@ -192,6 +224,14 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev_data: UNUSED
+ * @param user_data: UNUSED
+ * @return Returns no value
+ * @brief The popup move callback
+ */
 void
 ewl_menu_popup_move_cb(Ewl_Widget *w, void *ev_data __UNUSED__,
                                                void *user_data)
@@ -218,6 +258,14 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev_data: UNUSED
+ * @param user_data: UNUSED
+ * @return Returns no value
+ * @brief The mouse move callback
+ */
 void
 ewl_menu_mouse_move_cb(Ewl_Widget *w, void *ev_data, void *user_data) 
 {
@@ -254,6 +302,14 @@
        }
 }
 
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev_data: UNUSED
+ * @param user_data: UNUSED
+ * @return Returns no value
+ * @brief The hide callback
+ */
 void
 ewl_menu_hide_cb(Ewl_Widget *w, void *ev_data __UNUSED__,
                                        void *user_data __UNUSED__)
@@ -268,6 +324,14 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev: UNUSED
+ * @param data: UNUSED
+ * @return Returns no value
+ * @brief The popup destroy callback
+ */
 void
 ewl_menu_popup_destroy_cb(Ewl_Widget *w __UNUSED__, void *ev __UNUSED__,
                                        void *data)
@@ -283,6 +347,14 @@
        DLEAVE_FUNCTION(DLEVEL_STABLE);
 }
 
+/**
+ * @internal
+ * @param w: The widget to work with
+ * @param ev: UNUSED
+ * @param data: UNUSED
+ * @return Returns no value
+ * @brief The destroy callback
+ */
 void
 ewl_menu_destroy_cb(Ewl_Widget *w, void *ev __UNUSED__, void *data __UNUSED__)
 {




-------------------------------------------------------
All the advantages of Linux Managed Hosting--Without the Cost and Risk!
Fully trained technicians. The highest number of Red Hat certifications in
the hosting industry. Fanatical Support. Click to learn more
http://sel.as-us.falkag.net/sel?cmd=lnk&kid=107521&bid=248729&dat=121642
_______________________________________________
enlightenment-cvs mailing list
enlightenment-cvs@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/enlightenment-cvs

Reply via email to