News for hackers. Stuff that matters.
Re:Linux kernel coding style by Trufa on Monday March 27, 2017 @08:48PM (#13973064)
Offtopic question, what documentation tool is used for this? I've seen it a lot of times but I'm not sure how to search for it. Thanks!
Re:Linux kernel coding style by geofft on Monday March 27, 2017 @08:53PM (#13973087)
It's made with Sphinx, a tool commonly used for Python documentation. But it can render reStructuredText that isn't associated with Python just as well, so it's popular for other projects. http://sphinx-doc.org/

(There's a link to Sphinx at the bottom of the page)

It looks like this is just generated from Documentation/index.rst and linked pages in the kernel source tree, which seems to have been created less than a year ago: https://github.com/torvalds/linux/commits/master/Documentati...

Re:Linux kernel coding style by mook on Monday March 27, 2017 @09:09PM (#13973154)
For background on the docs in the kernel source tree, LWN (as is often the case) had a good article about it: https://lwn.net/Articles/692704/

There's also a copy on kernel. org, not sure why Intel's copy is being linked here. It's probably the same text, so any copy should be equally good, it just feels less canonical to me. Probably silliness on my part for even thinking of it.

Re:Linux kernel coding style by geofft on Monday March 27, 2017 @09:28PM (#13973245)
Oh, hey, there's a rendered copy at https://www.kernel.org/doc/html/latest/process/coding-style.... , neat! (I knew about the unrendered one at /doc/Documentation)
Re:Linux kernel coding style by nowbacktowork on Monday March 27, 2017 @08:50PM (#13973074)
Sphinx, it's linked to in the footer.
Re:Linux kernel coding style by Trufa on Monday March 27, 2017 @09:00PM (#13973112)
Thanks, didn't see it!
Re:Linux kernel coding style by cyphar on Monday March 27, 2017 @08:59PM (#13973108)
At the bottom of the page:

> Built with Sphinx using a theme provided by Read the Docs.

John Corbert has done quite a bit recently within Documentation to make it more structured and has (from my understanding) massively revamped the documentation compilation.