[CMake] [PATCH] add docbook support for cmake documentation

[Alexander Neundorf]

Hi,

attached you can find a patch against current cmake cvs which adds support for 
generating the documentation as docbook file.
(the patch is not yet ready to apply, it must still be cleaned up and 
documentation for that feature has to be added).

docook is useful as a bse format to convert the documentation to whatever 
format you like: html, pdf, ... (AFAIK).
Can this e.g. in some way be used with Qt assistant ?
For techbase.kde.org ?

CMake generates docbook if the given filename ends with ".docbook":

cmake --help-commands commands.docbook
or
cmake -DCMAKE_MODULE_PATH=/opt/kde4/share/apps/cmake/modules/ --help-custom-modules  
kdemods.cmake

Please have a look and test, please also have a look at the generated docbook, 
I'm no specialist in this.

Alex

P.S. Allen: there is currently an issue with building KDE with cmake cvs (fix 
coming soon), so please use this only for testing the documentation
-------------- next part --------------
A non-text attachment was scrubbed...
Name: docbook.patch
Type: text/x-diff
Size: 14135 bytes
Desc: not available
Url : http://public.kitware.com/pipermail/cmake/attachments/20080217/585c122d/docbook.bin