More documentation fixes

source/rofi-icon-fetcher.c

@@ -72,6 +72,9 @@ typedef struct {
     IconFetcherNameEntry *entry;
 } IconFetcherEntry;
 
+/**
+ * The icon fetcher internal state.
+ */
 IconFetcher *rofi_icon_fetcher_data = NULL;
 
 

source/view.c

@@ -1431,6 +1431,10 @@ void rofi_view_maybe_update ( RofiViewState *state )
     rofi_view_update ( state, TRUE );
 }
 
+/**
+ * Handle window configure event.
+ * Handles resizes.
+ */
 void rofi_view_temp_configure_notify ( RofiViewState *state, xcb_configure_notify_event_t *xce )
 {
     if ( xce->window == CacheState.main_window ) {
@@ -1459,6 +1463,9 @@ void rofi_view_temp_configure_notify ( RofiViewState *state, xcb_configure_notif
     }
 }
 
+/**
+ * Quit rofi on click (outside of view )
+ */
 void rofi_view_temp_click_to_exit ( RofiViewState *state, xcb_window_t target )
 {
     if ( ( CacheState.flags & MENU_NORMAL_WINDOW ) == 0 ) {

source/widgets/listview.c

@@ -35,14 +35,23 @@
 #include "settings.h"
 #include "theme.h"
 
+/** Default spacing between the elements in the listview. */
 #define DEFAULT_SPACING    2
 
+/**
+ * Orientation of the listview
+ */
 typedef enum
 {
+    /** Vertical (classical) list */
     LISTVIEW = ROFI_ORIENTATION_VERTICAL,
+    /** Horizontal list. (barview) */
     BARVIEW  = ROFI_ORIENTATION_HORIZONTAL,
 } ViewType;
 
+/**
+ * The moving direction of the selection, this (in barview) affects the scrolling.
+ */
 typedef enum
 {
     LEFT_TO_RIGHT = 0,

source/widgets/scrollbar.c

@@ -34,6 +34,7 @@
 
 #include "theme.h"
 
+/** The default width of the scrollbar */
 #define DEFAULT_SCROLLBAR_WIDTH    8
 
 static void scrollbar_draw ( widget *, cairo_t * );

source/xcb.c

@@ -49,8 +49,9 @@
 #include <xcb/xkb.h>
 #include <xkbcommon/xkbcommon.h>
 #include <xkbcommon/xkbcommon-x11.h>
+/** Indicate that we know the startup notification api is not yet stable. */
 #define SN_API_NOT_YET_FROZEN
-/* This function is declared as sn_launcher_context_set_application_id but implemented as sn_launcher_set_application_id */
+/** This function is declared as sn_launcher_context_set_application_id but implemented as sn_launcher_set_application_id. Quick Fix. */
 #define sn_launcher_context_set_application_id    sn_launcher_set_application_id
 #include "rofi-types.h"
 #include <libsn/sn.h>
@@ -63,8 +64,9 @@
 
 #include <rofi.h>
 
-/** Minimal randr prefered for running rofi (1.5) */
+/** Minimal randr prefered for running rofi (1.5) (Major version number) */
 #define RANDR_PREF_MAJOR_VERSION 1
+/** Minimal randr prefered for running rofi (1.5) (Minor version number) */
 #define RANDR_PREF_MINOR_VERSION 5
 
 /** Checks if the if x and y is inside rectangle. */