[Kst] Manpage generation

[Philip Rodrigues]

Hi,
I've played around a little bit with generating manpages from the DocBook 
source. It turned out to be easier than I expected. I've attached the manpage 
I generated from the 'Command Line' section - to take a look, drop it 
in /some/path/man1 and then "man -M /some/path kst"

Now for the boring technical details:
I grabbed the full DocBook XSL stylesheets, which have a stylesheet for the 
generation of manpages. With a little twiddling of the DocBook markup, I got 
the attached manpage as output.

Now, the issue is this: ideally, the manpage would be generated at compile 
time, in the same way that the HTML is currently generated. The problem is 
that the HTML-generating bit of the stylesheets is distributed with KDE, but 
the manpage part isn't. I'll take a look at whether it's feasible to include 
the manpage stylesheets with KDE, but for now, I'd suggest we just regenerate 
the manpage manually before each release.

Thoughts, comments, questions?

Cheers,
Phil
-- 
KDE Documentation Team: http://i18n.kde.org/doc
KDE Documentation Online: http://docs.kde.org
-------------- next part --------------
A non-text attachment was scrubbed...
Name: kst.1
Type: application/x-troff
Size: 4659 bytes
Desc: not available
Url : http://mail.kde.org/pipermail/kst/attachments/20041227/a527825c/kst.t
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: not available
Url : http://mail.kde.org/pipermail/kst/attachments/20041227/a527825c/attachment.pgp