diff --git a/docs/labwc-theme.5.scd b/docs/labwc-theme.5.scd
index e1b7bcb7..dc933da1 100644
--- a/docs/labwc-theme.5.scd
+++ b/docs/labwc-theme.5.scd
@@ -57,8 +57,9 @@ labwc-config(5).
 
 *padding.height*
 	Vertical padding size, in pixels, used for spacing out elements
-	in the window decorations.
-	Default is 3.
+	in the window decorations. Unlike *padding.width*, this padding is
+	not applied for window buttons in PNG/XBM format, or the builtin
+	hover effects. Default is 3.
 
 *titlebar.height*
 	Window title bar height.