Re: [PATCH 3/3] docs/doxygen: doxygen documentation for grant_table.h

[Luca Fancellu]

> On 7 Apr 2021, at 14:13, Julien Grall <jul...@xen.org> wrote:
> 
> Hi,
> 
> On 06/04/2021 11:36, Luca Fancellu wrote:
>> Modification to include/public/grant_table.h:
>> 1) Change anonymous structure to be named structure,
>>    because doxygen can't deal with them.
> 
> What do you mean by can't deal with them? I had a quick try with doxygen 
> build and couldn't find any failure (although I haven't looked at the output).
> 

Hi Julien,

The problem is that Doxygen can’t generate proper documentation for anonymous 
union/structure, it ends up with warning and/or producing wrong documentation 
like
changing names or giving field description to the wrong field.

Cheers,
Luca

> Cheers,
> 
> -- 
> Julien Grall