[PATCH 00/10] Start documenting the radeon drm better

alexdeucher at gmail.com alexdeucher at gmail.com
Fri Jun 29 07:28:20 PDT 2012

From: Alex Deucher <alexander.deucher at amd.com>

This is something I've been wanting to do for a while and
I finally spent a little time getting a start on it.  There
is still a lot to do and not all of my descriptions are great,
but I think we can document the rest in bits and pieces. I
also added a note about what asics the function is applicable
to. I tried to start with the more common and complex code.
I was thinking it would make sense to have an informal
documentation policy something like the following:
1. If you edit an undocumented function, add documentation
2. If you edit a documented function and change how it works,
   update the documentation
3. All new functions added should be documented

Fulfulling all of these for stable fixes could pose problems
so obviously there is some leeway.


Alex Deucher (10):
  drm/radeon: document radeon_device.c
  drm/radeon: document radeon_kms.c
  drm/radeon: document radeon_irq_kms.c
  drm/radeon: document radeon_asic.c
  drm/radeon: document radeon_fence.c
  drm/radeon: document radeon_ring.c
  drm/radeon: document non-VM functions in radeon_gart.c
  drm/radeon: document VM functions in radeon_gart.c
  drm/radeon: start to document the functions r100.c
  drm/radeon: start to document evergreen.c

 drivers/gpu/drm/radeon/evergreen.c      |  120 ++++++++++
 drivers/gpu/drm/radeon/r100.c           |  127 ++++++++++-
 drivers/gpu/drm/radeon/radeon_asic.c    |   46 ++++
 drivers/gpu/drm/radeon/radeon_device.c  |  344 +++++++++++++++++++++++++++-
 drivers/gpu/drm/radeon/radeon_fence.c   |  373 +++++++++++++++++++++++++++++
 drivers/gpu/drm/radeon/radeon_gart.c    |  391 ++++++++++++++++++++++++++++++-
 drivers/gpu/drm/radeon/radeon_irq_kms.c |  150 ++++++++++++
 drivers/gpu/drm/radeon/radeon_kms.c     |  126 ++++++++++
 drivers/gpu/drm/radeon/radeon_ring.c    |  374 +++++++++++++++++++++++++++++-
 9 files changed, 2041 insertions(+), 10 deletions(-)


More information about the dri-devel mailing list