Various doc comment fixes.

awesome.c

@@ -147,7 +147,6 @@ cleanup()
 }
 
 /** Scan X to find windows to manage
- * \param screen Screen number
  */
 static void
 scan()

client.c

@@ -78,7 +78,8 @@ client_loadprops(Client * c, int screen)
 }
 
 /** Check if client supports protocol WM_DELETE_WINDOW
- * \param c the client
+ * \param disp the display
+ * \win the Window
  * \return True if client has WM_DELETE_WINDOW
  */
 static Bool
@@ -99,6 +100,7 @@ isprotodel(Display *disp, Window win)
 }
 
 /** Swap two client in the linked list clients
+ * \param head pointer ito the client list head
  * \param c1 first client
  * \param c2 second client
  */
@@ -175,7 +177,6 @@ client_attach(Client *c)
 }
 
 /** Detach client from clients list
- * \param head client list
  * \param c client to detach
  */
 void

config.c

@@ -245,8 +245,7 @@ static Key *section_keys(cfg_t *cfg_keys)
 
 
 /** Parse configuration file and initialize some stuff
- * \param disp Display ref
- * \param scr Screen number
+ * \param configpatharg Path to configuration file
  */
 void
 parse_config(const char *confpatharg)
@@ -662,10 +661,9 @@ get_numlockmask(Display *disp)
 }
 
 /** Initialize color from X side
- * \param colorstr Color code
  * \param disp Display ref
  * \param scr Screen number
- * \return XColor pixel
+ * \param colorstr Color code
  */
 static XColor
 initxcolor(Display *disp, int scr, const char *colstr)

layout.c

@@ -50,7 +50,7 @@ get_current_tag(int screen)
 }
 
 /** Arrange windows following current selected layout
- * \param disp display ref
+ * \param screen the screen to arrange
  */
 void
 arrange(int screen)

window.c

@@ -88,6 +88,7 @@ window_configure(Display *disp, Window win, int x, int y, int w, int h, int bord
 
 /** Grab or ungrab buttons on a window
  * \param disp Display ref
+ * \param screen The screen
  * \param focused True if client is focused
  * \param raised True if the client is above other clients
  * \param modkey Mod key mask