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	50	* @rect: pad crop rectangle boundaries
51	51	* @stream: stream number, defined in subdev routing
52	52	* @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	*/
54	58	struct v4l2_subdev_crop {
55	59	__u32 which;