media: vidioc-enum-fmt.rst: make the ENUM_FMT text clearer
authorHans Verkuil <hverkuil-cisco@xs4all.nl>
Wed, 6 May 2020 12:16:00 +0000 (14:16 +0200)
committerMauro Carvalho Chehab <mchehab+huawei@kernel.org>
Wed, 6 May 2020 12:49:37 +0000 (14:49 +0200)
commit6ba189d3f78c331153c4a6eb27163e27fc274123
treee69e3be81201d52e94416b7d035ad9b6e8404ea2
parentc7ff09f6e262c1ed3e0bf3d465d5204042957036
media: vidioc-enum-fmt.rst: make the ENUM_FMT text clearer

Rework the documentation to make it easier for the reader to understand
the differences in behavior of this ioctl between MC and non-MC drivers.

Note the addition of the 'video-node-centric' and 'MC-centric' terms to
help understand what the IO_MC capability really means.

Also mention in the beginning that mbus_code is one of the fields that
application should initialize, and add META_OUTPUT as one of the types that
this ioctl supports (that was never added here when the META_OUTPUT buffer
type was added).

Finally document that EINVAL will be returned if mbus_code is unsupported.

Fixes: e5b6b07a1b45 ("media: v4l2: Extend VIDIOC_ENUM_FMT to support MC-centric devices")
Signed-off-by: Hans Verkuil <hverkuil-cisco@xs4all.nl>
Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Documentation/userspace-api/media/v4l/vidioc-enum-fmt.rst