GNOME Bugzilla – Bug 643944
ingroup'd macro duplication
Last modified: 2011-08-14 14:05:20 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.
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.
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.