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. Jani, want to join us at LCA and talk about it? :) jon _______________________________________________ Intel-gfx mailing list Intel-gfx@xxxxxxxxxxxxxxxxxxxxx http://lists.freedesktop.org/mailman/listinfo/intel-gfx
