Bugzilla Bug 120830

khelpcenter isn't only a kde manual, should be a frontend for man,
but htdig is required to rebuild index.....
This ebuild adds index_man flag with this dependancy on, or it will
be much less useful.

Created an attachment (id=78445) [details]
khelpcenter-3.5.0 ebuild with index_man flag

In addition, it should also compile kdebase-kioslaves otherwise khelpcenter
cannot parse man:/ or info:/ filetypes. I recommend making this a dependency as
well.

Created an attachment (id=79140) [details]
khelpcenter-3.5.1 ebuild with index_man flag

Updated for 3.5.1 and added kde-base/kdebase-kioslaves dependancy fo index_man
flag as well.  For who's swearing why this is so nice.... with khelpcenter
I can use ctrl+F on man pages and can select (for copy with control+C) more
than one man page at once...

I had been getting errors when creating search indexes for Application Manuals:

> INDEXDIR: /home/peter/.kde3.5/share/apps/khelpcenter/index/
> FINDCMD: find /usr/kde/3.5/share/doc/HTML/en/ -name index.docbook
> Creating index for 'kde_application_manuals'
> Warning: unknown locale!
>
> New server: home, 80
> Unknown host: home
> 0:0:0:file://home/peter/.kde3.5/share/apps/khelpcenter/index/kde_application_manuals.tmp/index.html:
------------------------------------------------------------------------------------------
size = 9403
> htdig: Run complete
> htdig: 1 server seen:
> htdig:     home:80 1 document
> htmerge: Document database has no URLs. Check your config file and try
running htdig again.
>
> htmerge failed

Matteo did some research and uncovered a bug report which did not seem related:
http://sourceforge.net/mailarchive/forum.php?forum_id=2691&style=flat&viewday=3&viewmonth=200204

However, on upgrading to htdig 3.2.0_beta-6, kdehelpcenter was able to
correctly compute and build indexes.

I might suggest adding >=www-misc/htdig-3.2.0 as a Depend (even though it's
marked testing right now) since indexes can't be built with htdig-3.1.6. But,
then again, kde 3.5.x is still marked testing.

Thanks Matteo for the excellent find.

Created an attachment (id=79285) [details]
better dependancy for index_man

Thank you but the merit is of google. However, the hard part would be that
kde goes stable faster tham htdig. This however should not be an issue since
htdig dependancy would be only for index_man flag. Updated ebuild dependancy.

There is another issue with htdig as detailed in #28049. A few hardcoded paths
in /usr/kde/3.5/bin/khc*.pl need to be changed:

- khc_htsearch.pl: my $htsearchpath="/usr/bin/htsearch";

- khc_htdig.pl and khc_docbookdig.pl: my $htdigdata = "/var/lib/htdig/db"; my
$htdigbin = "/usr/bin";

Also note that khelpcenter should depend on >=www-misc/htdig-3.2.0_beta6-r1

Created an attachment (id=85971) [details]
khelpcenter-htdig.diff

Patch for the purposed changes. Should be applied at kde-base as well (when 
releasing another patch set....). 
Apply just after cd ${S} (inside kdebase-3.5.2 directory).

Created an attachment (id=85972) [details]
khelpcenter-3.5.2-r1.ebuild

new ebuild with both index_man flag and the patch (the patch will be applied
even if the flag is unset, as it doesn't seems to touch anything else than
htdig
functions....)

P.S.: I got this error :
"htdig: Errors to take note of:
Unknown host or unable to contact server: help://kregexpeditor/index.docbook
Ref:
file:///home/matte/.kde3.5/share/apps/khelpcenter/index/kde_application_manuals.tmp/index.html"

The file /usr/kde/3.5/share/doc/HTML/en/KRegExpEditor/index.docbook seems to be 
there, the issue might be the Capital letter of KRegExpEditor (instead of 
kregexpeditor)?

Doing a "mv KRegExpEditor kregexpeditor" inside
"/usr/kde/3.5/share/doc/HTML/en" worked. 
However it seems to have added just kde apps manuals and just "en language"
(my system has both en and it).....

*** Bug 147788 has been marked as a duplicate of this bug. ***

well, couldnt you make htdig a USEflag for kdebase? that would give as the
choice of either emerging this or not.

thx!

Fixed in 3.5.7.

(In reply to comment #13)
> well, couldnt you make htdig a USEflag for kdebase? that would give as the
> choice of either emerging this or not.

No; working KDE help is not really optional, sorry.