Support for multi-library modules: which API in which library,, link instructions per library
Currently kapidox for a module with multiple libraries blends all API into one big set. In the generated docs it cannot be seen in which library e.g. a class actually exist.
Example:
For the KIO module there are 3 (non-deprecated) libraries. When looking at a class like KIO::PreviewJob
the information on the right bar only tells:
Use with CMake:
find_package(KF5KIO)
target_link_libraries(yourapp KF5::KIOCore KF5::KIOFileWidgets KF5::KIOWidgets KF5::KIONTLM)
Use with QMake
QT += KIOCore KIOFileWidgets KIOWidgets KNTLM
It could be found that quite some developers then simply copied the whole line into their CMakeLists, linking and creating dependencies on all the libraries, while actually they would just use/need one or two.
Wanted:
kapidox should have better support for the concept of multiple libraries per module:
- for each API tell in which exact library it is and what to do to link only that
- allow to explore API per library, not just per module