[v2,media] Feature removal: V4L2 selections API target and flag definitions
Commit Message
Signed-off-by: Sylwester Nawrocki <sylvester.nawrocki@gmail.com>
---
Added more precise description of what is being removed.
---
Documentation/feature-removal-schedule.txt | 18 ++++++++++++++++++
1 files changed, 18 insertions(+), 0 deletions(-)
--
1.7.4.1
--
To unsubscribe from this list: send the line "unsubscribe linux-media" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
Comments
On Mon, Jun 25, 2012 at 09:14:41PM +0200, Sylwester Nawrocki wrote:
> Signed-off-by: Sylwester Nawrocki <sylvester.nawrocki@gmail.com>
> ---
> Added more precise description of what is being removed.
> ---
> Documentation/feature-removal-schedule.txt | 18 ++++++++++++++++++
> 1 files changed, 18 insertions(+), 0 deletions(-)
>
> diff --git a/Documentation/feature-removal-schedule.txt b/Documentation/feature-removal-schedule.txt
> index 09701af..b998030 100644
> --- a/Documentation/feature-removal-schedule.txt
> +++ b/Documentation/feature-removal-schedule.txt
> @@ -558,3 +558,21 @@ Why: The V4L2_CID_VCENTER, V4L2_CID_HCENTER controls have been deprecated
> There are newer controls (V4L2_CID_PAN*, V4L2_CID_TILT*) that provide
> similar functionality.
> Who: Sylwester Nawrocki <sylvester.nawrocki@gmail.com>
> +
> +----------------------------
> +
> +What: V4L2 selections API target rectangle and flags unification, the
> + following definitions will be removed: V4L2_SEL_TGT_CROP_ACTIVE,
> + V4L2_SEL_TGT_COMPOSE_ACTIVE, V4L2_SUBDEV_SEL_*, V4L2_SUBDEV_SEL_FLAG_*
> + in favor of common V4L2_SEL_TGT_* and V4L2_SEL_FLAG_* definitions.
> + For more details see include/linux/v4l2-common.h.
> +When: 3.8
> +Why: The regular V4L2 selections and the subdev selection API originally
> + defined distinct names for the target rectangles and flags - V4L2_SEL_*
> + and V4L2_SUBDEV_SEL_*. Although, it turned out that the meaning of these
> + target rectangles is virtually identical and the APIs were consolidated
> + to use single set of names - V4L2_SEL_*. This didn't involve any ABI
> + changes. Alias definitions were created for the original ones to avoid
> + any instabilities in the user space interface. After few cycles these
> + backward compatibility definitions will be removed.
> +Who: Sylwester Nawrocki <sylvester.nawrocki@gmail.com>
Thanks, Sylwester!
I've added this to my patchset.
Cheers,
@@ -558,3 +558,21 @@ Why: The V4L2_CID_VCENTER, V4L2_CID_HCENTER controls have been deprecated
There are newer controls (V4L2_CID_PAN*, V4L2_CID_TILT*) that provide
similar functionality.
Who: Sylwester Nawrocki <sylvester.nawrocki@gmail.com>
+
+----------------------------
+
+What: V4L2 selections API target rectangle and flags unification, the
+ following definitions will be removed: V4L2_SEL_TGT_CROP_ACTIVE,
+ V4L2_SEL_TGT_COMPOSE_ACTIVE, V4L2_SUBDEV_SEL_*, V4L2_SUBDEV_SEL_FLAG_*
+ in favor of common V4L2_SEL_TGT_* and V4L2_SEL_FLAG_* definitions.
+ For more details see include/linux/v4l2-common.h.
+When: 3.8
+Why: The regular V4L2 selections and the subdev selection API originally
+ defined distinct names for the target rectangles and flags - V4L2_SEL_*
+ and V4L2_SUBDEV_SEL_*. Although, it turned out that the meaning of these
+ target rectangles is virtually identical and the APIs were consolidated
+ to use single set of names - V4L2_SEL_*. This didn't involve any ABI
+ changes. Alias definitions were created for the original ones to avoid
+ any instabilities in the user space interface. After few cycles these
+ backward compatibility definitions will be removed.
+Who: Sylwester Nawrocki <sylvester.nawrocki@gmail.com>