From 8919faa7b3eb7616d6e55933da518eb93b8ab4f0 Mon Sep 17 00:00:00 2001
From: Daniel Hahler <git@thequod.de>
Date: Sat, 14 Feb 2015 18:55:42 +0100
Subject: [PATCH] doc: fix warnings from doxygen

---
 banning.c  |  1 -
 dbus.c     | 10 ++++------
 draw.c     |  1 -
 ewmh.c     |  3 +--
 property.c |  2 --
 stack.c    |  2 +-
 6 files changed, 6 insertions(+), 13 deletions(-)

diff --git a/banning.c b/banning.c
index ef1181e8d..3d1f37120 100644
--- a/banning.c
+++ b/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)
diff --git a/dbus.c b/dbus.c
index f11d4fe64..f606cd65f 100644
--- a/dbus.c
+++ b/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)
diff --git a/draw.c b/draw.c
index 7e5d762d1..7f96e3733 100644
--- a/draw.c
+++ b/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.
diff --git a/ewmh.c b/ewmh.c
index e2e1ccf37..7073bb1a8 100755
--- a/ewmh.c
+++ b/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)
@@ -556,7 +556,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)
diff --git a/property.c b/property.c
index c866c317f..72608fd54 100644
--- a/property.c
+++ b/property.c
@@ -338,8 +338,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,
diff --git a/stack.c b/stack.c
index 7c9168963..17213fde5 100644
--- a/stack.c
+++ b/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!
  */