Mailing List Archive

[PATCH 0/4] docs/html/hcall: Hypercall docs headers
This is my proposed approach to providing hypercall documentation: we
provide an htmlified copy of the xen public headers, with a contents
page and cross-reference hyperlinks added.

This is done by a 350-line Perl script to which we can add features as
we think of them.

An example of the output can be found here:
http://www.chiark.greenend.org.uk/~ijackson/volatile/2011/xen/hcall/


_______________________________________________
Xen-devel mailing list
Xen-devel@lists.xensource.com
http://lists.xensource.com/xen-devel
Re: [PATCH 0/4] docs/html/hcall: Hypercall docs headers [ In reply to ]
On Sun, 2011-11-13 at 19:21 +0000, Ian Jackson wrote:
> This is my proposed approach to providing hypercall documentation: we
> provide an htmlified copy of the xen public headers, with a contents
> page and cross-reference hyperlinks added.
>
> This is done by a 350-line Perl script to which we can add features as
> we think of them.
>
> An example of the output can be found here:
> http://www.chiark.greenend.org.uk/~ijackson/volatile/2011/xen/hcall/

Excellent stuff.

It seems to consider
static struct xsd_errors xsd_errors[]
#if defined(__GNUC__)
__attribute__((unused))
as defining a function called __attribute__ which is a bit unfortunate!

I had some nitpicks as I looked over the patches but regardless I think
this is a good start and should go in. All:
Acked-by: Ian Campbell <ian.campbell@citrix.com>

Ian.



_______________________________________________
Xen-devel mailing list
Xen-devel@lists.xensource.com
http://lists.xensource.com/xen-devel
Re: [PATCH 0/4] docs/html/hcall: Hypercall docs headers [ In reply to ]
Ian Campbell writes ("Re: [Xen-devel] [PATCH 0/4] docs/html/hcall: Hypercall doc> Excellent stuff.

Glad you like it.

> It seems to consider
> static struct xsd_errors xsd_errors[]
> #if defined(__GNUC__)
> __attribute__((unused))
> as defining a function called __attribute__ which is a bit unfortunate!

I can fix that easily enough by special-casing keywords.

> I had some nitpicks as I looked over the patches but regardless I think
> this is a good start and should go in. All:
> Acked-by: Ian Campbell <ian.campbell@citrix.com>

Thanks.

Ian.

_______________________________________________
Xen-devel mailing list
Xen-devel@lists.xensource.com
http://lists.xensource.com/xen-devel