On Tuesday 27 January 2004 23:03, Dominique Devriese wrote:
> Achim Bohnet writes:
>
> > My idea now was now to create a kde-options(?) manpage^Wsgml that
> > describes the generic kde and qt options (later maybe in more
> > detail). From all other manpages just use a reference to this
> > manpage. If possible one could even create templates in kdelibs-dev
> > that are included and allow to change these generic parts of each
> > kde manpage at a central place.
>
> > Does this sound reasonable?
>
> It does to me. It's great that you are going to work on the KDE
> program manpages. Especially for command line utilities like dcop*,
> this would be really useful.
Thx, Ben, Chris, Dominique for the encouraging answers.
I've started last night and created kde-options from kde-config,
augmenting (well cut and paste) it with descriptions from the qt
and kdelibs docs. Then realized, that kdelibs
is LGPL and and I'm not sure if QT GPL is compatible with the
'...with no Invariant Sections, no Front-Cover Texts and no Back-Cover Texts.'
addition Chris used in his manpages.
So it looks like I have to wait a bit and use my own words. Maybe
I also ask some KDE developers for an okay to an LGPL -> GPL
transition when I find much useful material in the kdelibs docs.
Or Chris, in this case would you give your okay to put kde-config
under the LGPL?
I'm definitly not an good english writer and modifying c&p gives
certainly a better result that me formulating the text.
>
> > Btw. is there a script that generates from a --help ouput an sgml
> > manpage skeleton?
>
> I wrote a script that generates nroff manpage code directly once.
> It's currently in kdesdk/scripts/kdemangen.pl.
Ah, thx for the info. I'll look into it, if it's easy to change to create
sgml, when I'll add manpages to kdebluetooth pkg (currently fighting
with --enable-final ;).
Achim
>
> cheers
> domi
--
To me vi is Zen. To use vi is to practice zen. Every command is
a koan. Profound to the user, unintelligible to the uninitiated.
You discover truth everytime you use it.
-- [EMAIL PROTECTED]
