media: v4l2-subdev: Clearly document that the crop API won't be extended
authorLaurent Pinchart <laurent.pinchart@ideasonboard.com>
Mon, 1 Apr 2024 23:37:25 +0000 (02:37 +0300)
committerHans Verkuil <hverkuil-cisco@xs4all.nl>
Mon, 29 Apr 2024 12:56:36 +0000 (14:56 +0200)
commitc580efb94abed05f99bb80245abe96cf5d49128c
tree47174ee62a261f3b9b888b4766735b1cb63c0881
parentcefc10d0d9164eb2f62e789b69dc658dc851eb58
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.

Suggested-by: Hans Verkuil <hverkuil-cisco@xs4all.nl>
Signed-off-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
Acked-by: Sakari Ailus <sakari.ailus@linux.intel.com>
Reviewed-by: Tomi Valkeinen <tomi.valkeinen@ideasonboard.com>
Signed-off-by: Sakari Ailus <sakari.ailus@linux.intel.com>
Signed-off-by: Hans Verkuil <hverkuil-cisco@xs4all.nl>
Documentation/userspace-api/media/v4l/vidioc-subdev-g-crop.rst
include/uapi/linux/v4l2-subdev.h