Re: Documentation: add Kernel Driver Statement to the kernel

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On Sat, Oct 14, 2017 at 06:14:13PM +0200, Wolfram Sang wrote:
> On Fri, Oct 06, 2017 at 11:10:38AM +0200, gregkh@xxxxxxxxxxxxxxxxxxx wrote:
> > Way back in 2008 we didn't have "robust" in-kernel documentation system,
> > so the idea of putting something like the kernel driver statement in the
> > kernel tree wasn't even imagined.  But now that has changed, so add the
> > old document to the kernel source itself to allow for us to properly
> > reference it in one canonical place (as the LF wiki keeps moving things
> > around.)
> 
> Cool, I like it much to see it added to the kernel tree.
> 
> But could you explain what "robust" means in this context?

We did not have a way to easily turn the files in Documentation/ into
html and pdf docs like we now do.  The documentation is now
auto-generated and placed up on kernel.org here:
	https://www.kernel.org/doc/html/

> And what has changed which makes it "robust"? Sphinx?

Yes, remember the mess we had before?

Not that sphinx doesn't have it's own issues, but you have to admit it
is much better now than it used to be, right?

thanks,

greg k-h
--
To unsubscribe from this list: send the line "unsubscribe linux-doc" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html



[Index of Archives]     [Kernel Newbies]     [Security]     [Netfilter]     [Bugtraq]     [Linux FS]     [Yosemite Forum]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Samba]     [Video 4 Linux]     [Device Mapper]     [Linux Resources]

  Powered by Linux