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(-)