diff --git a/common/awclient.c b/common/awclient.c
index af98bf7b..230679a1 100644
--- a/common/awclient.c
+++ b/common/awclient.c
@@ -1,5 +1,5 @@
 /*
- * awesome-client-common.c - awesome client, communicate with socket, common functions
+ * awclient.c - awesome client, communicate with socket, common functions
  *
  * Copyright © 2007-2008 Julien Danjou <julien@danjou.info>
  * Copyright © 2007 daniel@brinkers.de
@@ -29,6 +29,11 @@
 
 #define CONTROL_UNIX_SOCKET_PATH ".awesome_ctl."
 
+/** Get a sockaddr_un struct with information feeded for opening a
+ * communication to the awesome socket for given display
+ * \param display the display number
+ * \return sockaddr_un struct ready to be used or NULL if a problem occured
+ */
 struct sockaddr_un *
 get_client_addr(const char *display)
 {
@@ -72,6 +77,9 @@ get_client_addr(const char *display)
     return addr;
 }
 
+/** Get a AF_UNIX socket for communicating with awesome
+ * \return the socket file descriptor
+ */
 int
 get_client_socket(void)
 {
diff --git a/common/awclient.h b/common/awclient.h
index 23b1805f..4bc8492d 100644
--- a/common/awclient.h
+++ b/common/awclient.h
@@ -1,5 +1,5 @@
 /*
- * awesome-client.h - awesome client header
+ * awclient.h - awesome client header
  *
  * Copyright © 2007-2008 Julien Danjou <julien@danjou.info>
  *
diff --git a/common/awesome-version.c b/common/awesome-version.c
index 70023370..b4777582 100644
--- a/common/awesome-version.c
+++ b/common/awesome-version.c
@@ -26,8 +26,8 @@
 #include "awesome-version-internal.h"
 
 /** \brief Print version message and quit program.
+ * \param executable program name
  */
-
 void
 eprint_version(const char *const executable)
 {