kdevelop/kdk-1.2 KDE libs doc borken!!

[W. Tasin]

Serge Lussier wrote:
> 
> Hi,
> PLEASE HELP ME - DON'T IGNORE ME!
> NEED HELP FOR THREE POINTS :

Hi,

> 
> 1-
>   I just updated kdevelop 1.1 to kdevelop 1.2 -
> by compiling and installing kdk1.2,
> I LOST ALL THE KDE Library reference!
> Now I see only the QT libs doc in the DOCS tab.
> 
> Even if I went to options->documentation, then "update" / or even
> "create" from the KDE1.1.2 source pckg
> 
> The process seems to rebuild the references successfully - I see glimpse
> in work
> on the messages ouput window - terminated with success-
> And now the only way I can get into the kde docs
> is by right-clicking on a kde class/member in the editor
> and select "look-up ..."
> what happened ?
> 

The KDK uses the shared html directory of KDE.
Something like /opt/kde/share/doc/HTML/en/kdelibs or
/usr/share/doc/HTML/en/kdelibs (depending on your distribution).
If you find this directory an it contains
kab             kdeui           kfmlib          kspell
kdoc-reference  khtmlw          kdecore         kfile           kimgio

If these directories are found, so the installation worked fine.

The only problem then would be that inside
~/.kde/share/config/kdeveloprc still point to the location given before
as your worked with kdevelop-packages.
(Maybe the file permissions of this file doesn´t permit you to change
your local kdeveloprc??)

Look at Options/KDevelop Setup.../Documentation, which directories are
used by KDevelop and optional change this value if this isn´t the right
directory.
After restarting it should still point to the entered directory, if not
you haven´t the right to change your local kdeveloprc.

 
> 2-
> 
> How to setup, where to put KDOC files,
> how to make this whole kdoc feature to WORK.
> Because "generate API doc" doesn't work any more.
> I see "Creating Project API documentation" on the status bar
> but nothing seems to happen- it could stay in that state for the
> eternity...
> 
> any hints ?
> I am lost.

It works only right if your KDevelop already points to the right
kdelibdoc directory.

And kdoc 2 uses much more time to create the documentation, maybe it
seems only that it would be an eternity.

But you can check it by doing this manually from the console.
For example for your project (and assuming the kdelibs documentation is
installed in
/opt/kde/share/doc/HTML/en/kdelibs):

cd '/home/lusse/src/sourceforge/kfetchmailpop/kfetchmailpop' && kdoc -p
-d /home/lusse/src/sourceforge/kfetchmailpop/kfetchmailpop -L
/opt/kde/share/doc/HTML/en/kdelibs/kdoc-reference -lqt -lkab -lkdecore
-kdeutil -n kfetchmailpop kfetchmailpop.h .......... (here should be the
list of all header files of your project with relative path from
/home/lusse/src/sourceforge/kfetchmailpop/kfetchmailpop)

Thats what KDevelop do. With some more -l options, which takes more
time.


> 
> PLEASE HELP ME - DON'T IGNORE ME!
> 
> 3-
> 
> In Project->Make distribution
> My project is Kfetchmailpop:
> 
> It brokes the distribution. It is not compilable since there is
> no generated moc files at compile time:
> here is the ouput point of the command "make distribution
> where the error occurs
> ---
> .
> .
> .
> gmake[1]: Entering directory `/home/lusse/src/sourceforge/kfetchmailpop'
> 
> perl automoc
> error: filename kfetchmailpop-0.5/kfetchmailpop/AUTO doesn't end with
> .moc
> gmake[1]: [dist-hook] Error 1 (ignored)
> .
> .
> .
> ---
> I dunno what to do ....

Thats right, it will cause an error if you have a project which still
uses "automoc".
Now its state of the art to use "am_edit".

automoc needs as option inside Makefile.am:
kfetchmailpop_METASOURCES = USE_AUTOMOC

and am_edit:
kfetchmailpop_METASOURCES = AUTO


So your problem was created by having:
kfetchmailpop_METASOURCES = AUTO
with a "perl automoc" call.
I guess "am_edit" was also in your toplevel src directory, so this had
higher priority and you updated kfetchmailpop/kfetchmailpop/Makefile.am,
but you didn´t updated kfetchmailpop/Makefile.am to have changed "perl
automoc" to "perl am_edit".

Thats one reason, why I have implemented the "Update all Makefile.ams"
command in the RFV ;-)
 
> 
> PLEASE HELP ME - DON'T IGNORE ME!
> ... Sorry about yelling PLEASE ... -  I posted a couple  message before
> and I saw no relpy!
> 
> Regards,
> Serge Lussier

Ciao

Walter
-- 
The KDevelop project: tasin at kdevelop.de [www.kdevelop.org]
--
oohhh sveglia.... il mondo e' ammalato, ma x colpa di chi.........
(Zucchero)
:-------W. Tasin, FB
04,FHM-------------------PGP-KeyID:0x7961A645----------:
<Key-Fingerprint: 1610 835F 0080 32F4 6140  6CF7 A7D0 44CD 7961A645>