Commit 1c20d8b8 authored by Maxime Ripard's avatar Maxime Ripard

drm/atomic: Move the drm_atomic_state field doc inline

Some fields of drm_atomic_state have been documented in-line, but some
were documented in the main kerneldoc block before the structure.

Since the former is the preferred option in DRM, let's move all the
fields to an inline documentation.
Acked-by: default avatarSui Jingfeng <sui.jingfeng@linux.dev>
Link: https://lore.kernel.org/r/20231214100917.277842-1-mripard@kernel.orgSigned-off-by: default avatarMaxime Ripard <mripard@kernel.org>
parent 0f7c2462
......@@ -347,24 +347,22 @@ struct __drm_private_objs_state {
/**
* struct drm_atomic_state - the global state object for atomic updates
* @ref: count of all references to this state (will not be freed until zero)
* @dev: parent DRM device
* @async_update: hint for asynchronous plane update
* @planes: pointer to array of structures with per-plane data
* @crtcs: pointer to array of CRTC pointers
* @num_connector: size of the @connectors and @connector_states arrays
* @connectors: pointer to array of structures with per-connector data
* @num_private_objs: size of the @private_objs array
* @private_objs: pointer to array of private object pointers
* @acquire_ctx: acquire context for this atomic modeset state update
*
* States are added to an atomic update by calling drm_atomic_get_crtc_state(),
* drm_atomic_get_plane_state(), drm_atomic_get_connector_state(), or for
* private state structures, drm_atomic_get_private_obj_state().
*/
struct drm_atomic_state {
/**
* @ref:
*
* Count of all references to this update (will not be freed until zero).
*/
struct kref ref;
/**
* @dev: Parent DRM Device.
*/
struct drm_device *dev;
/**
......@@ -388,7 +386,12 @@ struct drm_atomic_state {
* flag are not allowed.
*/
bool legacy_cursor_update : 1;
/**
* @async_update: hint for asynchronous plane update
*/
bool async_update : 1;
/**
* @duplicated:
*
......@@ -398,13 +401,40 @@ struct drm_atomic_state {
* states.
*/
bool duplicated : 1;
/**
* @planes: pointer to array of structures with per-plane data
*/
struct __drm_planes_state *planes;
/**
* @crtcs: pointer to array of CRTC pointers
*/
struct __drm_crtcs_state *crtcs;
/**
* @num_connector: size of the @connectors and @connector_states arrays
*/
int num_connector;
/**
* @connectors: pointer to array of structures with per-connector data
*/
struct __drm_connnectors_state *connectors;
/**
* @num_private_objs: size of the @private_objs array
*/
int num_private_objs;
/**
* @private_objs: pointer to array of private object pointers
*/
struct __drm_private_objs_state *private_objs;
/**
* @acquire_ctx: acquire context for this atomic modeset state update
*/
struct drm_modeset_acquire_ctx *acquire_ctx;
/**
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment