[cleanup] random doxygen fixes

Signed-off-by: Julien Danjou <julien@danjou.info>

client.c

@@ -154,7 +154,6 @@ client_isvisible(client_t *c, int screen)
     return false;
 }
 /** Get a client by its window.
- * \param list A client_t list to look into.
  * \param w The client window to find.
  * \return A client pointer if found, NULL otherwise.
  */

cnode.c

@@ -22,7 +22,7 @@
 #include "cnode.h"
 
 /** Get the client's node focus.
- * \arap, list The client list.
+ * \param list The client list.
  * \param c The client.
  * \return The client node focus.
  */
@@ -39,7 +39,7 @@ client_node_client_getby(client_node_t *list, client_t *c)
 }
 
 /** Create a client node for focus.
- * \arap, list The client list.
+ * \param list The client list.
  * \param c The client
  * \return The client focus node.
  */

common/markup.c

@@ -96,7 +96,7 @@ markup_parse_start_element(GMarkupParseContext *context __attribute__ ((unused))
 }
 
 /** Callback to invoke when the closing tag of an element is seen. Note that
- * this is also called for empty tags like <empty/>.
+ * this is also called for empty tags like \<empty/\>.
  * Here is just copies element elements we do not care about.
  * \param context the context of GMarkup
  * \param element_name element name

mouse.c

@@ -131,7 +131,7 @@ mouse_snapclient(client_t *c, area_t geometry, int snap)
 
 /** Redraw the resizebar.
  * \param ctx Draw context.
- * \param style The style pointer to use for drawing.
+ * \param sw The simple window.
  * \param geometry The geometry to use for the box.
  * \param border The client border size.
  */
@@ -157,7 +157,6 @@ mouse_resizebar_draw(draw_context_t *ctx,
  * \param phys_screen Physical screen number.
  * \param border Border size of the client.
  * \param geometry Client geometry.
- * \param style Style used to draw.
  * \param ctx Draw context to create.
  * \return The simple window.
  */

placement.c

@@ -61,8 +61,7 @@ placement_fix_offscreen(area_t geometry, int screen, int border)
 }
 
 /** Compute smart coordinates for a client window
- * \param geometry current/requested client geometry
- * \param screen screen used
+ * \param c The client to place.
  * \return new geometry
  */
 area_t

screen.c

@@ -74,7 +74,7 @@ screen_area_get(int screen, statusbar_t *statusbar, padding_t *padding)
 }
 
 /** Get display info.
- * \param screen Physical screen number.
+ * \param phys_screen Physical screen number.
  * \param statusbar The statusbars.
  * \param padding Padding.
  * \return The display area.

statusbar.c

@@ -53,8 +53,6 @@ statusbar_draw(statusbar_t *statusbar)
 }
 
 /** Statusbar refresh function.
- * \param p A pointer to a statusbar_t.
- * \return Return NULL.
  */
 void
 statusbar_refresh(void)

widget.c

@@ -101,6 +101,7 @@ widget_common_button_press(widget_node_t *w,
 /** Common tell function for widget, which only warn user that widget
  * cannot be told anything.
  * \param widget The widget.
+ * \param property Unused argument.
  * \param new_value Unused argument.
  * \return The status of the command, which is always an error in this case.
  */
@@ -116,7 +117,7 @@ widget_common_tell(widget_t *widget,
 /** Render a list of widgets.
  * \param wnode The list of widgets.
  * \param ctx The draw context where to render.
- * \param rotate_dw The rotate pixmap: where to rotate and render the final
+ * \param rotate_px The rotate pixmap: where to rotate and render the final
  * \param screen The logical screen used to render.
  * \param position The object position.
  * \param x The x coordinates of the object.
@@ -382,7 +383,7 @@ luaA_widget_mouse(lua_State *L)
 /** Do what should be done with a widget_tell_status_t for a widget.
  * \param widget The widget.
  * \param status The status returned by the tell function of the widget.
- * \para property The property updated.
+ * \param property The property updated.
  */
 void
 widget_tell_managestatus(widget_t *widget, widget_tell_status_t status, const char *property)

widgets/taglist.c

@@ -74,7 +74,6 @@ tag_markup_parse(tag_t *t, const char *str, ssize_t len)
 
 /** Check if at least one client is tagged with tag number t and is on screen
  * screen
- * \param screen screen number
  * \param t tag
  * \return true or false
  */

window.c

@@ -136,7 +136,6 @@ window_grabbuttons(xcb_window_t win, int phys_screen)
 }
 
 /** Grab all buttons on the root window.
- * \param b The button binding.
  */
 void
 window_root_grabbuttons(void)