[CI] Update missing documentation.

include/settings.h

@@ -43,6 +43,9 @@ typedef enum
     MM_FUZZY  = 3
 } MatchingMethod;
 
+/**
+ * Possible sorting methods for listview.
+ */
 typedef enum
 {
     SORT_NORMAL = 0,

include/theme.h

@@ -32,19 +32,31 @@
 #include <widgets/widget.h>
 #include "rofi-types.h"
 
-
+/**
+ * Describe the media constraint type.
+ */
 typedef enum {
+    /** Minimum width constraint. */
     THEME_MEDIA_TYPE_MIN_WIDTH,
+    /** Maximum width constraint. */
     THEME_MEDIA_TYPE_MAX_WIDTH,
+    /** Minimum height constraint. */
     THEME_MEDIA_TYPE_MIN_HEIGHT,
+    /** Maximum height constraint. */
     THEME_MEDIA_TYPE_MAX_HEIGHT,
+    /** Monitor id constraint. */
     THEME_MEDIA_TYPE_MON_ID,
+    /** Minimum aspect ratio constraint. */
     THEME_MEDIA_TYPE_MIN_ASPECT_RATIO,
+    /** Maximum aspect ratio constraint. */
     THEME_MEDIA_TYPE_MAX_ASPECT_RATIO,
+    /** Invalid entry. */
     THEME_MEDIA_TYPE_INVALID,
 } ThemeMediaType;
 
-
+/**
+ * Theme Media description.
+ */
 typedef struct ThemeMedia {
     ThemeMediaType type;
     double value;
@@ -348,6 +360,18 @@ char * rofi_theme_parse_prepare_file ( const char *file, const char *parent_file
  * Process conditionals.
  */
 void rofi_theme_parse_process_conditionals ( void );
+
+/**
+ * @parent Target theme tree
+ * @parent child source theme three
+ *
+ * Merge all the settings from child into parent.
+ */
 void rofi_theme_parse_merge_widgets ( ThemeWidget *parent, ThemeWidget *child );
+/**
+ * @type the media type to parse.
+ *
+ * Returns the media type described by type.
+ */
 ThemeMediaType rofi_theme_parse_media_type ( const char *type );
 #endif

source/dialogs/ssh.c

@@ -56,9 +56,13 @@
 #include "history.h"
 #include "dialogs/ssh.h"
 
-
+/**
+ * Holding an ssh entry.
+ */
 typedef struct _SshEntry {
+    /** SSH hostname */
     char *hostname;
+    /** SSH port number */
     int  port;
 } SshEntry;
 /**

source/timings.c

@@ -25,13 +25,20 @@
  *
  */
 
+/** Log domain used by timings.*/
 #define G_LOG_DOMAIN    "Timings"
 
 #include "config.h"
 #include <stdio.h>
 #include "rofi.h"
 #include "timings.h"
+/**
+ * Timer used to calculate time stamps.
+ */
 GTimer *global_timer     = NULL;
+/**
+ * Last timestamp made.
+ */
 double global_timer_last = 0.0;
 
 void rofi_timings_init ( void )

source/widgets/listview.c

@@ -127,7 +127,11 @@ struct _listview
         unsigned int  cur_visible;
     } barview;
 };
-
+/**
+ * Names used for theming the elements in the listview.
+ * Each row can have 3 modes,  normal, selected and alternate.
+ * Each row can have 3 states, normal, urgent and active.
+ */
 const char *const listview_theme_prop_names[][3] = {
     /** Normal row */
     { "normal.normal", "selected.normal", "alternate.normal" },