drm: Add device registration documentation
authorThierry Reding <treding@nvidia.com>
Mon, 19 May 2014 11:39:07 +0000 (13:39 +0200)
committerThierry Reding <treding@nvidia.com>
Thu, 5 Jun 2014 21:14:38 +0000 (23:14 +0200)
commitc6a1af8a1621913e2658eaff419bab7028b2c42c
tree2f50b904d0eed18320c56d81e0338a789fcd8708
parentca8e2ad71013049bc88a10b11d83712bfe56cdd4
drm: Add device registration documentation

Describe how devices are registered using the drm_*_init() functions.
Adding this to docbook requires a largish set of changes to the comments
in drm_{pci,usb,platform}.c since they are doxygen-style rather than
proper kernel-doc and therefore mess with the docbook generation.

While at it, mark usage of drm_put_dev() as discouraged in favour of
calling drm_dev_unregister() and drm_dev_unref() directly.

Acked-by: Daniel Vetter <daniel.vetter@ffwll.ch>
Signed-off-by: Thierry Reding <treding@nvidia.com>
Documentation/DocBook/drm.tmpl
drivers/gpu/drm/drm_pci.c
drivers/gpu/drm/drm_platform.c
drivers/gpu/drm/drm_stub.c
drivers/gpu/drm/drm_usb.c