Hi all,
So here's finally my promised doc update for atomic, with massive amounts of kerneldoc in the new in-line style for all the vfunc hooks we have in the KMS code (so yeah also all the legacy hooks are documented). This also merges in anything from Laurent's original docbook docs, where it wasn't outdated by atomic.
Of course there's still lots left to do with docs ;-)
Comments, review and feeback highly welcome!
Cheers, Daniel
Daniel Vetter (28): drm: Polish fbdev helper struct docs drm: Move LEAVE/ENTER_ATOMIC_MODESET to fbdev helpers drm: Reorganize helper vtables and their docs drm: Make helper vtable pointers type-safe drm: Merge helper docbook into kerneldoc comments drm/bridge: Improve kerneldoc drm: Update drm_plane_funcs kerneldoc drm/noveau: Ditch NULL save/restore hook assignments drm/qxl: Drop dummy save/restore hooks drm/virtio: Drop dummy save/restore functions drm/vmwgfx: Drop dummy save/restore hooks drm/gma500: Move to private save/restore hooks drm/nouveau: Use private save/restore hooks drm: Remove crtc/connector->save/restore hooks drm: Move encoder->save/restore into nouveau drm: Document drm_atomic_*_get_property drm: Document drm_connector_funcs drm: connector->dpms is not optional drm: document drm_crtc_funcs drm: Add kerneldoc for drm_framebuffer_funcs drm: Kerneldoc for drm_mode_config_funcs drm/atomic-helper: Reject attempts at re-stealing encoders drm: Document drm_plane_helper_funcs drm: Document drm_connector_helper_funcs drm/atomic-helper: Mention the new system/resume helpers the docs drm: Move drm_display_mode an related docs into kerneldoc drm: Document drm_encoder/crtc_helper_funcs drm/atomic-helper: Reject legacy flips on a disabled pipe
Documentation/DocBook/gpu.tmpl | 500 +----------- drivers/gpu/drm/drm_atomic.c | 42 +- drivers/gpu/drm/drm_atomic_helper.c | 48 ++ drivers/gpu/drm/drm_bridge.c | 69 +- drivers/gpu/drm/drm_crtc.c | 4 +- drivers/gpu/drm/drm_crtc_helper.c | 52 +- drivers/gpu/drm/drm_modes.c | 3 +- drivers/gpu/drm/drm_plane_helper.c | 4 + drivers/gpu/drm/drm_probe_helper.c | 30 +- drivers/gpu/drm/gma500/cdv_device.c | 2 + drivers/gpu/drm/gma500/cdv_intel_display.c | 2 - drivers/gpu/drm/gma500/cdv_intel_hdmi.c | 5 +- drivers/gpu/drm/gma500/cdv_intel_lvds.c | 4 +- drivers/gpu/drm/gma500/mdfld_device.c | 2 + drivers/gpu/drm/gma500/mdfld_dsi_output.c | 5 +- drivers/gpu/drm/gma500/oaktrail_device.c | 2 + drivers/gpu/drm/gma500/psb_device.c | 22 +- drivers/gpu/drm/gma500/psb_drv.h | 2 + drivers/gpu/drm/gma500/psb_intel_display.c | 2 - drivers/gpu/drm/gma500/psb_intel_drv.h | 3 + drivers/gpu/drm/gma500/psb_intel_lvds.c | 5 +- drivers/gpu/drm/gma500/psb_intel_sdvo.c | 5 +- drivers/gpu/drm/nouveau/dispnv04/crtc.c | 5 +- drivers/gpu/drm/nouveau/dispnv04/dac.c | 7 +- drivers/gpu/drm/nouveau/dispnv04/dfp.c | 7 +- drivers/gpu/drm/nouveau/dispnv04/disp.c | 43 +- drivers/gpu/drm/nouveau/dispnv04/tvnv04.c | 5 +- drivers/gpu/drm/nouveau/dispnv04/tvnv17.c | 5 +- drivers/gpu/drm/nouveau/nouveau_connector.c | 6 - drivers/gpu/drm/nouveau/nouveau_crtc.h | 3 + drivers/gpu/drm/nouveau/nouveau_encoder.h | 3 + drivers/gpu/drm/nouveau/nv50_display.c | 1 + drivers/gpu/drm/qxl/qxl_display.c | 12 - drivers/gpu/drm/virtio/virtgpu_display.c | 12 - drivers/gpu/drm/vmwgfx/vmwgfx_kms.c | 16 - drivers/gpu/drm/vmwgfx/vmwgfx_ldu.c | 4 - drivers/gpu/drm/vmwgfx/vmwgfx_scrn.c | 6 - drivers/gpu/drm/vmwgfx/vmwgfx_stdu.c | 4 - include/drm/drm_crtc.h | 1157 ++++++++++++++++++++++++--- include/drm/drm_crtc_helper.h | 161 +--- include/drm/drm_fb_helper.h | 97 ++- include/drm/drm_modes.h | 342 ++++++-- include/drm/drm_modeset_helper_vtables.h | 884 ++++++++++++++++++++ include/drm/drm_plane_helper.h | 38 +- 44 files changed, 2600 insertions(+), 1031 deletions(-) create mode 100644 include/drm/drm_modeset_helper_vtables.h