diff --git a/gtk/gtkcssprovider.c b/gtk/gtkcssprovider.c
index 5140e20985..b1134f68ce 100644
--- a/gtk/gtkcssprovider.c
+++ b/gtk/gtkcssprovider.c
@@ -433,6 +433,14 @@
* darker(@color)
* A darker variant of @color
*
+ *
+ * alpha(@color, @f)
+ * Modifies passed color's alpha by a factor @f. @f is a
+ * floating point number. @f < 1.0 results in a more transparent
+ * color while @f > 1.0 results in a more opaque color.
+ *
+ * alhpa(blue, 0.5)
+ *
*
*
*