diff --git a/client.h b/client.h
index 061239df8..2808c0d84 100644
--- a/client.h
+++ b/client.h
@@ -22,17 +22,20 @@
 #ifndef AWESOME_CLIENT_H
 #define AWESOME_CLIENT_H
 
-/* mask shorthands, used in event.c and client.c */
-#define BUTTONMASK              (ButtonPressMask | ButtonReleaseMask)
-
 #include "config.h"
 
+/** Mask shorthands, used in event.c and client.c */
+#define BUTTONMASK              (ButtonPressMask | ButtonReleaseMask)
+
 typedef struct Client Client;
 struct Client
 {
+    /** Client name */
     char name[256];
+    /** Window geometry */
     int x, y, w, h;
-    int rx, ry, rw, rh;         /* revert geometry */
+    /** Real window geometry for floating */
+    int rx, ry, rw, rh;
     int basew, baseh, incw, inch, maxw, maxh, minw, minh;
     int minax, maxax, minay, maxay;
     int unmapped;
@@ -44,9 +47,12 @@ struct Client
     Client *prev;
     Client *snext;
     Window win;
+    /** Client display */
     Display * display;
+    /** Client screen */
     int screen;
-    Bool ftview; /* first time viewed on new layout */
+    /** First time viewed on new layout */
+    Bool ftview;
 };
 
 void attach(Client *);          /* attaches c to global client list */