Re: [Xen-devel] [PATCH v2 0/15+5+5] Begin to disentangle libxenctrl and provide some stable libraries

[Andrew Cooper <andrew.cooper3@xxxxxxxxxx>]

On 22/07/15 12:12, Ian Campbell wrote:
>
>> FWIW, also splitting xl and libxl into different directories.
> Yes, good idea (also "eventually ;-)").
>
> While I'm accumulating TODO items in this thread, every library which
> gets split out needs a careful review before it should be declared
> A[PBI] stable. I'm thinking at least:
>
>       * Consistent error handling (return -1 + setting errno=EFOO)
>       * Correct types
>       * Const correctness
>       * General interface sanity check
>
> Anything else?

If we are filling even more copious free time,

* Thoughts about documentation in the header files.

I think a suitably-configured doxygen ought to suffice for this.  (I
feel like I am nominating myself to try and get this sorted in a
satisfactory fashon.)

~Andrew

_______________________________________________
Xen-devel mailing list
Xen-devel@xxxxxxxxxxxxx
http://lists.xen.org/xen-devel