Re: [Ksummit-discuss] [CORE-TOPIC] Documentation

["Peter Hüwe" <PeterHuewe@gmx.de>]

Am Montag, 13. Juli 2015, 19:45:09 schrieb Jonathan Corbet:
> On Mon, 13 Jul 2015 12:47:23 +0300
> 
> Alexey Dobriyan <adobriyan@gmail.com> wrote:
> > I have counter suggestion:
> > * remove kernel-doc official status, remove generating scripts
> > 
> >   because it doesn't work,
> 
> kerneldoc does work, after a fashion.  It works well enough that people
> use it, and I hear about it quickly when somebody's comment change breaks
> the docs build.  I don't think we can remove it in the absence of
> something better.
Jonathan, do you keep an up-to-date copy of the generated files somewhere?
(I cannot get it to work out of the box on my machine)

> Creating "something better" is actually on my list of things to do.  The
> only problem is that I've had to buy a second 4TB drive to hold that list,
> so I don't know when I'll have time to think about it.
Where do you think are the major issues from your point of view? 

Would doxygen be "something better"? The kernel-doc style looks already quite 
similar.
Maybe the kernel should not reinvent everything :)




Thanks,
Peter