[prev in list] [next in list] [prev in thread] [next in thread] 

List:       kde-devel
Subject:    Re: 'make doc' (was:Re: Documentation standard ??)
From:       Michael Koch <m_koch () bigfoot ! de>
Date:       1999-07-07 16:27:31
[Download RAW message or body]

Am Mit, 07 Jul 1999 schrieb Leon Widdershoven:
> On Wed, 7 Jul 1999, Matthias Elter wrote:
> 
> > Have a look into current Linux distros, most if not all do not ship with KDE
> > library docu...know why? Packagers are lazy ;) they don't want to download kdoc
> > (kdesdk) and generate the docu by hand. Why not simply move kdoc into kdesupprt
> > (its just a few KB) and add a 'docu' target to kdelibs/Makefile.am
> > (Stephan?:) that automagically generates the docu?
> > 
> 
> I agree that kdoc should be in one of the packages. I think kdebase
> would be fine. Or maybe kdelibs. 
> 
> About creating the docu automatically, there is this program
> makekdedocs (or something like that) in the kdoc package.
> It needs to know where to find the qt index and where the 
> libs are, and in kdelibs/ there needs to be a file describing
> the directory structure to process (or something like that,
> the man page is very clear). So this would not even be so
> hard.

Files describing the directory structure to process is already in CVS: 

kdelibs/kdoc.rules
koffice/lib/kdoc.rules

I try to keep them usable.    ;-)


Michael Koch

KDE fan, enthusiast and developer
projects: Katabase and KImageShop
writing documentation of KOM/OP

student of computer science at
university of applied sciences
Darmstadt, Germany

koch@kde.org
m_koch@bigfoot.de
mkoch@mail.riednet.wh.tu-darmstadt.de
http://www.riednet.wh.tu-darmstadt.de/~mkoch

[prev in list] [next in list] [prev in thread] [next in thread]