need help with docbook

Alexander Neundorf neundorf at kde.org
Sat Feb 16 19:38:06 GMT 2008


Hi,

we have quite a few cmake modules in KDE, all/most of them are documented at 
the top of the file. 
cmake cvs can generate documentation also for custom modules, if they are in 
CMAKE_MODULE_PATH, as text, html file and man page.
All this doesn't help a lot if we want to put these docs on some webpage like 
techbase.
Would docbook be an appropriate output format ?
If so, are there different types of docbook, i.e. would we need some 
KDE-specific version ?
If not, I'd like to add support for creating the documentation as docbook to 
cmake, so we can easily get the docs and convert them to a format we like.

But since I know almost nothing about docbook, I need help with this.
Attached you can find a shortened version of cmake documentation in html 
format.
It would be nice if somebody could "translate" that file to docbook and send 
it to me. I guess that would be enough so I could add docbook support to 
cmake.
(the 3 item list at the top is something like a TOC)

Thanks
Alex
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.kde.org/pipermail/kde-core-devel/attachments/20080216/7589ddf1/attachment.html>


More information about the kde-core-devel mailing list