[Doxygen-users] Documenting a Python module that's split into multiple files

[Peter E. <pea...@st...>]

Hi,

I posted this question on StackOverflow, but I haven't gotten any answer there, so I'm trying here in the hope that someone can help me.
I'm using Doxygen to document some Python code. It includes a module that is split into multiple files. I needed to do that for maintainability. Some of the classes in the module are very large with complex implementations. If I had to combine them all into one file, that file would become unmanageably large, well over 10,000 lines. So I split them into many files, then have __init__.py import all the files into the parent module. This works nicely: the code is maintainable, and users can import everything with a single import statement.

But Doxygen doesn't know about this. It shows the classes as being split into many modules. Users shouldn't need to even know all those modules exist. They're just an implementation detail to keep the code simpler. How can I make it produce documentation that matches the intended API, with all the classes shown as being in a single module?

Thanks!

Peter