Merge pull request #122 from blueyed/fix-ldoc-doxygen-warnings

doc: fix doxygen settings / warnings

awesome.doxygen.in

@@ -71,7 +71,6 @@ GENERATE_DEPRECATEDLIST= YES
 ENABLED_SECTIONS       = 
 MAX_INITIALIZER_LINES  = 30
 SHOW_USED_FILES        = YES
-SHOW_DIRECTORIES       = NO
 FILE_VERSION_FILTER    = 
 #---------------------------------------------------------------------------
 # configuration options related to warning and progress messages
@@ -132,7 +131,6 @@ HTML_FILE_EXTENSION    = .html
 HTML_HEADER            = 
 HTML_FOOTER            = 
 HTML_STYLESHEET        = 
-HTML_ALIGN_MEMBERS     = YES
 GENERATE_HTMLHELP      = NO
 HTML_DYNAMIC_SECTIONS  = NO
 CHM_FILE               = 

banning.c

@@ -24,7 +24,6 @@
 #include "objects/client.h"
 
 /** Reban windows following current selected tags.
- * \param screen The screen to arrange.
  */
 void
 banning_need_update(void)

dbus.c

@@ -42,7 +42,7 @@ static signal_array_t dbus_signals;
 
 /** Clean up the D-Bus connection data members
  * \param dbus_connection The D-Bus connection to clean up
- * \param dbusio The D-Bus event watcher
+ * \param source The D-Bus source
  */
 static void
 a_dbus_cleanup_bus(DBusConnection *dbus_connection, GSource **source)
@@ -459,7 +459,7 @@ a_dbus_process_request(DBusConnection *dbus_connection, DBusMessage *msg)
 
 /** Attempt to process all the requests in the D-Bus connection.
  * \param dbus_connection The D-Bus connection to process from
- * \param dbusio The D-Bus event watcher
+ * \param source The D-Bus source
  */
 static void
 a_dbus_process_requests_on_bus(DBusConnection *dbus_connection, GSource **source)
@@ -493,8 +493,7 @@ a_dbus_process_requests_on_bus(DBusConnection *dbus_connection, GSource **source
 }
 
 /** Foreword D-Bus process session requests on too the correct function.
- * \param w The D-Bus event watcher
- * \param revents (not used)
+ * \param data
  */
 static gboolean
 a_dbus_process_requests_session(gpointer data)
@@ -504,8 +503,7 @@ a_dbus_process_requests_session(gpointer data)
 }
 
 /** Foreword D-Bus process system requests on too the correct function.
- * \param w The D-Bus event watcher
- * \param revents (not used)
+ * \param data
  */
 static gboolean
 a_dbus_process_requests_system(gpointer data)

draw.c

@@ -95,7 +95,6 @@ free_data(void *data)
 }
 
 /** Create a surface object from this image data.
- * \param L The lua stack.
  * \param width The width of the image.
  * \param height The height of the image
  * \param data The image's data in ARGB format, will be copied by this function.

ewmh.c

@@ -35,7 +35,7 @@
 #define _NET_WM_STATE_TOGGLE 2
 
 /** Update client EWMH hints.
- * \param c The client.
+ * \param L The Lua VM state.
  */
 static int
 ewmh_client_update_hints(lua_State *L)
@@ -562,7 +562,6 @@ ewmh_client_check_hints(client_t *c)
 
 /** Process the WM strut of a client.
  * \param c The client.
- * \param strut_r (Optional) An existing reply.
  */
 void
 ewmh_process_client_strut(client_t *c)

property.c

@@ -340,8 +340,6 @@ property_update_wm_protocols(client_t *c, xcb_get_property_cookie_t cookie)
 /** The property notify event handler.
  * \param state currently unused
  * \param window The window to obtain update the property with.
- * \param name The protocol atom, currently unused.
- * \param reply (Optional) An existing reply.
  */
 static int
 property_handle_xembed_info(uint8_t state,

stack.c

@@ -88,7 +88,7 @@ stack_window_above(xcb_window_t w, xcb_window_t previous)
 }
 
 /** Stack a client above.
- * \param client The client.
+ * \param c The client.
  * \param previous The previous client on the stack.
  * \return The next-previous!
  */