[libvirt] RFC version information in API docs

[Claudio Bley]

Hi.

Sometimes, it's a bit hard to determine when exactly a function, flag
or macro appeared in libvirt, ie. whether it will be supported on my
target machine having a specific version of libvirt or not.

So, I have created an enriched version of the API docs, using a XSL
stylesheet enumerating the libvirt?-api.xml files of all libvirt
releases.

For an example, you can have a look here:

http://avdv.github.io/libvirt/html/libvirt-libvirt.html#virVcpuState

Hovering over an enum value displays version information in a tooltip.

What do you think? Should this information be included by default in
the API docs?

If so, I could use a little help on how to integrate the generation of
this information into the automake process.

Basically, the XSL stylesheet enriches the generated libvirt-api.xml
with the current version given as a parameter to xsltproc plus version
information gathered from a previous enriched libvirt-api.xml file.

That way, every symbol/node() gets a since="..." version attribute.

So, during a build there's an extra step necessary when generating the
libvirt-api.xml file:

1. apibuild.py => libvirt-api.1.xml

2. (libvirt-api.1.xml + libvirt-api.0.xml) => XSLT => libvirt-api.xml

When releasing, libvirt-api.xml should be moved to
libvirt-api.0.xml. Alternatively, there could be a second XSL file
only extracting the version information without the boilerplate.

Claudio
-- 
AV-Test GmbH, Henricistraße 20, 04155 Leipzig, Germany
Phone: +49 341 265 310 19
Web:<http://www.av-test.org>

Eingetragen am / Registered at: Amtsgericht Stendal (HRB 114076)
Geschaeftsfuehrer (CEO): Andreas Marx, Guido Habicht, Maik Morgenstern