[Doxygen-users] Multiple files with identically named functions

[Justin D. <jr...@jr...>]

Hello,

I have a project with two main modules: file_a.c and file_b.c. Both files contain a function called baz(). file_a is for one platform, and file_b is for a completely different platform.

They share a header file called file.h, which contains a protototype for baz(). The documentation for baz() in file.h covers just the interface, whereas the documentation for baz() in each C file deals with the implementation for each platform.

When my project is compiled, it uses either file_a.c or file_b.c, but never both.

With Doxygen, file_a gets documented correctly. But when file_b comes around, the documentation for baz() ends up including file_a and file_b's documentation mixed together.

This is definitely not what I want. I've noticed a recent post (a few days ago) on this list pointing to a similar issue, but it does not appear to have been discussed yet.

Is there a way to tell Doxygen to keep function documentation local to the module where the definition is, and not combine it with documentation from other C files when it encounters functions with the same name?

Thank you!

Justin Dobbs