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

Jonathan Corbet
2019-06-19T14:14:01Z

On Wed, 19 Jun 2019 12:42:39 +0200
Peter Zijlstra <peterz@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