media: vidioc-g-ext-ctrls.rst: reformat tables and clarify which vs ctrl_class
authorHans Verkuil <hverkuil-cisco@xs4all.nl>
Thu, 18 Mar 2021 09:03:06 +0000 (10:03 +0100)
committerMauro Carvalho Chehab <mchehab+huawei@kernel.org>
Mon, 22 Mar 2021 12:04:53 +0000 (13:04 +0100)
commita611be7589b41a79a425d9bdf5102b725a6d1cfc
treef76bb232a6fdc16136313c0d7b17296a2196acb3
parent79f382b9a9d84cd099b79cf92aa9f73d0aa64481
media: vidioc-g-ext-ctrls.rst: reformat tables and clarify which vs ctrl_class

The VIDIOC_G/S/TRY_EXT_CTRLS documentation has large explanatory texts for
some of the fields in a table. This makes it hard to read. Move those text
to a new cell spanning the whole width of the table, similar to what was
done for struct v4l2_pix_format. This makes it much more readable.

Also move the 'ctrl_class' description to below the 'which' description and
just mention that it is deprecated and that 'which' should be used instead.

Finally remove 'note::' for the V4L2_CTRL_WHICH_DEF_VAL description. It
doesn't have to be marked as a note, it's just a simple paragraph.

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-g-ext-ctrls.rst