diff --git a/lib/awful/screen.lua b/lib/awful/screen.lua
index ee384139..161b9682 100644
--- a/lib/awful/screen.lua
+++ b/lib/awful/screen.lua
@@ -207,6 +207,12 @@ end
 --
 -- Reading this (read only) property returns a screenshot of the physical
 -- (Xinerama) screen as a cairo surface.
+--
+-- @DOC_screen_content_EXAMPLE@
+--
+-- @property content
+-- @tparam screen s (self)
+-- @treturn cairo scurface of the screen content
 
 function screen.object.get_content(s)
     local geo = s.geometry