--- zzzz-none-000/linux-3.10.107/Documentation/DocBook/media/v4l/dev-raw-vbi.xml 2017-06-27 09:49:32.000000000 +0000
+++ scorpion-7490-727/linux-3.10.107/Documentation/DocBook/media/v4l/dev-raw-vbi.xml 2021-02-04 17:41:59.000000000 +0000
@@ -150,9 +150,15 @@
This is the scanning system line number
associated with the first line of the VBI image, of the first and the
second field respectively. See and
- for valid values. VBI input drivers can
-return start values 0 if the hardware cannot reliable identify
-scanning lines, VBI acquisition may not require this
+ for valid values.
+The V4L2_VBI_ITU_525_F1_START,
+V4L2_VBI_ITU_525_F2_START,
+V4L2_VBI_ITU_625_F1_START and
+V4L2_VBI_ITU_625_F2_START defines give the start line
+numbers for each field for each 525 or 625 line format as a convenience.
+Don't forget that ITU line numbering starts at 1, not 0.
+VBI input drivers can return start values 0 if the hardware cannot
+reliable identify scanning lines, VBI acquisition may not require this
information.