How to document the functionality in C++20 modules?

Question

When providing a library to others, documentation of eg class member functions can be included in the header files which contain the declarations. If properly formatted, this documentation can also be interpreted and displayed by IDEs. Using C++ modules, how can I pass on information about the functionality in the module without falling back to external documentation, eg Doxygen? I assume comments do not make it as such into the compiled interface file?

Answer 1

You are right, this question is actually pointless. I thought that - unless provided with the complete source code - libraries would be provided completely in binary format when using modules. Although the idea of deploying just one library file without additional files has its charme.