On Thu, 19 Jun 2008 15:13:51 -0700
Jesse Barnes <[EMAIL PROTECTED]> wrote:

> In a shameless attempt to capitalize on the recent enthusiasm for documenting 
> things, I've put together a skeletal DRM developer guide.

Yay! \o/

> The attached PDF was generated from the attached DocBook template, and 
> references Linux kernel doc comments in the sources.  Unfortunately, the 
> current DRM has a mix of Linux kernel doc and doxygen documentation, and only 
> some of the very recent stuff is actually accurate and usable.

Btw. which should be used in DRM, Linux kernel doc or doxygen? Without the
bsd directory the answer would be obvious to me.

> Any thoughts?

I have only a couple minor comments as a newbie.

Driver initialization:
- talks about struct drm_device, then the example has struct drm_driver.
Is there a difference?
- proper indenting of sample code missing, makes the drm_driver example
a bit awkward to read.

VBlank event handling:
- the last paragraph "...vblank functions into no-ops." seems
contradicting the previous paragraph.


I'm very much looking forward to the next revision with more
goodies. :-)

-- 
Pekka Paalanen
http://www.iki.fi/pq/

-------------------------------------------------------------------------
Check out the new SourceForge.net Marketplace.
It's the best place to buy or sell services for
just about anything Open Source.
http://sourceforge.net/services/buy/index.php
--
_______________________________________________
Dri-devel mailing list
Dri-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/dri-devel

Reply via email to