Hi Juan,

thanks for your answer.

In the meantime I could figure out that the enabled subgrouping causes
this problem if all group members are of the same type.

I have opened issue #9849 which describes the problem in detail and how
it could be solved. It's just a suggestion for better output quality.
Let's see what RIOT's maintainers think about it.

Regards
Gunar

On 28.08.2018 10:45, Juan Ignacio Carrano wrote:
> Hi Gunar,
> 
> On 8/27/18 7:05 PM, Gunar Schorcht wrote:
>> Hi,
>>
>> it seems that the style of the output changes either if a variable or
>> function declaration is part of such group.
>>
>> But this is not always the case. For example, even though there are such
>> declarations in
>>
>> http://riot-os.org/api/boards_2native_2include_2board_8h.html
> 
> I find it useful to enable XML output in Doxygen and inspect the 
> resulting XML. This will indicate if its a structure problem (meaning 
> you messed up) or a rendering problem (meaning Doxygen messed up).
> 
> In this case you are right, and the XML shows "LED Handlers" and "MTD 
> emulation configuration" both correspond to `<sectiondef 
> kind="user-defined">` elements, with no difference other than their 
> contents.
> 
> I think that what happens is that Doxygen presentation logic 
> automatically detects groups with preprocessor definitions only and 
> nests them under a "Macros" section. Unfortunately, there's not much 
> that can be done to customize this behavior (see 
> https://www.stack.nl/~dimitri/doxygen/manual/customize.html)
> 
> Regards,
> 
> Juan.
> _______________________________________________
> devel mailing list
> [email protected]
> https://lists.riot-os.org/mailman/listinfo/devel
> 


-- 
Wenn du laufen willst, lauf eine Meile. Wenn du ein neues Leben
kennenlernen willst, dann lauf Marathon. (Emil Zatopek)

Attachment: signature.asc
Description: OpenPGP digital signature

_______________________________________________
devel mailing list
[email protected]
https://lists.riot-os.org/mailman/listinfo/devel

Reply via email to