[PATCH 1/2] drm: Document drm_cache interface

[Daniel Vetter]

On Wed, Jan 04, 2017 at 09:39:48AM +0000, Chris Wilson wrote:
> On Wed, Jan 04, 2017 at 10:01:37AM +0100, Daniel Vetter wrote:
> > On Mon, Jan 02, 2017 at 03:17:05PM -0200, Gabriel Krisman Bertazi wrote:
> > > Signed-off-by: Gabriel Krisman Bertazi <krisman at collabora.co.uk>
> > > ---
> > >  drivers/gpu/drm/drm_cache.c | 23 +++++++++++++++++++++++
> > 
> > When adding docs, please also add a kernel-doc stanza (good place would be
> > a new chapter in Documentation/gpu/drm-mm.rst I think) to pull it all in.
> > Otherwise it's not built, which means not checked by 0day, which means
> > will get out of data. Also, you can't find it when browsing the html docs
> > ;-)
> 
> How close are we to having the spine of the kernelbook described in
> Documentation/ and the indiviual chapter.rst next to the source in
> drivers/gpu/drm/ etc? Something like:
> 	Documentation/gpu/drm.rst: include drivers/gpu/drm/*.rst ?

Hm, not sure we ever discussed this ... Adding linux-doc. But pre-coffee,
sounds like an intriguing idea at least.
-Daniel
-- 
Daniel Vetter
Software Engineer, Intel Corporation
http://blog.ffwll.ch