[PATCH v1 12/22] docs: driver-api: add .rst files from the main dir

Jonathan Corbet corbet at lwn.net
Wed Jun 19 14:13:53 UTC 2019


On Wed, 19 Jun 2019 12:42:39 +0200
Peter Zijlstra <peterz at infradead.org> wrote:

> No, the other way around, Sphinx can recognize local files and treat
> them special. That way we keep the text readable.
> 
> Same with that :c:func:'foo' crap, that needs to die, and Sphinx needs
> to be taught about foo().

I did a patch to make that latter part happen, but haven't been able to
find the time to address the comments and get it out there.  It definitely
cleaned up the source files a lot and is worth doing.  Will try to get
back to it soon.

The local file links should be easy to do; we shouldn't need to add any
markup for those.

jon


More information about the dri-devel mailing list