[Doxygen-users] Doyxgen 1.2.7: \ingroup group1 group2 still allowed?

[Patrick O. <Pat...@pa...>]

Hi all!

According to the documentation (and implementation) of
\ingroup an entity may be put into several different
groups at once.

However, later on in groupdef.cpp:addMemberToGroups()
this is detected and triggers a warning (groupdef.cpp, line 617):

  Member ... found in multiple groups.!
  The member will be put in group ..., and not group ...

The class MemberDef also allows to set only one GroupDef: 
    setGroupDef(GroupDef *gd)        { group=gd; }

Are \ingroup and related mechanisms with more than one
group per entity deprecated? 

If you ask me, then I'd be more than happy when each
entity can only be in one group and I'd volunteer to
clean up the implementation: 

- Entry::groups doesn't have to be a list.
- An explicit \ingroup overrides an implicit @{ @}.
- A \defgroup @{ @} in one place overrides an \addtogroup @{ @}
  in another place (e.g. header files uses \defgroup, C files use
  \addtogroup) - this is currently impossible to implement, but
  something that I have been missing for quite a while.

Bye, Patrick
-- 
// pallas  GmbH  ............  Patrick Ohly  .............
   Hermuelheimer Str. 10       Software-Engineer
   D-50321 Bruehl, Germany     po...@pa...
   fax +49-(0)2232-1896-29     phone  +49-(0)2232-1896-30 
   http://www.pallas.com 
..........................................................