After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 643944 - ingroup'd macro duplication
ingroup'd macro duplication
Status: RESOLVED FIXED
Product: doxygen
Classification: Other
Component: general
1.7.3
Other Windows
: Normal normal
: ---
Assigned To: Dimitri van Heesch
Dimitri van Heesch
Depends on:
Blocks:
 
 
Reported: 2011-03-05 12:18 UTC by Anton
Modified: 2011-08-14 14:05 UTC
See Also:
GNOME target: ---
GNOME version: ---


Attachments
both samples in separate directories (4.52 KB, application/x-zip-compressed)
2011-03-05 12:18 UTC, Anton
Details

Description Anton 2011-03-05 12:18:40 UTC
Created attachment 182543 [details]
both samples in separate directories

I don't know what of the following is a bug because of there is a lot of strange behaviour so I prefer describe it step-by-step.

PREAMBLE.
Situation in brief. I have a group containing set of structures. Each structure has set of functions and function-like macroses.

And I want to display both functions and function-like macroses both upon group and structure page.


OBSERVATION-1.
So I add \relates <struct> and \ingroup <group> in documentation block. Such way formatted block produces the proper result (for me) while documenting function but not the macro (tss_del_base vs tss_del_base_back in sample1). This seems to be a bug.


OBSERVATION-2.
If I remove @relates (leaving @ingroup) then then macro naturally disappears from structure documentation page but on group page it is displayed almost as wanted(i.e. the only item). See behaviour of tss_del_bof_back_norel in sample1. So this looks like absolutely normal behaviour.
If I remove @ingroup (leaving @relates) then macro is displayed both on group and structure documentation pages BUT it is doubled on group documentation page. See behaviour of tss_del_bof_back_nogrp in sample1. BUT if delete tss_del_bof with its documentation then duplication becomes automatically removed (this is illustrated by sample2). So this seems to be definitely a bug.

OBSERVATION-3
To avoid such strange behavious I've even tried to document macro as function (see documentation for tss_del_bif_copy) and this produces almost ideal result, but there is a little drawbacks:
 1. doxygen generates 2 warnings in my case:
1/sample.h:109: warning: argument 'id___' of command @param is not found in the argument list of tssBifFile::tss_del_bif_copy(rtsp_uint64 id___)
1/sample.h:109: warning: The following parameters of tssBifFile::tss_del_bif_copy(rtsp_uint64 id___) are not documented:
  parameter 'rtsp_uint64'
 2. In documentation block for such function argument type is merged with argument name.
Comment 1 Dimitri van Heesch 2011-04-22 14:37:08 UTC
There was a problem where a #define that was marked with \relates ended up twice in the file/group documentation. Should be fixed in the next subversion update.
Comment 2 Dimitri van Heesch 2011-08-14 14:05:20 UTC
This bug was previously marked ASSIGNED, which means it should be fixed in
doxygen version 1.7.5. Please verify if this is indeed the case. Reopen the
bug if you think it is not fixed and please include any additional information
that you think can be relevant.