[Intel-gfx] [PATCH 00/28] kerneldoc for display vtables

[Daniel Vetter]

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

-- 
2.5.1