Index: generic/include/security/cap.h
===================================================================
--- generic/include/security/cap.h	(revision 5626277b8459d4e7f87105bacfa7b3ef4aa4e53b)
+++ generic/include/security/cap.h	(revision 16dad0326d5098846c35e2175b8768aef9de8b36)
@@ -28,5 +28,10 @@
 
 /**
- * Capabilities definitions.
+ * @file	cap.h
+ * @brief	Capabilities definitions.
+ *
+ * Capabilities represent virtual rights that entitle their
+ * holder to perform certain security sensitive tasks.
+ *
  * Each task can have arbitrary combination of the capabilities
  * defined in this file. Therefore, they are required to be powers