Re: [Doxygen-users] references to nested structure members

[Dimitri v. H. <do...@gm...>]

The references should follow the structure as it is defined, i.e. 
struct inner is not defined inside struct outer, so you
cannot refer to its members via the outer struct, you have to refer to them directly via inner struct.

If you actually nest the structures you can refer to then via their nesting scope, i.e.:

/// - \ref outer
/// - \ref outer::outer_member1
/// - \ref outer::inner_tag::inner_member

/// struct outer doc
struct outer_tag
{
  /// struct inner doc
  struct inner_tag
  {
    /// inner_member doc
    int inner_member;
  } outer_member1; ///< outer member
};

/// typedef outer struct
typedef struct outer_tag outer;

Regards,
  Dimitri


> On 24 Oct 2016, at 23:24 , chrisroelle <cr...@ee...> wrote:
> 
> Hi -
> 
> First, my apologies if this is a silly or previously-answered question -
> I've googled and read the manuals but am still having trouble.
> 
> My question is - how can I get doxygen to generate references to members of
> nested structures, like in the example below.... the
> outer.outer_member1.inner_member and outer.outer_member2.inner_member
> strings don't appear as references.
> 
> Any advice appreciated,
> CR
> 
> /// \file example.h
> /// \brief Example of references to members of nested struct.
> /// \author Chris Roelle
> ///
> /// what I want to do is see these all as references....
> /// \ref inner
> /// \ref inner.inner_member
> /// \ref outer
> /// \ref outer.outer_member1
> /// \ref outer.outer_member1.inner_member
> /// \ref outer.outer_member2
> /// \ref outer.outer_member2.inner_member
> 
> /// struct inner doc
> struct inner_tag
> {
>  /// inner_member doc
>  int inner_member;
> };
> /// typedef inner doc
> typedef struct inner_tag inner;
> 
> /// struct outer doc
> struct outer_tag
> {
>  /// outer_member1 doc
>  struct inner_tag outer_member1;
>  /// outer_member2 doc
>  inner outer_member2;
> };
> /// typedef outer doc
> typedef struct outer_tag outer;
> 
> 
> 
> --
> View this message in context: http://doxygen.10944.n7.nabble.com/references-to-nested-structure-members-tp7739.html
> Sent from the Doxygen - Users mailing list archive at Nabble.com.
> 
> ------------------------------------------------------------------------------
> The Command Line: Reinvented for Modern Developers
> Did the resurgence of CLI tooling catch you by surprise?
> Reconnect with the command line and become more productive. 
> Learn the new .NET and ASP.NET CLI. Get your free copy!
> http://sdm.link/telerik
> _______________________________________________
> Doxygen-users mailing list
> Dox...@li...
> https://lists.sourceforge.net/lists/listinfo/doxygen-users