If we use the kdoctools_install macro (defined in kdoctools/KF5DocToolsMacros.cmake), we can avoid to create all those CMakeLists.txt files in the doc subfolders. This would also be consistent with the ki18n_install macro usage.
Description
Details
- Differential Revisions
- D1574: Use kdoctools_install macro in create_tarball_kf5
This should go into a (non-yet existing) "kdesdk" or "kde-sdk-script" project, but we can handle it for now (minus pushing changes I guess, if the repository is not registered?).
Update: I changed the script so that now all *.docbook files go in po/<lang>/docs.
However, when I call kdoctools_install(po) from the root CMakeLists.txt, cmake fails with this error:
CMake Error at /usr/lib64/cmake/KF5DocTools/KF5DocToolsMacros.cmake:106 (message): SUBDIR needs to be defined when calling kdoctools_create_handbook
This happens with kdoctools 5.21. What's wrong?
For handbooks, po/<lang>/docs/<name>/file.docbook
If you see, some repositories have more directories under doc already, see kleopatra; others have only one document and no subdirectories, but they need to be "normalized" as well.
Exception: man-*.docbook can go directly under po/<lang>/docs/
Oh I see. I guess then that the macro documentation in KF5DocToolsMacros.cmake should be updated to mention this?