Version: (using Devel) Installed from: Compiled sources Since Bug 175581 is solved, there is documentation for kdeversion.h.cmake avaible in the KDE api documentation. However, this documentation has 2 weakness: 1.) It is hard to find in the documentation for the macros of this file. It would be nice to have the macros in the module "KDE macros" (http://api.kde.org/4.x-api/kdelibs-apidocs/kdecore/html/group__KDEMacros.html). I asume this can be done adding " * @ingroup KDEMacros" in the respective parts of kdeversion.h.cmake? 2.) There is no documentation available for the macros who are defined with #cmakedefine instead of #define. Is it possible to simple add something like " * @def KDE_VERSION_MAJOR", so that doxygen creates the respective documentation? Or will doxygen ignore this documentation when it doesn't find the respective macro? You see, I'm not an expert in doxygen. However I've created 2 patches to propose them here for review: add-ingroup.diff solves issue 1. add-ingroup-and-cmakedef-doc.diff tries to solve issue 1 and 2. Maybe they help...
Created attachment 28914 [details] add-ingroup.diff
Created attachment 28915 [details] add-ingroup-and-cmakedef-doc.diff
SVN commit 890720 by winterz: Better doxygen for making the doc for these macros easier to find in the output. Patch from Tim Fechtner. BUG: 176416 MM +154 -137 kdeversion.h.cmake WebSVN link: http://websvn.kde.org/?view=rev&revision=890720
Thanks.