need help with docbook

Diego Iastrubni elcuco at kde.org
Sat Feb 16 20:03:29 GMT 2008


Qt4.4 should have a new help system. Is there any plan to abuse it? This way 
we should be able to integrate assitant and KHelpCenter? How about helping 
KHelpCenter to view the new documentation format of Qt4.4...?


On Saturday 16 February 2008 21:38:06 Alexander Neundorf wrote:
> 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






More information about the kde-core-devel mailing list