[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]

Re: [Libvir] PATCH: 1/7 Split up the public header files



On Mon, Oct 29, 2007 at 03:56:18AM +0000, Daniel P. Berrange wrote:
> This patch splits up the libvirt.h file into multiple pieces. The big header
> file was getting rather long & hard to follow, with API calls for domains and
> networks all mixed together, and macros & typedefs & methods all mixed up.
> Adding another 25 APIs for storage won't improve this. So this splits up the 
> header into
> 
>    libvirt/connection.h    - connection related API calls & objects
>    libvirt/node.h          - host node information APIs  & objects
>    libvirt/domain.h        - hypervisor/domain API calls & objects
>    libvirt/network.h       - virtual networking API calls & objects
> 
> The original libvirt.h, now simply #include's all four of these files. The
> header files aren't intended to be included directly - apps carry on just
> using the main header file.

  The main impact is not covered by this patch, it's the documentation
generation, which also mean that on the web site the doc page for libvirt 
would become nearly empty and 4 new pages would be added. 
  I'm not against the change (though it will break all previous reference
to documentation functions embedded in list archives) but the documentation
impact seems to not have been considered and it's not neglectible, really.

Daniel

-- 
Red Hat Virtualization group http://redhat.com/virtualization/
Daniel Veillard      | virtualization library  http://libvirt.org/
veillard redhat com  | libxml GNOME XML XSLT toolkit  http://xmlsoft.org/
http://veillard.com/ | Rpmfind RPM search engine  http://rpmfind.net/


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]