[PATCH 00/10] More splitting&documenting for drm_crtc.c

Daniel Vetter daniel.vetter at ffwll.ch
Wed Aug 31 16:09:03 UTC 2016


Hi all,

It's not entirely done yet, there's a few (very small bits) left in drm_crtc.c
which aren't for struct drm_crtc. But I figured it's better to keep things in
manageable pieces.

More important this now contains my proposal for how to best document (atomic)
property extensions. I grouped and documented both all properties related to
blending&positioning planes, and for color management. I think having separate
chapters, with lots more space for free-form prose (rst-formatted!), close to
the support functions for these properties is a much better than the massive CSV
we have right.

We could probably go even fancier (using some form of ascii-arts, where it makes
sense), but I think this here is a good baseline at least.

Comments and ideas highly welcome.

Thanks, Daniel

Daniel Vetter (10):
  drm: Move a few macros away from drm_crtc.h
  drm: Extract drm_bridge.h
  drm: Move all decl for drm_edid.c to drm_edid.h
  drm: Extract drm_plane.[hc]
  drm/doc: Polish for drm_plane.[hc]
  drm: Conslidate blending properties in drm_blend.[hc]
  drm/doc: Polish plane composition property docs
  drm: Extract drm_color_mgmt.[hc]
  drm/doc: Document color space handling
  drm: Remove dirty property from docs

 Documentation/gpu/drm-kms-helpers.rst |   10 +
 Documentation/gpu/drm-kms.rst         |   78 +-
 Documentation/gpu/kms-properties.csv  |   21 -
 drivers/gpu/drm/Makefile              |    3 +-
 drivers/gpu/drm/drm_blend.c           |  197 +++-
 drivers/gpu/drm/drm_bridge.c          |    5 +-
 drivers/gpu/drm/drm_color_mgmt.c      |  296 ++++++
 drivers/gpu/drm/drm_crtc.c            | 1618 +++++----------------------------
 drivers/gpu/drm/drm_crtc_internal.h   |   45 +-
 drivers/gpu/drm/drm_framebuffer.c     |   26 +
 drivers/gpu/drm/drm_plane.c           |  854 +++++++++++++++++
 include/drm/drm_atomic.h              |  154 ++++
 include/drm/drm_blend.h               |   59 ++
 include/drm/drm_bridge.h              |  218 +++++
 include/drm/drm_color_mgmt.h          |   61 ++
 include/drm/drm_connector.h           |   28 +-
 include/drm/drm_crtc.h                |  887 +-----------------
 include/drm/drm_edid.h                |   30 +
 include/drm/drm_encoder.h             |   22 +
 include/drm/drm_framebuffer.h         |   17 +
 include/drm/drm_mode_object.h         |    1 +
 include/drm/drm_modes.h               |    6 +
 include/drm/drm_plane.h               |  523 +++++++++++
 include/drm/drm_property.h            |    1 +
 24 files changed, 2759 insertions(+), 2401 deletions(-)
 create mode 100644 drivers/gpu/drm/drm_color_mgmt.c
 create mode 100644 drivers/gpu/drm/drm_plane.c
 create mode 100644 include/drm/drm_blend.h
 create mode 100644 include/drm/drm_bridge.h
 create mode 100644 include/drm/drm_color_mgmt.h
 create mode 100644 include/drm/drm_plane.h

-- 
2.9.3



More information about the dri-devel mailing list