[$] Kernel documentation with Sphinx, part 1: how we got here

The last time LWN looked at formatted kernel documentationin January, it seemed like the merging of AsciiDoc support for thekernel's structured source-code documentation ("kernel-doc") comments, wasimminent. As Jonathan Corbet, in the capacity of the kernel documentationmaintainer, wrote: "A good-enough solution that exists nowshould not be held up overly long in the hopes that vague ideas forsomething else might turn into real, working code." Sometimes,however, the threat that something not quite perfect might be mergedis enough to motivate people to turn those vague ideas into somethingreal.

Subscribers can click below to see the full story by guest author (and the developer behind most of the Sphinx work) Jani Nikula.