Documentation updates.

* theme,
* view,
* textbox
* helper

include/theme.h

@@ -280,6 +280,15 @@ ThemeWidget *rofi_theme_find_widget ( const char *name, const char *state, gbool
  */
 Property *rofi_theme_find_property ( ThemeWidget *widget, PropertyType type, const char *property, gboolean exact );
 
+/**
+ * @param widget   The widget to query
+ * @param property The property to query.
+ * @param pad      The default value.
+ *
+ * Obtain list of elements (strings) of the widget.
+ *
+ * @returns a GList holding the names in the list of this property for this widget.
+ */
 GList *rofi_theme_get_list ( const widget *widget, const char * property, const char *defaults );
 /**
  * Checks if a theme is set, or is empty.

include/view-internal.h

@@ -119,10 +119,14 @@ struct RofiViewState
     /** Y position of the view */
     int              y;
 
+    /** Position and target of the mouse. */
     struct
     {
+        /** X position */
         int    x;
+        /** Y position */
         int    y;
+        /** Widget being targetted. */
         widget *motion_target;
     }                mouse;
 

include/widgets/textbox.h

@@ -319,6 +319,13 @@ PangoAttrList *textbox_get_pango_attributes ( textbox *tb );
  * @returns the visible text.
  */
 const char *textbox_get_visible_text ( const textbox *tb );
+/**
+ * @param wid The handle to the textbox.
+ *
+ * TODO: is this deprecated by widget::get_desired_width
+ *
+ * @returns the desired width of the textbox.
+ */
 int textbox_get_desired_width ( widget *wid );
 
 /**

source/helper.c

@@ -26,6 +26,7 @@
  *
  */
 
+/** The log domain for this helper. */
 #define G_LOG_DOMAIN    "Helper"
 
 #include <config.h>

source/theme.c

@@ -25,6 +25,7 @@
  *
  */
 
+/** Log domain used by the theme engine.*/
 #define G_LOG_DOMAIN    "Theme"
 
 #include "config.h"