Index: generic/include/security/cap.h
===================================================================
--- generic/include/security/cap.h	(revision c7c0b89b6e6a42abfe99e8cb5d3d5882ffdeac6e)
+++ 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