diff --git a/op/paint/doc.go b/op/paint/doc.go
index 3b7859f7..ae69faca 100644
--- a/op/paint/doc.go
+++ b/op/paint/doc.go
@@ -3,11 +3,11 @@
 /*
 Package paint provides drawing operations for 2D graphics.
 
-The PaintOp operation draws the current brush into a rectangular
-area, taking the current clip path and transformation into account.
+The PaintOp operation fills the current clip with the current brush,
+taking the current transformation into account.
 
 The current brush is set by either a ColorOp for a constant color, or
-ImageOp for an image.
+ImageOp for an image, or LinearGradientOp for gradients.
 
 All color.RGBA values are in the sRGB color space.
 */