diff --git a/Documentation/DocBook/media/v4l/vidioc-dv-timings-cap.xml b/Documentation/DocBook/media/v4l/vidioc-dv-timings-cap.xml
index a2017bfcaed2..b6f47a6b14d5 100644
--- a/Documentation/DocBook/media/v4l/vidioc-dv-timings-cap.xml
+++ b/Documentation/DocBook/media/v4l/vidioc-dv-timings-cap.xml
@@ -55,8 +55,9 @@
interface and may change in the future.
- To query the capabilities of the DV receiver/transmitter applications
-can call the VIDIOC_DV_TIMINGS_CAP ioctl on a video node
+ To query the capabilities of the DV receiver/transmitter applications initialize the
+pad field to 0, zero the reserved array of &v4l2-dv-timings-cap;
+and call the VIDIOC_DV_TIMINGS_CAP ioctl on a video node
and the driver will fill in the structure. Note that drivers may return
different values after switching the video input or output.
@@ -65,8 +66,8 @@ queried by calling the VIDIOC_SUBDEV_DV_TIMINGS_CAP ioctl
directly on a subdevice node. The capabilities are specific to inputs (for DV
receivers) or outputs (for DV transmitters), applications must specify the
desired pad number in the &v4l2-dv-timings-cap; pad
-field. Attempts to query capabilities on a pad that doesn't support them will
-return an &EINVAL;.
+field and zero the reserved array. Attempts to query
+capabilities on a pad that doesn't support them will return an &EINVAL;.
struct v4l2_bt_timings_cap
@@ -145,7 +146,8 @@ return an &EINVAL;.
__u32
reserved[2]
- Reserved for future extensions. Drivers must set the array to zero.
+ Reserved for future extensions. Drivers and applications must
+ set the array to zero.
union