OSDN Git Service

media: media api: Try to make enum usage clearer
authorDorota Czaplejewicz <dorota.czaplejewicz@puri.sm>
Sun, 19 Feb 2023 11:01:21 +0000 (12:01 +0100)
committerMauro Carvalho Chehab <mchehab@kernel.org>
Mon, 20 Mar 2023 14:26:40 +0000 (15:26 +0100)
commit1fde66dc5712af7c858947a06cd336fa882f2ff6
tree9da56c2e6d2ddef0f6bd4dbb47ec557493d5fe20
parent5a26272f9c2fade261e063f0c901e72979dd30a0
media: media api: Try to make enum usage clearer

This clarifies which side of the calls is responsible for doing what to
which parts of the struct. It also expands the terse description of the
access algorithm into more prose-like, active voice description, which
trades conciseness for ease of comprehension.

Fixed: typo "format" -> "frame size" in enum-frame-size
Added: no holes in the enumeration
Added: enumerations per what?
Added: who fills in what in calls
Changed: "given" -> "specified"

[Sakari Ailus: Rewrap text]

Signed-off-by: Dorota Czaplejewicz <dorota.czaplejewicz@puri.sm>
Acked-by: Hans Verkuil <hverkuil-cisco@xs4all.nl>
Signed-off-by: Sakari Ailus <sakari.ailus@linux.intel.com>
Signed-off-by: Mauro Carvalho Chehab <mchehab@kernel.org>
Documentation/userspace-api/media/v4l/vidioc-subdev-enum-frame-size.rst