[Libvir] request for libvirt documentation improvement

Richard W.M. Jones rjones at redhat.com
Thu Jun 28 13:38:52 UTC 2007


John Levon wrote:
> On Thu, Jun 28, 2007 at 09:23:19AM -0400, Daniel Veillard wrote:
> 
>> On Thu, Jun 28, 2007 at 01:45:36PM +0100, Richard W.M. Jones wrote:
>>> Daniel P. Berrange wrote:
>>>> It would still be useful to have a chart describing what APIs are 
>>>> implemented
>>>> by which driver though & any restrictions the impl may have.
>>> I'll have a go at this.
>>   Yes that would be useful thanks ! But I'm afraid it may be painful to
>> maintain too, as the various case may increase and the state of the
>> drivers/hypervisors will evolve.
> 
> This is why library documentation should *always* mention what version
> an API became supported/was added in. It's utterly miserable trying to
> use an evolving library otherwise :)

Point taken - I will try to add version numbers reflecting when 
operations became supported.

Rich.

-- 
Emerging Technologies, Red Hat - http://et.redhat.com/~rjones/
Registered Address: Red Hat UK Ltd, Amberley Place, 107-111 Peascod
Street, Windsor, Berkshire, SL4 1TE, United Kingdom.  Registered in
England and Wales under Company Registration No. 03798903
-------------- next part --------------
A non-text attachment was scrubbed...
Name: smime.p7s
Type: application/x-pkcs7-signature
Size: 3237 bytes
Desc: S/MIME Cryptographic Signature
URL: <http://listman.redhat.com/archives/libvir-list/attachments/20070628/53d450e7/attachment-0001.bin>


More information about the libvir-list mailing list