diff --git a/lib/gears/object.lua b/lib/gears/object.lua
index 92c4a170..b9bae661 100644
--- a/lib/gears/object.lua
+++ b/lib/gears/object.lua
@@ -1,4 +1,9 @@
 ---------------------------------------------------------------------------
+-- The object oriented programming base class used by various Awesome
+-- widgets and components.
+--
+-- It provide basic observer pattern, signaling and dynamic properties.
+--
 -- @author Uli Schlachter
 -- @copyright 2010 Uli Schlachter
 -- @release @AWESOME_VERSION@