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

[Ian Jackson <iwj@xxxxxxxxxxxxxx>]

Bertrand Marquis writes ("Re: [PATCH 3/3] docs/doxygen: doxygen documentation 
for grant_table.h"):
> Somehow in the documentation when you have a union you will need to document 
> that it is a union and the possible entries.

I would expect to find the documentation for an anonymous struct or
union folded into the documentation of the containing structure, just
as it is in the source.

> One way or an other most standards like MISRA are forbidding anonymous 
> entries as they cannot be referred to.

An anonymous union or struct like this is always the type of a single
field in a containing aggegate type.  So if one needs to speak of it,
one can specify the container's type and the field.  So it *can* be
named.

I am assuming we don't have *unused* anonymous structs and unions.

Ian.