diff --git a/awesomerc.lua b/awesomerc.lua
index 94a9de95f..10994c993 100644
--- a/awesomerc.lua
+++ b/awesomerc.lua
@@ -521,10 +521,7 @@ awful.rules.rules = {
     -- @DOC_DIALOG_RULE@
     -- Add titlebars to normal clients and dialogs
     { rule_any = {type = { "normal", "dialog" }
-      -- If you want programs to be able to request no titlebars, use:
-      -- For client side decorations, clients might request no titlebars via
-      -- Motif WM hints. To honor these hints, use:
-      -- titlebars_enabled = function(c) return c.requests_no_titlebar end
+      -- @DOC_CSD_TITLEBARS@
       }, properties = { titlebars_enabled = true }
     },
 
diff --git a/docs/05-awesomerc.md.lua b/docs/05-awesomerc.md.lua
index dd336e8b5..674a364b3 100644
--- a/docs/05-awesomerc.md.lua
+++ b/docs/05-awesomerc.md.lua
@@ -218,6 +218,15 @@ sections.DOC_TITLEBARS = [[
 ]]
 
 
+sections.DOC_CSD_TITLEBARS = [[
+ For client side decorations, clients might request no titlebars via
+ Motif WM hints. To honor these hints, use:
+ `titlebars_enabled = function(c) return c.requests_no_titlebar end`
+
+ See `client.requests_no_titlebar` for more details.
+]]
+
+
 sections.DOC_BORDER = [[
   
 ]]