Re: Man pages (kdesdk, koffice)
On Friday 04 May 2001 10:27, Ben Burton wrote:
> I have a set of man pages written for all the apps in kdesdk and koffice.
> In particular this includes every command-line utility in kdesdk (of which
> there are many). You can find them all in the CVS under kdesdk/debian/*.1
> (and koffice/debian/*.1).
I had only checked the major KDE modules, didn't think to look in kdesdk or
koffice. Thanks for the pointers, that gives us a place to start.
> Aspects of the man pages that are debian-specific: Some of them refer the
> reader to author's notes, html docs and the like in debian-specific paths
> (eg. /usr/share/doc/kword/html). The man pages for qtdoc and kdedoc (from
> kdesdk) are very debian-specific since I patched the scripts to look for
> the corresponding Qt/KDE docs in the debian-installed locations; both of
> these man pages also have a DEBIAN USERS section detailing how to get the
> Qt/KDE docs.
I don't know how the Debian system works. Is it possible to create a patch
that can be applied to the original man pages when the Debian packages are
created?
> I can't speak for anyone else's man pages, but feel free to take all of
> those from kdesdk and koffice and put them in <module>/doc in whatever
> format you like. My only desire is that they can be converted back into
> *roff format since Debian requires a man page for executable.
Oh for sure.. man index.docbook doesn't work so well! This is the mechanism
we're figuring out now, but it's a given that docbook is a source format, not
an end result.
> Btw, I'm also happy to keep maintaining the English versions of these docs
> if people would like it (and I'm happy not to if people would prefer that
> also
I would be extremely happy for you to continue maintaining these, and as soon
as they're converted and in place, I'll let you know. That could take a
little while, so don't hold your breath just now.
Thanks for the information,
Regards,
--
Lauri Watts
KDE Documentation Team
Reply to: