This patch is to emphasize how userspace should use the plane format list and the IN_FORMATS blob. The plane format list contains the formats that do not require modifiers, and the blob property has the formats that support modifiers.
Note that these are not disjoint sets. If a format supports modifiers but the driver can also handle it without a modifier, it should be present in both the IN_FORMATS blob property and the plane format list.
This is important for userspace, as there are situations in which we need to find out if the KMS driver can handle a certain format without any modifiers.
Leandro Ribeiro (2): drm/doc: document drm_mode_get_plane drm/doc: emphasize difference between plane formats and IN_FORMATS blob
drivers/gpu/drm/drm_plane.c | 4 ++++ include/uapi/drm/drm_mode.h | 22 ++++++++++++++++++++++ 2 files changed, 26 insertions(+)