Re: [Doxygen-develop] documenting c-struct members

[Dimitri v. H. <di...@st...>]

On Fri, Sep 26, 2003 at 12:32:52PM +0200, Michael Daum wrote:
> Hi everybody,
> 
> here's a thread that I started on doxygen-users. Maybe I get an answer 
> to my questions below on doxygen-develop, hopefully.
> 
> 	Micha.
> 
> On Monday 22 September 2003 23:01, Dimitri van Heesch wrote:
> > On Mon, Sep 22, 2003 at 09:19:18AM +0200, Michael Daum wrote:
> > > is it possible to document c-struct members at another place? 
> > Probably the following:
> >
> > struct c_struct
> > {
> >   int field1;
> >   int field2;
> > };
> >
> > /*! \struct c_struct
> >     My struct
> >  */
> >
> > /*! \var c_struct::field1
> >     First field
> >  */
> >
> > /*! \var c_struct::field2
> >     Second field
> >  */
> >
> 
> Ah. 
> 
> But I don't get exactly what I wanted. The c_struct is part of a group 
> (of related structures). The \var docu then goes into the group docu
> (section Variables) and is marked 'inherited'. Actually I expected the 
> c_struct::field1 to be on the page documenting the c_struct. 

Me too. Are you sure only the c_struct is grouped? Or is the whole struct
with everything in it grouped? This probably depends on whether @ingroup 
is used (good) or if the whole struct is in a @defgroup .. @{  ... @} 
block (bad in this case). Please provide an example to make it easier to
discuss about the problem.

Regards,
  Dimitri