On Thu, 14 Jan 2016, Jonathan Corbet corbet@lwn.net wrote:
On Thu, 14 Jan 2016 22:03:26 +0200 Jani Nikula jani.nikula@linux.intel.com wrote:
What if we added support for some markup language as an alternative to DocBook for the high level documentation? What if we taught kernel-doc to output said markup natively, and included those generated pieces into the high level documentation using the markup's own include directives? At least AsciiDoc and reStructuredText support this.
That is kind of what I've been thinking. I think we could dispense with docbook entirely, simplifying the toolchain and making the template files easier to read and edit. Something like that would also make it easy to keep the regular .txt documents in a structured form and to integrate them into the "formatted" documents if it makes sense.
Thanks, this is enough encouragement that maybe I'll toy around with this a little more in my, uh, copious free time.
Jani, want to join us at LCA and talk about it? :)
Heh, sure I'd *want* to...
BR, Jani.