kdelibs CMake module docs (Was: Re: kdedoxygen.sh (Was: API dox))

[Alexander Neundorf]

On Saturday 14 June 2008, Allen Winter wrote:
> Howdy,
>
> I just put a new tool called kdedoxygen.sh into kdesdk/scripts.
> Let me know if it helps. I'll update TechBase about this.
>
> % kdedoxygen.sh -h
> kdedoxygen.sh - generates API html pages for KDE modules using doxygen
>
> Simply chdir to the directory containing your code and run this program.
> The output html can be found in apidocs/html, and the processing log is in
> doxygen.log

Somewhat related:
it would be nice if we would have documentation for the cmake modules coming 
with kdelibs/cmake/modules/ on techbase.
I think we have everything to do this. 
-cmake 2.6 supports creating documentation in docbook format. This should be 
good as something which can be converted into content for techbase ?
-cmake 2.6 supports creating documentation for custom cmake modules (i.e. not 
only the ones which come with cmake): 
$ cmake -DCMAKE_MODULE_PATH=<path_to_custom_modules> --help-custom-modules 
<filename.docbook>

So let's say you have kdelibs installed to /opt/kde4, the following will 
generate a docbook file for all cmake modules from kdelibs:

$ cmake -DCMAKE_MODULE_PATH=/opt/kde4/share/apps/cmake/modules \
         --help-custom-modules kdelibs-cmake-modules.docbook

Then this docbook file has to be converted to something appropriate for 
techbase and put online.

Volunteers ?

Alex