diff --git a/Documentation/DocBook/media/v4l/vidioc-g-fbuf.xml b/Documentation/DocBook/media/v4l/vidioc-g-fbuf.xml
index 055718231bc1..109d7294d355 100644
--- a/Documentation/DocBook/media/v4l/vidioc-g-fbuf.xml
+++ b/Documentation/DocBook/media/v4l/vidioc-g-fbuf.xml
@@ -295,7 +295,8 @@ set this field to zero.
The device is capable of non-destructive overlays.
When the driver clears this flag, only destructive overlays are
supported. There are no drivers yet which support both destructive and
-non-destructive overlays.
+non-destructive overlays. Video Output Overlays are in practice always
+non-destructive.
V4L2_FBUF_CAP_CHROMAKEY
@@ -356,7 +357,9 @@ with the chroma-key colors are replaced by video pixels, which is exactly opposi
V4L2_FBUF_FLAG_PRIMARY
0x0001
The framebuffer is the primary graphics surface.
-In other words, the overlay is destructive. [?]
+In other words, the overlay is destructive. This flag is typically set by any
+driver that doesn't have the V4L2_FBUF_CAP_EXTERNOVERLAY
+capability and it is cleared otherwise.
V4L2_FBUF_FLAG_OVERLAY
@@ -366,9 +369,8 @@ size as the capture. [?]
The purpose of
-V4L2_FBUF_FLAG_PRIMARY and
V4L2_FBUF_FLAG_OVERLAY was never quite clear.
-Most drivers seem to ignore these flags. For compatibility with the
+Most drivers seem to ignore this flag. For compatibility with the
bttv driver applications should set the
V4L2_FBUF_FLAG_OVERLAY flag.