diff --git a/lib/awful/hooks.lua.in b/lib/awful/hooks.lua.in
index 51aab2c00..cb2b62619 100644
--- a/lib/awful/hooks.lua.in
+++ b/lib/awful/hooks.lua.in
@@ -16,7 +16,9 @@ local capi =
 }
 local util = require("awful.util")
 
---- Hooks module for awful
+--- Hooks module for awful.
+-- This module is deprecated and should not be used anymore. You are encouraged
+-- to use signals.
 module("awful.hooks")
 
 -- User hook functions