Lyude Paul wrote a nice intro to vblank in the following mail: https://lore.kernel.org/dri-devel/faf63d8a9ed23c16af69762f59d0dca6b2bf085f.c...
Reading this I managed to spot a glimmer of hope that I one day would understand some of the fuzz around vblank. To let others benefit from the description I went ahead and added the description to drm_vblank.c.
Lyude - I added a "Co-developed-by: ..." Can I get your s-o-b on the patch, to document that you are OK with this to go in.
When checking the output with "make htmldocs" I noticed several drm related warnings. I went ahead a fixed most of them resulting in a few extre patches.
There are some warnings in amdgpu land - I have left them for the AMD people to figure out: amdgpu_vm.c:92: warning: Function parameter or member 'vm' not described in 'amdgpu_vm_eviction_lock' amdgpu_xgmi.c:1: warning: no structured comments found amdgpu_ras.c:1: warning: no structured comments found amdgpu_dm.h:305: warning: Function parameter or member 'hdcp_workqueue' not described in 'amdgpu_display_manager'
Sam
Sam Ravnborg (6): drm/vblank: Add intro to documentation drm/fb: fix kernel-doc in drm_framebuffer.h drm/sched: fix kernel-doc in gpu_scheduler.h drm: writeback: document callbacks drm/dp_mst: add kernel-doc for drm_dp_mst_port.fec_capable drm/bridge: fix kernel-doc warning in panel.c
drivers/gpu/drm/bridge/panel.c | 1 + drivers/gpu/drm/drm_vblank.c | 15 +++++++++++++++ include/drm/drm_dp_mst_helper.h | 4 ++++ include/drm/drm_framebuffer.h | 4 ++-- include/drm/drm_modeset_helper_vtables.h | 31 +++++++++++++++++++++++++++++++ include/drm/gpu_scheduler.h | 1 + 6 files changed, 54 insertions(+), 2 deletions(-)