History

media: v4l2-subdev: Clearly document that the crop API won't be extended

The V4L2 subdev crop API has been marked as obsolete, deprecated by the selection API. Despite this, it has recently been extended with streams support. In hindsight this was a mistake. Make sure it doesn't happen again by clearly documenting that no new extensions will be accepted.

Laurent Pinchart committed 2 years ago

Commit c580efb1 parent cefc10d2 files · +7 −3Browse files

Showing the changes to include/uapi (1 of 2 files). Show all

Unified · Split

include/uapi/linux/v4l2-subdev.h+4−0
@@ -50,6 +50,10 @@ struct v4l2_subdev_format { · 49 unmodified lines
50 * @rect: pad crop rectangle boundaries50 * @rect: pad crop rectangle boundaries
51 * @stream: stream number, defined in subdev routing51 * @stream: stream number, defined in subdev routing
52 * @reserved: drivers and applications must zero this array52 * @reserved: drivers and applications must zero this array
53 *
54 * The subdev crop API is an obsolete interface and may be removed in the
55 * future. It is superseded by the selection API. No new extensions to this
56 * structure will be accepted.
53 */57 */
54struct v4l2_subdev_crop {58struct v4l2_subdev_crop {
55 __u32 which;59 __u32 which;