On Tue, May 13, 2014 at 1:02 PM, Laurent Pinchart laurent.pinchart@ideasonboard.com wrote:
Also eventually I want to pull these tables directly out of source code comments - everything else tends to never get updated when the code changes.
On the subject of moving documentation from docbook to source code, do your kerneldoc extensions plans include supporting images ? A drawing is worth a thousand words (see http://linuxtv.org/downloads/v4l-dvb-apis/subdev.html#subdev-image-processin... for instance), and that's currently a pretty important feature of the docbook format.
That looks great I think I'll get a bit of doc envy ;-)
I don't think there's any reasonable way to generate such figures from comments, maybe for simple ones some ascii art might work out. But converting that to svg for the docbook seems to be an unsovled problem (I've only found some hacks), so I think we need to manually pull those into the docbook still. But excellent point for consideration. -Daniel