On Thu, 14 Jan 2016, Jonathan Corbet <corbet@xxxxxxx> wrote: > On Thu, 14 Jan 2016 22:03:26 +0200 > Jani Nikula <jani.nikula@xxxxxxxxxxxxxxx> 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. -- Jani Nikula, Intel Open Source Technology Center _______________________________________________ dri-devel mailing list dri-devel@xxxxxxxxxxxxxxxxxxxxx http://lists.freedesktop.org/mailman/listinfo/dri-devel
