Fix some doxygen warnings.

3 files changed, 9 insertions, 11 deletions

diff --git a/source/dialogs/run.c b/source/dialogs/run.c
index 523a0b4e..6dd2010f 100644
--- a/source/dialogs/run.c
+++ b/source/dialogs/run.c
@@ -151,12 +151,13 @@ static void delete_entry ( const char *cmd )
 /**
  * @param a The First key to compare
  * @param b The second key to compare
+ * @param data Unused.
  *
  * Function used for sorting.
  *
  * @returns returns less then, equal to and greater than zero is a is less than, is a match or greater than b.
  */
-static int sort_func ( const void *a, const void *b, void *data __attribute__( ( unused ) ) )
+static int sort_func ( const void *a, const void *b, G_GNUC_UNUSED void *data )
 {
     const char *astr = *( const char * const * ) a;
     const char *bstr = *( const char * const * ) b;
diff --git a/source/dialogs/ssh.c b/source/dialogs/ssh.c
index 331e5431..397893dc 100644
--- a/source/dialogs/ssh.c
+++ b/source/dialogs/ssh.c
@@ -473,8 +473,6 @@ static char *_get_display_value ( const Mode *sw, unsigned int selected_line, G_
 /**
  * @param sw Object handle to the SSH Mode object
  * @param tokens The set of tokens to match against
- * @param not_ascii If the entry is pure-ascii
- * @param case_sensitive If the entry should be matched case sensitive
  * @param index The index of the entry to match
  *
  * Match entry against the set of tokens.
diff --git a/source/x11-helper.c b/source/x11-helper.c
index 94762172..13cc8d50 100644
--- a/source/x11-helper.c
+++ b/source/x11-helper.c
@@ -253,12 +253,13 @@ void monitor_dimensions ( int x, int y, workarea *mon )
 }
 
 /**
- * @param x  The x position of the mouse [out]
- * @param y  The y position of the mouse [out]
+ * @param root The X11 window used to find the pointer position. Usually the root window.
+ * @param x    The x position of the mouse [out]
+ * @param y    The y position of the mouse [out]
  *
  * find mouse pointer location
  *
- * @returns 1 when found
+ * @returns TRUE when found, FALSE otherwise
  */
 static int pointer_get ( xcb_window_t root, int *x, int *y )
 {
@@ -270,10 +271,10 @@ static int pointer_get ( xcb_window_t root, int *x, int *y )
         *x = r->root_x;
         *y = r->root_y;
         free ( r );
-        return 1;
+        return TRUE;
     }
 
-    return 0;
+    return FALSE;
 }
 
 // determine which monitor holds the active window, or failing that the mouse pointer
@@ -585,9 +586,7 @@ void x11_set_window_opacity ( xcb_window_t box, unsigned int opacity )
 }
 
 /**
- * @param display The connection to the X server.
- *
- * Fill in the list of Atoms.
+ * Fill in the list of frequently used X11 Atoms.
  */
 static void x11_create_frequently_used_atoms ( void )
 {