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

Re: [Xen-devel] [PATCH 01 of 32 RFC] libxl: remove comment support from IDL

On Mon, 2012-01-16 at 16:23 +0000, Ian Jackson wrote:
> Ian Campbell writes ("[Xen-devel] [PATCH 01 of 32 RFC] libxl: remove comment 
> support from IDL"):
> > libxl: remove comment support from IDL
> I'm not entirely convinced by this, or at least not yet.
> Are we going to eventually have an automatic docs generator and find
> that this "literate" style (if I may grossly stretch the term) is what
> we wanted ?

I honestly don't know.

I guess in some sense this new scheme is no different in this respect to
any other source file which we might want to extract docs from?

> I guess the current syntax is not really suitable for going for a
> literate style in the idl.

It is pretty limited/limiting.


Xen-devel mailing list



Lists.xenproject.org is hosted with RackSpace, monitoring our
servers 24x7x365 and backed by RackSpace's Fanatical Support®.