[PATCH 00/19] DRM developer's guide polish, part 1

Daniel Vetter daniel.vetter at ffwll.ch
Thu Jan 23 00:52:25 PST 2014


Hi all,

So I've finally gotten around to honor my promise for some nice drm_mm.c
documentation and got slightly sidetracked. I have more cleanups in my queue
(mostly to better document the modesetting functions and polish the kerneldoc
reference sections a bit) but David Herrmann suggested that reviewing smaller
doc patch piles is easier. So here we go.

The meat of this is documenting drm_mm.c and added kerneldoc for drm_prime.c,
with a few adjacent things I've stumbled over. I'm also trying to clarify the
overall DocBook a bit by emphasising more what's core code, which parts are just
helper functions and how it precisely ties together (e.g. both prime and dumb
buffers only assume that the buffer managers has uint32_t handles, nothing else
really).

Comments, flames and review highly welcome.

Cheers, Daniel

Daniel Vetter (19):
  drm/doc: Clarify the dumb object interfaces
  drm/doc: Fix up kerneldoc in drm_edid.c
  drm/doc: Clean up and integrate kerneldoc for drm_gem.c
  drm/doc: Remove <term> from rendernode docs
  drm/doc: Reorganize driver documentation
  drm/doc: Move the vma offset manager to the right spot
  drm/doc: Remove the "command submissin and fencing" section
  drm/doc: No more drm perf counters
  drm/doc: Document drm_helper_resume_force_mode
  drm/doc: Hide legacy horrors better
  drm/docs: Include hdmi infoframe helper reference
  drm/doc: Clarify PRIME documentation
  drm/doc: Add PRIME function references
  drm/doc: Update copyright
  drm/mm: Remove MM_UNUSED_TARGET
  drm/doc: Overview documentation for drm_mm.c
  drm/doc: Add fucntion reference documentation for drm_mm.c
  drm/kms: rip out drm_mode_connector_detach_encoder
  drm/kms: don't export drm_mode_group_init_legacy_group

 Documentation/DocBook/drm.tmpl             | 484 +++++++++++++++++++----------
 drivers/gpu/drm/drm_crtc.c                 |  16 -
 drivers/gpu/drm/drm_crtc_helper.c          |   9 +
 drivers/gpu/drm/drm_edid.c                 |  26 +-
 drivers/gpu/drm/drm_gem.c                  |  63 +++-
 drivers/gpu/drm/drm_mm.c                   | 211 +++++++++++--
 drivers/gpu/drm/drm_prime.c                | 110 +++++--
 drivers/staging/imx-drm/imx-ldb.c          |   2 -
 drivers/staging/imx-drm/parallel-display.c |   2 -
 include/drm/drm_crtc.h                     |   2 -
 include/drm/drm_mm.h                       | 154 +++++++--
 include/linux/hdmi.h                       |  12 +
 12 files changed, 815 insertions(+), 276 deletions(-)

-- 
1.8.5.2



More information about the dri-devel mailing list